Get token balance history for an account

GET

https://egld-api.nownodes.io/accounts/{address}/history/{tokenIdentifier}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves a list of historical balance snapshots for a specific ESDT token held by the given account, including the address, token balance in atomic units, timestamp, and an optional flag indicating whether the account was the sender in the transaction that caused the balance change.

Parameters

addressstringrequiredpath

Account address in bech32 format

tokenIdentifierstringrequiredpath

Token identifier (ticker + random suffix)

Response

200OK

Successful response

Get token balance history for an account

curl -X GET 'https://egld-api.nownodes.io/accounts/{address}/history/{tokenIdentifier}'

const response = await fetch('https://egld-api.nownodes.io/accounts/{address}/history/{tokenIdentifier}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://egld-api.nownodes.io/accounts/{address}/history/{tokenIdentifier}')
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://egld-api.nownodes.io/accounts/{address}/history/{tokenIdentifier}')
data = response.json()

const response = await fetch('https://egld-api.nownodes.io/accounts/{address}/history/{tokenIdentifier}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://egld-api.nownodes.io/accounts/{address}/history/{tokenIdentifier}";
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://egld-api.nownodes.io/accounts/{address}/history/{tokenIdentifier}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://egld-api.nownodes.io/accounts/{address}/history/{tokenIdentifier}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://egld-api.nownodes.io/accounts/{address}/history/{tokenIdentifier}')
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

[
  {
    "address": "erd1vj3efd5czwearu0gr3vjct8ef53lvtl7vs42vts2kh2qn3cucrnsj7ymqx",
    "balance": "14232223390000000000000000000",
    "timestamp": 1716500136,
    "isSender": true,
    "token": "BOB-5fc887"
  }
]