Get collection roles with detailed metadata for an account

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves all collections where the specified account holds special roles, returning extended collection information (traits, auction stats, assets) and role permissions for that account.

Parameters

addressstringrequiredpath

Account address in bech32 format

Response

200OK

Successful response

Get collection roles with detailed metadata for an account

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

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://egld-api.nownodes.io/accounts/{address}/roles/collections')
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": "XKEY-e6e64b",
    "type": "SemiFungibleESDT",
    "subType": "SemiFungibleESDT",
    "name": "xKEY",
    "ticker": "XKEY",
    "owner": "erd1rng8ujryx0h9yxewx7x60v4p956gyau9wxdjpgrz757jchvx70zqkmlr7j",
    "timestamp": 1752846084,
    "timestampMs": 1752846084000,
    "canFreeze": true,
    "canWipe": true,
    "canPause": true,
    "canTransferNftCreateRole": true,
    "canChangeOwner": false,
    "canUpgrade": true,
    "canAddSpecialRoles": true,
    "decimals": 0,
    "assets": {
      "website": "https://excons.xyz/",
      "description": "XKEY is your initiation pass into the EXCONS ecosystem — unlock $EXCONS, access future drops, and earn early rewards as part of the rebellion.",
      "status": "active",
      "pngUrl": "https://tools.multiversx.com/assets-cdn/tokens/XKEY-e6e64b/icon.png",
      "name": "XKEY Collection",
      "svgUrl": "https://tools.multiversx.com/assets-cdn/tokens/XKEY-e6e64b/icon.svg",
      "ledgerSignature": "3045022100ba6735ab8da2adcb980edc76edf5405102d971cda21252d314e4f14b1739948a0220192ecef920188c68bbd08830adcaf7600af3896d0e913d5a7e343d95d3d02941",
      "lockedAccounts": {
        "erd1vudplk63q6fph97suwkqeafw2hmlgctp2aqszsxhv5ur3lkvgrmscg53uk": "Foundation Reserve"
      },
      "extraTokens": [
        "EXCONS-123abc"
      ],
      "preferredRankAlgorithm": "trait",
      "priceSource": {
        "type": "dataApi",
        "url": "https://api.multiversx.com/prices",
        "path": "$.price.usd"
      }
    },
    "scamInfo": null,
    "traits": [],
    "auctionStats": {
      "activeAuctions": 12,
      "endedAuctions": 345,
      "maxPrice": "5000000000000000000",
      "minPrice": "100000000000000000",
      "saleAverage": "375000000000000000",
      "volumeTraded": "129375000000000000000"
    },
    "isVerified": true,
    "holderCount": 10223,
    "nftCount": 2,
    "role": {
      "address": "erd1vj3efd5czwearu0gr3vjct8ef53lvtl7vs42vts2kh2qn3cucrnsj7ymqx",
      "canCreate": true,
      "canBurn": true,
      "canAddQuantity": false,
      "canUpdateAttributes": false,
      "canAddUri": true,
      "canTransfer": true,
      "roles": [
        "ESDTRoleNFTCreate",
        "ESDTRoleLocalBurn",
        "ESDTRoleLocalMint"
      ]
    },
    "canTransfer": true,
    "canCreate": true,
    "canBurn": true,
    "canAddQuantity": false,
    "canUpdateAttributes": false,
    "canAddUri": true
  },
  {
    "collection": "HTMA-18b32d",
    "type": "NonFungibleESDT",
    "subType": "NonFungibleESDTv2",
    "name": "HTMA",
    "ticker": "HTMA-18b32d",
    "owner": "erd10q8t3crkxe39de7z37lc72lwu3n7lx6g3n624c8snkcxssxkdv9qzs74mg",
    "timestamp": 1744294230,
    "timestampMs": 1744294230000,
    "canFreeze": false,
    "canWipe": false,
    "canPause": false,
    "canTransferNftCreateRole": false,
    "canChangeOwner": false,
    "canUpgrade": true,
    "canAddSpecialRoles": true,
    "decimals": 0,
    "assets": null,
    "scamInfo": null,
    "traits": [],
    "auctionStats": null,
    "isVerified": false,
    "holderCount": 512,
    "nftCount": 1,
    "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
  }
]