RC get balance info

GET

https://dotassethub-playbook.nownodes.io/v1/rc/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 on the relay chain.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block identifier (number or hash)

tokenstringquery

Token symbol (defaults to native token)

denominatedbooleanquery

Denominate balances using chain decimals

Response

200OK

Balance information

400Bad Request

Invalid account address

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get balance info

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

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

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://dotassethub-playbook.nownodes.io/v1/rc/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://dotassethub-playbook.nownodes.io/v1/rc/accounts/{accountId}/balance-info')
data = response.json()

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

const data = await response.json();

const endpoint = "https://dotassethub-playbook.nownodes.io/v1/rc/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://dotassethub-playbook.nownodes.io/v1/rc/accounts/{accountId}/balance-info', {
  method: 'GET',
});

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://dotassethub-playbook.nownodes.io/v1/rc/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

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