Get token balances

GET

https://xtz-index.nownodes.io/v1/tokens/balances

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns a list of token balances.

Parameters

idobject | nullquery

Filter by internal TzKT id. Click on the parameter to expand more details.

accountobject | nullquery

Filter by account address. Click on the parameter to expand more details.

entrypointobject | nullquery

Filter by account address entrypoint. Click on the parameter to expand more details.

token.idobject | nullquery

Filter by internal TzKT id. Note, this is not the same as tokenId. Click on the parameter to expand more details.

token.contractobject | nullquery

Filter by contract address. Click on the parameter to expand more details.

token.tokenIdobject | nullquery

Filter by tokenId (for FA1.2 tokens tokenId is always "0"). Click on the parameter to expand more details.

token.standardobject | nullquery

Filter by token standard (fa1.2 or fa2). Click on the parameter to expand more details.

token.metadataobject | nullquery

Filter by metadata. Note, this parameter supports the following format: token.metadata{.path?}{.mode?}=..., so you can specify a path to a particular field to filter by, for example:.

balanceobject | nullquery

Filter by balance. Click on the parameter to expand more details.

firstLevelobject | nullquery

Filter by level of the block where the balance was first changed. Click on the parameter to expand more details.

firstTimeobject | nullquery

Filter by timestamp (ISO 8601) of the block where the balance was first changed. Click on the parameter to expand more details.

lastLevelobject | nullquery

Filter by level of the block where the balance was last seen. Click on the parameter to expand more details.

lastTimeobject | nullquery

Filter by timestamp (ISO 8601) of the block where the balance was last changed. Click on the parameter to expand more details.

sortobject | nullquery

Sorts items (asc or desc) by the specified field. You can see what fields can be used for sorting in the response description, below. Click on the parameter to expand more details.

offsetobject | nullquery

Specifies which or how many items should be skipped. Click on the parameter to expand more details.

limitinteger<int32>[0, 10000]query

Maximum number of items to return.

selectobject | nullquery

Specify a comma-separated list of fields to include into response or leave it undefined to get default set of fields. This parameter accepts values of the following format: {field}{path?}{as alias?}, so you can do.

Response

200OK

Successful response.

400Bad Request

Invalid request.

Get token balances

curl -X GET 'https://xtz-index.nownodes.io/v1/tokens/balances'

const response = await fetch('https://xtz-index.nownodes.io/v1/tokens/balances', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://xtz-index.nownodes.io/v1/tokens/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://xtz-index.nownodes.io/v1/tokens/balances')
data = response.json()

const response = await fetch('https://xtz-index.nownodes.io/v1/tokens/balances', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://xtz-index.nownodes.io/v1/tokens/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://xtz-index.nownodes.io/v1/tokens/balances', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://xtz-index.nownodes.io/v1/tokens/balances')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://xtz-index.nownodes.io/v1/tokens/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)

[
  {
    "account": {
      "address": "tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU"
    },
    "token": {
      "contract": {
        "address": "tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU"
      },
      "standard": "string"
    }
  }
]

{
  "error": "Invalid request parameters."
}