Account foreign asset balances

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed. The foreignAssets filter now accepts locations in the same form the API returns them: grouped numbers ("1,000"), 0x-prefixed byte arrays and camelCase keys (chainId, blockNumber, blockHash). Snake case keys and plain numbers still work. Addresses encoded with any SS58 prefix are now accepted; before, an address from another network was rejected with 400.

Returns foreign asset balances for a given account on Asset Hub chains. Foreign assets use XCM MultiLocation as their identifier.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

foreignAssetsArray<string>query

List of multilocation JSON strings to filter by

showEmptybooleanquery

When true, include assets with zero balance (default: false)

Response

200OK

Foreign asset balances

400Bad Request

Invalid account or parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Account foreign asset balances

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

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/foreign-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

{}