Get token roles for an account

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves all ESDT tokens (fungible, semi‑fungible, non‑fungible) where the given account has one or more special roles (local mint, local burn, NFT create, add quantity, update attributes, add URI, etc.). Returns full token details together with the account’s role assignment.

Parameters

addressstringrequiredpath

Account address in bech32 format

Response

200OK

Successful response

Get token roles for an account

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

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://egld-api.nownodes.io/accounts/{address}/roles/tokens')
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": "AERO-458bbf",
    "collection": "AERO-458bbf",
    "nonce": 0,
    "name": "Aerovek",
    "ticker": "AERO",
    "owner": "erd1kaeyvxe7vhf25hk7k9sucrwnzke9m8mwu5twp9rphlxp3hlsmm4sksarmu",
    "minted": "1000000000000000000000000",
    "burnt": "50000000000000000000000",
    "initialMinted": "1000000000000000000000000",
    "decimals": 18,
    "isPaused": false,
    "assets": {
      "website": "https://aerovek.com",
      "description": "Aerovek is a social economic platform for aviation",
      "status": "active",
      "pngUrl": "https://tools.multiversx.com/assets-cdn/tokens/AERO-458bbf/icon.png",
      "name": "Aerovek Token",
      "svgUrl": "https://tools.multiversx.com/assets-cdn/tokens/AERO-458bbf/icon.svg",
      "ledgerSignature": "3045022100ba6735ab8da2adcb980edc76edf5405102d971cda21252d314e4f14b1739948a0220192ecef920188c68bbd08830adcaf7600af3896d0e913d5a7e343d95d3d02941",
      "lockedAccounts": {
        "erd1ss6u80ruas2phpmr82r42xnkd6rxy40g9jl69frppl4qez9w2jpsqj8x97": "Team Wallet"
      },
      "extraTokens": [
        "MEX-455c57"
      ],
      "preferredRankAlgorithm": "trait",
      "priceSource": {
        "type": "dataApi",
        "url": "https://api.multiversx.com/prices",
        "path": "$.price.usd"
      }
    },
    "transactions": 508089,
    "transactionsLastUpdatedAt": 1777990682,
    "transfers": 2176019,
    "transfersLastUpdatedAt": 1777990682,
    "accounts": 76241,
    "accountsLastUpdatedAt": 1777989841,
    "canUpgrade": true,
    "canMint": false,
    "canBurn": true,
    "canChangeOwner": true,
    "canAddSpecialRoles": true,
    "canPause": false,
    "canFreeze": false,
    "canWipe": false,
    "canTransferNftCreateRole": false,
    "price": 0.000063030784,
    "marketCap": 6276.478,
    "supply": "99577978400849356521710515",
    "circulatingSupply": "99577978400849356521710515",
    "timestamp": 1619994696,
    "mexPairType": "fungibleesdt",
    "totalLiquidity": 177.5876,
    "totalVolume24h": 0.05343785,
    "isLowLiquidity": false,
    "lowLiquidityThresholdPercent": 0.5,
    "tradesCount": 99927,
    "ownersHistory": {},
    "role": {
      "address": "erd1vj3efd5czwearu0gr3vjct8ef53lvtl7vs42vts2kh2qn3cucrnsj7ymqx",
      "canLocalMint": true,
      "canLocalBurn": true,
      "canCreate": false,
      "canBurn": false,
      "canAddQuantity": false,
      "canUpdateAttributes": false,
      "canAddUri": false,
      "canTransfer": true,
      "roles": [
        "ESDTRoleLocalMint",
        "ESDTRoleLocalBurn"
      ]
    },
    "address": "erd1vj3efd5czwearu0gr3vjct8ef53lvtl7vs42vts2kh2qn3cucrnsj7ymqx",
    "canLocalMint": true,
    "canLocalBurn": true,
    "canCreate": false,
    "canAddQuantity": false,
    "canUpdateAttributes": false,
    "canAddUri": false,
    "canTransfer": true
  },
  {
    "type": "NonFungibleESDT",
    "subType": "NonFungibleESDTv2",
    "identifier": "ESDT-f5690f-01",
    "collection": "ESDT-f5690f",
    "nonce": 1,
    "name": "Genesis NFT",
    "ticker": "GENS",
    "owner": "erd1xy32vs5maqa7srqvu69cxqvs732n8xtxtpdtsed6wachc640r8rqxz3x4h",
    "minted": "1",
    "burnt": "0",
    "initialMinted": "1",
    "decimals": 0,
    "isPaused": false,
    "assets": {
      "website": "https://example.com/genesis",
      "description": "First NFT in the collection",
      "status": "active",
      "pngUrl": "https://tools.multiversx.com/assets-cdn/nfts/ESDT-f5690f/01.png",
      "name": "Genesis",
      "svgUrl": "https://tools.multiversx.com/assets-cdn/nfts/ESDT-f5690f/01.svg"
    },
    "transactions": 10,
    "transactionsLastUpdatedAt": 1777990000,
    "transfers": 5,
    "transfersLastUpdatedAt": 1777990000,
    "accounts": 3,
    "accountsLastUpdatedAt": 1777990000,
    "canUpgrade": false,
    "canMint": false,
    "canBurn": true,
    "canChangeOwner": false,
    "canAddSpecialRoles": false,
    "canPause": false,
    "canFreeze": false,
    "canWipe": false,
    "canTransferNftCreateRole": false,
    "price": 0,
    "marketCap": 0,
    "supply": "1",
    "circulatingSupply": "1",
    "timestamp": 1753751814,
    "mexPairType": "experimental",
    "totalLiquidity": 0,
    "totalVolume24h": 0,
    "isLowLiquidity": true,
    "lowLiquidityThresholdPercent": 0,
    "tradesCount": 0,
    "ownersHistory": {},
    "role": {
      "address": "erd1vj3efd5czwearu0gr3vjct8ef53lvtl7vs42vts2kh2qn3cucrnsj7ymqx",
      "canLocalMint": false,
      "canLocalBurn": true,
      "canCreate": false,
      "canBurn": false,
      "canAddQuantity": false,
      "canUpdateAttributes": false,
      "canAddUri": false,
      "canTransfer": true,
      "roles": [
        "ESDTRoleLocalBurn"
      ]
    },
    "address": "erd1vj3efd5czwearu0gr3vjct8ef53lvtl7vs42vts2kh2qn3cucrnsj7ymqx",
    "canLocalMint": false,
    "canLocalBurn": true,
    "canCreate": false,
    "canAddQuantity": false,
    "canUpdateAttributes": false,
    "canAddUri": false,
    "canTransfer": true
  }
]