Spendable balances

SpendableBalances queries the spenable balance of all coins for a single account.

get

/cosmos/bank/v1beta1/spendable_balances/{address}

Path parameters

addressstringrequired

address is the address to query spendable balances for.

Query parameters

pagination.keystring · byte

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring · uint64

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitstring · uint64

limit is the 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_totalboolean

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverseboolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/cosmos/bank/v1beta1/spendable_balances/{address}'

200

default

200

{
  "pagination": {
    "next_key": "text",
    "total": "text"
  },
  "balances": [
    {
      "denom": "text",
      "amount": "text"
    }
  ]
}

A successful response.