Skip to main content

/accounts/:address:/nfts

Returns a list of all available NFTs/SFTs/MetaESDTs owned by the provided address.​

Parameters​

  • address REQUIRED (string) - account bech32 address
  • fromOPTIONAL (string) - the number of items to skip for the result set
  • sizeOPTIONAL (string) - the number of items to retrieve
  • search OPTIONAL (string) - search by collection identifier
  • identifiers OPTIONAL(array[string]) - filter by identifiers, comma-separated
  • typeOPTIONAL (string) - filter by type (NonFungibleESDT/SemiFungibleESDT/MetaESDT)
  • collection : DEPRECATED(string) - get all tokens by token collection. Deprecated, replaced by collections parameter
  • collections : OPTIONAL(array[string]) - get all tokens by token collections, comma-separated
  • **tags : **OPTIONAL (array[string]) - filter by one or more comma-separated tags
  • **creator : **OPTIONAL (string) - return all NFTs associated with a given creator
  • **hasUris : **OPTIONAL (boolean) - return all NFTs that have one or more uris
  • **includeFlagged : **OPTIONAL (boolean) - include NFTs that are flagged or not
  • **withSupply : **OPTIONAL (boolean) - return supply where type = SemiFungibleESDT
  • **source : **OPTIONAL (string) - data source of request

Returns​

  • identifier: (string) - token identifier
  • 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
  • timestamp : (number) - u64 format
  • attributes : (string) - raw bytes where any data can be stored
  • nonce: (number) - NFT/SFT token nonce
  • type : (string) - enum [NonFungibleESDT, SemiFungibleESDT, MetaESDT]
  • name: (string) - The username specific for this account
  • creator : (string) - address of the account that created the NFT
  • royalties : (number) - a proportion out of 10000 that represents what percentage of an NFT sell price should be transferred to the creator. This is not enforced by the protocol or Mandos in any way
  • uris : (array[string]) - a list of URIs associated to the NFT/SFT
  • url : (string) - the URL associated to the NFT/SFT
  • media : (array[string])
    • url : (string)
    • filesize : (number)
    • filetype : (string)
    • originalUrl : (string)
    • thumbnailUrl : (string)
  • isWhitelistedStorage : (boolean) - return all NFTs that are whitelisted in storage
  • thumbnailUrl : (string)
  • tags : (array[string])
  • metadata:
    • description : (string)
    • fileType : (string) - the type of the file
    • fileUri : (string) - the Uri of the file
    • fileName : (string) - the name of the file
  • owner: (string) - the owner's address
  • balance : (number) - account current balance
  • supply : (number)
  • 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])
  • ticker: (string) - a random string that starts with “-” and has 6 more random characters
  • scaminfo:
    • scam : (string)
    • info : (string)
  • price : (number) - price value
  • valueUsd : (number)

Example Request and Result for /accounts/:address:/nfts ​

Request:

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

Result:

[
  {
    "identifier": "AEROCIA-487b5f-01c2",
    "collection": "AEROCIA-487b5f",
    "attributes": "Q29sbGVjdGlvbjpBZXJvdmVrIHggQ3liZXJzO1R5cGU6Q2hyaXN0bWFzIGdpZnQ7WWVhcjoyMDIxO1RhZ3M6Q3liZXJzLEFlcm92ZWtBdmlhdGlvbixDeWJlcnNJbkFjdGlvbixFbHJvbmQ7RGVzY3JpcHRpb246Q29sbGFib3JhdGlvbiBORlQgYmV0d2VlbiBBZXJvdmVrIEF2aWF0aW9uIGFuZCBDeWJlcnMgSW4gQWN0aW9uIG9mZmVyZWQgYXMgZ2lmdCB0byAjRWxyb25kQ29tbXVuaXR5IGR1cmluZyBDaHJpc3RtYXMgLSBOZXcgWWVhcidzIEV2ZS4=",
    "nonce": 450,
    "type": "NonFungibleESDT",
    "name": "Aerovek x Cybers",
    "creator": "erd1qqqqqqqqqqqqqpgqqjp7r9e3vvfazl26g7whrf89qq0fjulhyl5sa4pdhh",
    "royalties": 10,
    "uris": [
      "aHR0cHM6Ly9nYXRld2F5LnBpbmF0YS5jbG91ZC9pcGZzL1FtYm1TdUpoWFdNQm1oUVkxS0xzUFh4d2FoZmU1dXVKeFRTdzVvOGJhVEpyZmc="
    ],
    "url": "https://media.elrond.com/nfts/asset/QmbmSuJhXWMBmhQY1KLsPXxwahfe5uuJxTSw5o8baTJrfg",
    "media": [
      {
        "url": "https://gateway.pinata.cloud/ipfs/QmbmSuJhXWMBmhQY1KLsPXxwahfe5uuJxTSw5o8baTJrfg",
        "fileSize": 944201,
        "fileType": "image/jpeg",
        "originalUrl": "https://gateway.pinata.cloud/ipfs/QmbmSuJhXWMBmhQY1KLsPXxwahfe5uuJxTSw5o8baTJrfg",
        "thumbnailUrl": "https://media.elrond.com/nfts/thumbnail/AEROCIA-487b5f-0f8953cd"
      }
    ],
    "isWhitelistedStorage": true,
    "ticker": "AEROCIA-487b5f"
  },
  {
    "identifier": "APCTICKET-dd6db3-01",
    "collection": "APCTICKET-dd6db3",
    "attributes": "dGFnczo7bWV0YWRhdGE6UW1US0p4dTF4R1Y3UnR6Z3BYc3ExcFh5d3FyVmhzc2QzZTJFSHdFQVhQNEEzaw==",
    "nonce": 1,
    "type": "SemiFungibleESDT",
    "name": "Angry Penguins Ticket",
    "creator": "erd14takv44utfe9gxad464ay8zh34y0h37mm896qprh4nd9ncvvekgqnlpnzk",
    "royalties": 10,
    "uris": [
      "aHR0cHM6Ly9pcGZzLmlvL2lwZnMvUW1iRFVma1B2UFJzSjVRYm9jcmVFRlVReEhQZUF2bkJqU3NhUU1iWVhFaEV5Uw=="
    ],
    "url": "https://media.elrond.com/nfts/asset/QmbDUfkPvPRsJ5QbocreEFUQxHPeAvnBjSsaQMbYXEhEyS",
    "media": [
      {
        "url": "https://media.elrond.com/nfts/asset/QmbDUfkPvPRsJ5QbocreEFUQxHPeAvnBjSsaQMbYXEhEyS",
        "fileSize": 5109262,
        "fileType": "video/mp4",
        "originalUrl": "https://ipfs.io/ipfs/QmbDUfkPvPRsJ5QbocreEFUQxHPeAvnBjSsaQMbYXEhEyS",
        "thumbnailUrl": "https://media.elrond.com/nfts/thumbnail/APCTICKET-dd6db3-caf5ddc9"
      }
    ],
    "isWhitelistedStorage": true,
    "tags": [
      ""
    ],
    "metadata": {},
    "balance": "1",
    "ticker": "APCTICKET-dd6db3"
  }
]