cosmos/bank/v1beta1/balances/{address}

AllBalances queries the balance of all coins for a single account.

Parameters

Object NameRequiredTypeDetail
addressStringAddress to query balances for.
pagination.keyStringThe value returned in PageResponse.next_key to begin querying the next page most efficiently. If provided, then pagination.offset is not allowed.
pagination.offsetIntegerA 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.limitIntegerThe 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_totalBooleanIf 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.reverseBooleanSet 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"
    }
}