cosmos/bank/v1beta1/balances/{address}

Parameters

Object NameRequiredTypeDetail
address✅StringAddress to query balances for.
pagination.key❌StringThe value returned in PageResponse.next_key to begin querying the next page most efficiently. If provided, then pagination.offset is not allowed.
pagination.offset❌IntegerA numeric offset that can be used when pagination.key is unavailable. It is less efficient than pagination.key. If provided, then pagination.key is not allowed.
pagination.limit❌IntegerThe total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.
pagination.count_total❌BooleanIf set to true, the result will include a count of the total number of items available for pagination. count_total is only respected when offset is used. It is ignored when key is set.
pagination.reverse❌BooleanSet to true if results are to be returned in the descending order.
cosmos/bank/v1beta1/balances/cosmos1sd4tl9aljmmezzudugs7zlaya7pg2895tyn79r

Result

Example

Request

curl <your-rest-endpoint>/cosmos/bank/v1beta1/balances/cosmos1sd4tl9aljmmezzudugs7zlaya7pg2895tyn79r \
  -X GET \
  -H "accept: application/json"

Return

{
    "balances": [
        {
            "denom": "ibc/E7D5E9D0E9BF8B7354929A817DD28D4D017E745F638954764AA88522A7A409EC",
            "amount": "17624439"
        },
        {
            "denom": "uatom",
            "amount": "94000"
        }
    ],
    "pagination": {
        "next_key": null,
        "total": "2"
    }
}