Get account roles for a specific collection

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves full information about a collection (NFT/SFT) together with the role assignment and permissions of the specified account on that collection.

Parameters

addressstringrequiredpath

Account address in bech32 format

collectionstringrequiredpath

Collection identifier (ticker + random suffix)

Response

200OK

Successful response

Get account roles for a specific collection

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

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

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

{
  "collection": "ESDT-f5690f",
  "type": "NonFungibleESDT",
  "subType": "NonFungibleESDTv2",
  "name": "ESDT",
  "ticker": "ESDT-f5690f",
  "owner": "erd1xy32vs5maqa7srqvu69cxqvs732n8xtxtpdtsed6wachc640r8rqxz3x4h",
  "timestamp": 1753751814,
  "timestampMs": 1753751814000,
  "canFreeze": false,
  "canWipe": false,
  "canPause": false,
  "canTransferNftCreateRole": false,
  "canChangeOwner": false,
  "canUpgrade": true,
  "canAddSpecialRoles": true,
  "decimals": 0,
  "assets": {
    "website": "https://example.com/esdt",
    "description": "Basic ESDT collection representing a generic NFT",
    "status": "active",
    "pngUrl": "https://tools.multiversx.com/assets-cdn/tokens/ESDT-f5690f/icon.png",
    "name": "ESDT Collection",
    "svgUrl": "https://tools.multiversx.com/assets-cdn/tokens/ESDT-f5690f/icon.svg",
    "ledgerSignature": "3045022100ba6735ab8da2adcb980edc76edf5405102d971cda21252d314e4f14b1739948a0220192ecef920188c68bbd08830adcaf7600af3896d0e913d5a7e343d95d3d02941",
    "lockedAccounts": {
      "erd1ss6u80ruas2phpmr82r42xnkd6rxy40g9jl69frppl4qez9w2jpsqj8x97": "Team Allocation"
    },
    "extraTokens": [
      "MEX-455c57"
    ],
    "preferredRankAlgorithm": "trait",
    "priceSource": {
      "type": "dataApi",
      "url": "https://api.multiversx.com/prices",
      "path": "$.price.usd"
    }
  },
  "scamInfo": null,
  "traits": [],
  "auctionStats": {
    "activeAuctions": 0,
    "endedAuctions": 15,
    "maxPrice": "2500000000000000000",
    "minPrice": "500000000000000000",
    "saleAverage": "1200000000000000000",
    "volumeTraded": "18000000000000000000"
  },
  "isVerified": false,
  "holderCount": 42,
  "nftCount": 500,
  "role": {
    "address": "erd1vj3efd5czwearu0gr3vjct8ef53lvtl7vs42vts2kh2qn3cucrnsj7ymqx",
    "canCreate": false,
    "canBurn": true,
    "canAddQuantity": false,
    "canUpdateAttributes": false,
    "canAddUri": false,
    "canTransfer": true,
    "roles": [
      "ESDTRoleLocalBurn"
    ]
  },
  "canTransfer": true,
  "canCreate": false,
  "canBurn": true,
  "canAddQuantity": false,
  "canUpdateAttributes": false,
  "canAddUri": false
}