This tutorial explains the steps involved in getting any Ethereum Mainnet NFT by its unique ID. The response contains the attributes, mint date, and type of a given NFT as well as other details associated with it.
Step 1. Use the assets endpoint to get a list of NFTs.
For example, you can follow these steps: How to Get All NFTs for a Smart Contract
Step 2. Copy an asset ID from the id
field:
{
"id": "5e1f4454-34ff-5118-9987-96b481625128",
"token_id": "9999",
...more properties...
}
Step 3. Use the asset endpoint with the following details:
-
protocol:
ethereum
-
network:
mainnet
-
asset ID:
5e1f4454-34ff-5118-9987-96b481625128
(copied in the previous step)https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/asset/5e1f4454-34ff-5118-9987-96b481625128
Step 4. Execute the query.
For example, in cURL, you should run the following code:
curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/asset/5e1f4454-34ff-5118-9987-96b481625128' -H 'Authorization: Bearer YOUR_API_KEY'
Note!
To authorize your request, you need to get an API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide
Step 5. Your results will look something like this:
{
"asset": {
"token_id": "9999",
"token_type": "ERC721",
"media": {
"image_url": "token/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/5e1f4454-34ff-5118-9987-96b481625128.png",
"source": "ipfs://QmejYePrutbfWEV8wA3ogTHi2cf2j6hoaPhZSc6vNE43nH"
},
"name": "#9999",
"mint_date": "1619858117",
"token_uri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/9999",
"description": "",
"contract_address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
"wallets": [],
"attributes": [
{
"trait_type": "Hat",
"value": "Army Hat"
},
{
"trait_type": "Background",
"value": "Purple"
},
{
"trait_type": "Mouth",
"value": "Bored Unshaven"
},
{
"trait_type": "Earring",
"value": "Gold Hoop"
},
{
"trait_type": "Fur",
"value": "Gray"
},
{
"trait_type": "Eyes",
"value": "Scumbag"
}
],
"burned": false,
"rarity": [
{
"model": "open_rarity",
"score": 0.9954297307820068,
"rank": "5327"
}
]
}
}
The token type is returned by the token_type
field, e.g.:
"token_type": "ERC721"
The mint date is returned in Unix time by the mint_date
field:
"mint_date": "1619858117"
Attributes are located in the attributes
section:
"attributes": [
{
"trait_type": "Hat",
"value": "Army Hat"
},
{
"trait_type": "Background",
"value": "Purple"
},
{...more attributes...}
]