Skip To Content

Blockdaemon Documentation

GET NFT Asset by ID

GET NFT Asset by ID (V1)
Path Parameters
Example Queries
Example Response


GET NFT Asset by ID (V1)

https://ubiquity.api.blockdaemon.com/v1/nft/{protocol}/{network}/asset/{id}

Returns detailed information about an NFT asset by a given asset ID.

Learn how to authorize your request: Authentication Guide

Note: Blockdaemon collects NFT information and data from various third-party sources (“NFT Content”). We do not create, own, or control NFT Content and we do not routinely monitor NFT Content for violations of these Terms. You acknowledge that Blockdaemon has no responsibility or liability related to NFT Content and agree that you must evaluate, and decide for yourself if you wish to use any NFT Content.


Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

It is also required to specify an asset ID as the last path parameter, e.g.:

  • 5e1f4454-34ff-5118-9987-96b481625128

Note: Asset IDs are returned by GET NFT Assets (V1) in the id field.


Example Queries

The following query provides a useful example for GET NFT Asset by ID (V1).

To get an asset in the Ethereum Mainnet network, use:

https://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/asset/5e1f4454-34ff-5118-9987-96b481625128

See also: How to get the Attributes and Mint Date of an NFT


Example Response

The following is a typical response from GET NFT Asset by ID(V1):

{
    "asset": {
        "token_id": "9999",
        "token_type": "ERC721",
        "media": {
            "image_url": "https://ubiquity.api.blockdaemon.com/v1/nft/media/ethereum/mainnet/token/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/5e1f4454-34ff-5118-9987-96b481625128"
        },
        "name": "#9999",
        "mint_date": "1619858117",
        "token_uri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/9999",
        "description": "",
        "contract_address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
        "wallets": [
            {
                "address": "0x46Fd6B647Dc8C82aD8f6cf0CC6b22ACad3f6e39d"
            }
        ],
        "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"
            }
        ]
    }
}

Notes:

  • To find the NFT owner’s address, see the wallets field. ERC-1155 tokens can be owned by multiple wallets, so it returns an array.
  • For assets from the top 100 popular collections, image URLs are returned in the media.image_url field. All images are stored by Blockdaemon, which allows you to quickly access them (authentication required). The popularity of a collection is calculated from its total volume.

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.