Balance info

Get balance information for an account.

Returns information about an account's balance. Replaces /balance/{address} from versions < v1.0.0.

GEThttps://dot-playbook.nownodes.io/accounts/{accountId}/balance-info

Path parameters

accountId*string (SS58)

SS58 address of the account.

Query parameters

Response

200400404

successful operation

Body

application/json

atBlockIdentifiers (object)

Block number and hash at which the call was made.

noncestring (unsignedInteger)

Account nonce.

tokenSymbolstring (unsignedInteger)

Token symbol of the balances displayed in this response.

freestring (unsignedInteger)

Free balance of the account. Not equivalent to spendable balance. This is the only balance that matters in terms of most operations on tokens.

reservedstring (unsignedInteger)

Reserved balance of the account.

miscFrozenstring (unsignedInteger)

The amount that free may not drop below when withdrawing for anything except transaction fee payment. Note, that some runtimes may not have support for miscFrozen and if so the following will be returned miscFrozen does not exist for this runtime

feeFrozenstring (unsignedInteger)

The amount that free may not drop below when withdrawing specifically for transaction fee payment. Note, that some runtimes may not have support for feeFrozen and if so the following will be returned feeFrozen does not exist for this runtime

frozenstring (unsignedInteger)

The amount that free may not drop below when reducing the balance, except for actions where the account owner cannot reasonably benefit from the balance reduction, such as slashing. Note, that some runtimes may not have support for frozen and if so the following will be returned frozen does not exist for this runtime

locksarray of BalanceLock (object)

Array of locks on a balance. There can be many of these on an account and they "overlap", so the same balance is frozen by multiple locks

Request

JavaScriptCurlPython

const response = await fetch('https://dot-playbook.nownodes.io/accounts/{accountId}/balance-info', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400404

{
  "at": {
    "hash": "text",
    "height": "text"
  },
  "nonce": "text",
  "tokenSymbol": "text",
  "free": "text",
  "reserved": "text",
  "miscFrozen": "text",
  "feeFrozen": "text",
  "frozen": "text",
  "locks": [
    {
      "id": "text",
      "amount": "text",
      "reasons": "Fee = 0"
    }
  ]
}