Account asset balances

GET

https://ksm-playbook.nownodes.io/v1/accounts/{accountId}/asset-balances

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed. If the query for some asset fails, the asset is no longer silently dropped: the response carries partial: true and the failed assets are listed in the new errors array (assetId, reason). When partial is true, a missing asset must not be treated as a zero balance. New query parameter strict: when true, the endpoint returns 503 instead of a partial 200. Addresses encoded with any SS58 prefix are now accepted; before, an address from another network was rejected with 400.

Returns asset balances for a given account on Asset Hub chains. A missing assetId means the account holds none of that asset; when partial is true the asset list is incomplete (some per-asset queries failed, see errors) and a missing assetId must NOT be treated as a zero balance.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

assetsstringquery

Comma-separated list of asset IDs to query

showEmptybooleanquery

When true, include assets with zero balance (default: false). Even with showEmpty, an asset whose query failed is omitted and listed in errors (not returned as zero), so this does not guarantee one entry per requested asset under partial failure.

strictbooleanquery

When true, return 503 if any per-asset query fails instead of a partial 200 (default: false)

Response

200OK

Account asset balances (may be partial; check the partial flag)

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable, or strict=true and a per-asset query failed

Account asset balances

curl -X GET 'https://ksm-playbook.nownodes.io/v1/accounts/{accountId}/asset-balances'

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

response = requests.get('https://ksm-playbook.nownodes.io/v1/accounts/{accountId}/asset-balances')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ksm-playbook.nownodes.io/v1/accounts/{accountId}/asset-balances')
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",
  "assets": [
    {
      "assetId": "string",
      "balance": "string",
      "isFrozen": true,
      "isSufficient": true
    }
  ],
  "at": {
    "hash": "string",
    "height": "string"
  },
  "errors": [
    {
      "assetId": "string",
      "reason": "string"
    }
  ],
  "partial": true,
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}