Skip to main content

/ntfs

Returns a list of Non-Fungible / Semi-Fungible / MetaESDT tokens available on blockchain

Parameters

  • fromOPTIONAL (string) - Number of items to skip for the result set
  • sizeOPTIONAL (string) - 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 : OPTIONAL(string) - Get all tokens by token collection. Deprecated, replaced by collections parameter
  • tags : OPTIONAL (array[string]) - Filter by one or more comma-separated tags
  • creator : OPTIONAL (string) - Return all NFTs associated with a given creator
  • name: (string) - The username specific for this account
  • isWhitelistedStorage : (boolean) - Return all NFTs that are whitelisted in storage
  • hasUris : OPTIONAL (boolean) - Return all NFTs that have one or more uris
  • isNsfw : (boolean) - Filter by NSFW status
  • before OPTIONAL : (number) - Before timestamp
  • after OPTIONAL : (number) - After timestamp
  • withOwner : (boolean) - Return owner where type = NonFungibleESDT
  • withSupply : OPTIONAL (boolean) - Return supply where type = SemiFungibleESDT
  • withScamInfo : (boolean)
  • computeScamInfo : (boolean)

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 starts with “-” and has 6 more random characters
  • scaminfo:
    • scam : (string)
    • info : (string)
  • score : (number)
  • rank : (number)
  • isNsfw : (boolean)
  • unlockschedule:
    • remainingEpoch : (number)
    • percent : (number)

Example Request and Result for /nfts

Request

curl -X 'GET' \
'https://elrond-api.public.blastapi.io/nfts?collection=GSPACEAPE-08bc2b&creator=erd1qqqqqqqqqqqqqpgq9t4l4rm2fr9h4fv05u2ld5eh99a7hlmua9rspf78gp&isWhitelistedStorage=true&hasUris=true&isNsfw=true&withOwner=true&withSupply=false&withScamInfo=true&computeScamInfo=true' \
-H 'accept: application/json'

Result

[
{
"identifier": "GSPACEAPE-08bc2b-141d",
"collection": "GSPACEAPE-08bc2b",
"timestamp": 1659724296,
"attributes": "bWV0YWRhdGE6YmFmeWJlaWNzYTJ5Z21vZDNidHZqdGR2ZjZwb2ZocDR2dGpnZnpncG1qaG1naXJ5dW5yY2VjY3htZWUvMTIwNDMuanNvbjt0YWdzOkNhbnRpbmEgUm95YWxlLEdlbmVzaXMgU3BhY2UgQXBlcyxTcGFjZSBBcGVz",
"nonce": 5149,
"type": "NonFungibleESDT",
"name": "GenesisSpaceApe #12043",
"creator": "erd1qqqqqqqqqqqqqpgq9t4l4rm2fr9h4fv05u2ld5eh99a7hlmua9rspf78gp",
"royalties": 5,
"uris": [
"aHR0cHM6Ly9pcGZzLmlvL2lwZnMvYmFmeWJlaWNzYTJ5Z21vZDNidHZqdGR2ZjZwb2ZocDR2dGpnZnpncG1qaG1naXJ5dW5yY2VjY3htZWUvMTIwNDMucG5n",
"aHR0cHM6Ly9pcGZzLmlvL2lwZnMvYmFmeWJlaWNzYTJ5Z21vZDNidHZqdGR2ZjZwb2ZocDR2dGpnZnpncG1qaG1naXJ5dW5yY2VjY3htZWUvMTIwNDMuanNvbg==",
"aHR0cHM6Ly9tZXRhZGF0YS52ZXJrby5pby9keW5hbWljL0dTUEFDRUFQRS0wOGJjMmIvMTIwNDM="
],
"url": "https://media.elrond.com/nfts/asset/bafybeicsa2ygmod3btvjtdvf6pofhp4vtjgfzgpmjhmgiryunrceccxmee/12043.png",
"media": [
{
"url": "https://media.elrond.com/nfts/asset/bafybeicsa2ygmod3btvjtdvf6pofhp4vtjgfzgpmjhmgiryunrceccxmee/12043.png",
"originalUrl": "https://ipfs.io/ipfs/bafybeicsa2ygmod3btvjtdvf6pofhp4vtjgfzgpmjhmgiryunrceccxmee/12043.png",
"thumbnailUrl": "https://media.elrond.com/nfts/thumbnail/GSPACEAPE-08bc2b-ec2fee56",
"fileType": "image/png",
"fileSize": 627373
}
],
"isWhitelistedStorage": true,
"tags": [
"cantina royale",
"genesis space apes",
"space apes"
],
"metadata": {
"id": "12043",
"name": "Genesis Space Ape #12043",
"stats": "https://metadata.verko.io/dynamic/1/12043",
"description": "Space Apes are in-game playable and tradable character NFTs inside the Cantina Royale Game. Each Space Ape belongs to a certain rarity: Bronze, Silver, Gold, Epic, Legendary. They come with 3 Base Stats: Vitality, Defence, Agility, and 2 randomly assigned Special Perks. Every Space Ape comes with a unique ID which remains permanent within the game and on-chain.",
"dna": "0000000001151c0000021c3108",
"genesis": true,
"attributes": [
{
"trait_type": "Species",
"value": "Genesis Space Ape"
},
{
"trait_type": "Rarity Class",
"value": "Bronze"
},
{
"trait_type": "Head",
"value": "Default"
},
{
"trait_type": "Face",
"value": "None"
},
{
"trait_type": "Skin",
"value": "Blue"
},
{
"trait_type": "Eyes",
"value": "Sad"
},
{
"trait_type": "Mouth",
"value": "Rage"
},
{
"trait_type": "Earrings",
"value": "None"
},
{
"trait_type": "Headgear",
"value": "None"
},
{
"trait_type": "Body",
"value": "Bandolier"
},
{
"trait_type": "Legs",
"value": "Pilot Pants Black"
},
{
"trait_type": "LegAccessories",
"value": "Titan Bags Brown"
},
{
"trait_type": "Background",
"value": "Desert"
},
{
"trait_type": "Perk 1",
"value": "Scatter Weapons Proficiency"
},
{
"trait_type": "Perk 2",
"value": "Cool Moves"
}
]
},
"owner": "erd1hrqzuj3tgcdvwrkzqa546umkzev2gtx5k8re3ckfrt4fyep5hrvqh5mrnq",
"ticker": "GSPACEAPE-08bc2b",
"score": 12.095,
"rank": 9230,
"isNsfw": true
}
]