Account balance info

GET

https://ksmassethub-playbook.nownodes.io/v1/accounts/{accountId}/balance-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed. If reading the account balance or locks from the node fails, the endpoint now returns 503 Service temporarily unavailable (safe to retry) instead of 200 with free: 0 and empty locks. An unrecognised storage layout returns 500. A 200 response is unchanged and now always reflects real on-chain data. Addresses encoded with any SS58 prefix are now accepted; before, an address from another network was rejected with 400.

Returns balance information for a given account including free, reserved, and locked balances.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

tokenstringquery

Token symbol for chains with multiple tokens

denominatedbooleanquery

When true, denominate balances using chain decimals

Response

200OK

Account balance information

400Bad Request

Invalid account or block parameter

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Account balance info

curl -X GET 'https://ksmassethub-playbook.nownodes.io/v1/accounts/{accountId}/balance-info'

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

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ksmassethub-playbook.nownodes.io/v1/accounts/{accountId}/balance-info')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://ksmassethub-playbook.nownodes.io/v1/accounts/{accountId}/balance-info')
data = response.json()

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

const data = await response.json();

const endpoint = "https://ksmassethub-playbook.nownodes.io/v1/accounts/{accountId}/balance-info";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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

const data = await response.json();

import requests

response = requests.get('https://ksmassethub-playbook.nownodes.io/v1/accounts/{accountId}/balance-info')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ksmassethub-playbook.nownodes.io/v1/accounts/{accountId}/balance-info')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "feeFrozen": "string",
  "free": "string",
  "frozen": "string",
  "locks": [
    {
      "amount": "string",
      "id": "string",
      "reasons": "string"
    }
  ],
  "miscFrozen": "string",
  "nonce": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string",
  "reserved": "string",
  "tokenSymbol": "string",
  "transferable": "string"
}