Skip to main content

/collections

Returns non-fungible/semi-fungible/meta-esdt collections​

Parameters​

  • from OPTIONAL (number) - Number of items to skip for the result set
  • size OPTIONAL (number) - Number of items to retrieve
  • search OPTIONAL (string) - Search by collection identifier
  • identifiersOPTIONAL (array[string]) - Search by collection identifiers, comma-separated
  • type OPTIONAL (array[string]) - Filter by type (NonFungibleESDT/SemiFungibleESDT/MetaESDT)
  • creatorDEPRECATED (string) - Filter collections where the given address has a creator role
  • before OPTIONAL : (number) - Return all collections before given timestamp
  • after OPTIONAL : (number) - Return all collections after given timestamp
  • canCreateOPTIONAL (boolean) - Filter by property canCreate
  • canBurnOPTIONAL (boolean) - Filter by property canBurn
  • canAddQuantityOPTIONAL (boolean) - Filter by property canAddQuantity
  • canUpdateAttributesOPTIONAL (boolean) - Filter by property canUpdateAttributes
  • canAddUriOPTIONAL (boolean) - Filter by property canAddUri
  • canTransferRoleOPTIONAL (boolean) - Filter by property canTransferRole

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]
  • name : (string) - The username specific for this account
  • ticker : (string) - a random string 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 add URIs for a specific NFT
    • canTransferRole : (boolean) - this role enables transfer only to specified addresses
    • roles : (array[string]) - the list of roles

Example​

Request

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/collections?search=ARCRacing' \
  -H 'accept: application/json'

Result

[
  {
    "collection": "ARCRACING-bcdf83",
    "type": "NonFungibleESDT",
    "name": "ARCRacing",
    "ticker": "ARCRACING-bcdf83",
    "owner": "erd1qqqqqqqqqqqqqpgq9m2c2xhukgkx4u56yne7l2yx5yvstvd8ys5s20ne4m",
    "timestamp": 1661507550,
    "canFreeze": false,
    "canWipe": false,
    "canPause": false,
    "canTransferNftCreateRole": false
  },
  {
    "collection": "ARCRC-f7eb84",
    "type": "NonFungibleESDT",
    "name": "ARCRacingNFT",
    "ticker": "ARCRC-f7eb84",
    "owner": "erd1qqqqqqqqqqqqqpgq9m2c2xhukgkx4u56yne7l2yx5yvstvd8ys5s20ne4m",
    "timestamp": 1661503596,
    "canFreeze": false,
    "canWipe": false,
    "canPause": false,
    "canTransferNftCreateRole": false
  }
]