Skip to main content

/accounts/:address:/roles/collections/:collection:

Returns details about a specific NFT/SFT/MetaESDT collection from a given address.​

Parameters​

  • **address: **REQUIRED (string) - the address to query
  • **collection : **REQUIRED (string) - the information about the NFT or SFT, like picture traits or tags for your NFT/collection

Returns​

  • collection : (string) - represents additional information about the NFT or SFT, like picture traits or tags for your NFT/collection. The field should follow a metadata:ipfsCID/fileName.json;tags:tag1,tag2,tag3 format
  • type : (string) - enum [NonFungibleESDT, SemiFungibleESDT, MetaESDT]
  • ticker : (string) - a random string that starts with “-” and has 6 more random characters
  • owner : (string) - the owner's address
  • timestamp : (number) - u64 format
  • canFreeze: (boolean) - the token manager may freeze the token balance in a specific account, preventing transfers to and from that account - default value: false
  • canWipe: (boolean) - the token manager may wipe out the tokens held by a frozen account, reducing the supply - default value: false
  • canPause: (boolean) - the token manager may prevent all transactions of the token, apart from minting and burning - default value: false
  • _canTransferNFTCreateRole _ : (boolean) - the addresses with the transfer role can transfer anywhere
  • decimals: (number) - the number of decimals in order to display balance
  • assets :
    • website : (string)
    • description : (string)
    • status : active/inactive
    • pngUrl : (string)
    • svgUrl : (string)
    • lockedAccounts : (array[string])
    • extraTokens : (array[string])
  • roles :
    • address: (string) - account bech32 address
    • canCreate : (boolean) - this role allows one to create
    • canBurn: (boolean) - users may "burn" some of their tokens, reducing the supply - default value: false
    • canAddQuantity : (boolean) - this role allows one to add quantity of a specific SFT
    • canUpdateAttributes : (boolean) - this role allows one to change the attributes of a specific NFT
    • canAddUri : (boolean) - this role allows one to add URIs for a specific NFT
    • canTransferRole : (boolean) - this role enables transfer only to specified addresses
    • roles : (array[string]) - the list of the roles

Example Request and Result for /accounts/{"{address}"}/roles/collections/{"{collection}"}​

Request:

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/accounts/erd160y56egs9q7en67z06jk8ndsgxxuc0srf4kx8gfwc7xmap7zqvtqv973la/roles/collections/test' \
  -H 'accept: application/json'

Result:

{
  "collection": "string",
  "type": "NonFungibleESDT",
  "name": "string",
  "ticker": "string",
  "owner": "string",
  "timestamp": 0,
  "canFreeze": false,
  "canWipe": false,
  "canPause": false,
  "canTransferNftCreateRole": false,
  "decimals": 0,
  "assets": {
    "website": "string",
    "description": "string",
    "status": "inactive",
    "pngUrl": "string",
    "svgUrl": "string",
    "lockedAccounts": [
      "string"
    ],
    "extraTokens": [
      "string"
    ]
  },
  "roles": {
    "address": "string",
    "canCreate": false,
    "canBurn": false,
    "canAddQuantity": false,
    "canUpdateAttributes": false,
    "canAddUri": false,
    "canTransferRole": false,
    "roles": [
      "string"
    ]
  },
  "canCreate": true,
  "canBurn": true,
  "canAddQuantity": true,
  "canUpdateAttributes": true,
  "canAddUri": true,
  "canTransferRole": true
}