Get account roles for a specific token

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves full token metadata and the role assignment (local mint, local burn, create, burn, add quantity, update attributes, add URI, transfer) that the specified account possesses on that exact token identifier.

Parameters

addressstringrequiredpath

Account address in bech32 format

tokenIdentifierstringrequiredpath

Token identifier (ticker + random suffix)

Response

200OK

Successful response

Get account roles for a specific token

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

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

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

{
  "type": "FungibleESDT",
  "subType": "FungibleESDT",
  "identifier": "BOB-5fc887",
  "collection": "BOB-5fc887",
  "nonce": 0,
  "name": "BOB",
  "ticker": "BOB-5fc887",
  "owner": "erd19yqnrgu0mlwt30kgf2f26h4x72s44nskj2zfw3nh6q5avwzycmjsywg8uj",
  "minted": "0",
  "burnt": "0",
  "initialMinted": "690000000000000000000000000000",
  "decimals": 18,
  "isPaused": false,
  "assets": {},
  "transactions": 61,
  "transactionsLastUpdatedAt": 1777991761,
  "transfers": 82,
  "transfersLastUpdatedAt": 1777989961,
  "accounts": 46,
  "accountsLastUpdatedAt": 1777992241,
  "canUpgrade": true,
  "canMint": false,
  "canBurn": false,
  "canChangeOwner": false,
  "canAddSpecialRoles": true,
  "canPause": false,
  "canFreeze": false,
  "canWipe": false,
  "canTransferNftCreateRole": false,
  "price": 0,
  "marketCap": 0,
  "supply": "690000000000",
  "circulatingSupply": "690000000000",
  "timestamp": 1716495240,
  "mexPairType": "experimental",
  "totalLiquidity": 0,
  "totalVolume24h": 0,
  "isLowLiquidity": false,
  "lowLiquidityThresholdPercent": 0,
  "tradesCount": 0,
  "ownersHistory": {},
  "role": {
    "address": "erd1vj3efd5czwearu0gr3vjct8ef53lvtl7vs42vts2kh2qn3cucrnsj7ymqx",
    "canLocalMint": false,
    "canLocalBurn": false,
    "canCreate": false,
    "canBurn": false,
    "canAddQuantity": false,
    "canUpdateAttributes": false,
    "canAddUri": false,
    "canTransfer": true,
    "roles": []
  },
  "address": "erd1vj3efd5czwearu0gr3vjct8ef53lvtl7vs42vts2kh2qn3cucrnsj7ymqx",
  "canLocalMint": false,
  "canLocalBurn": false,
  "canCreate": false,
  "canAddQuantity": false,
  "canUpdateAttributes": false,
  "canAddUri": false,
  "canTransfer": true
}