Skip To Content

Blockdaemon Documentation

GET NFT Asset

GET NFT Asset
Ubiquity NFT URL
Path Parameters
Query Parameters
Example Queries
Example Response


GET NFT Asset

https://{ubiquity_nft_url}/{protocol}/{network}/asset/{id}

Returns detailed information about an NFT asset. There are two ways to get it:

To display wallets (NFT owners), add the following query parameter: show_wallets=true

Developer documentation: GET NFT Asset
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.


Ubiquity URL

To run a query, add your Ubiquity NFT URL. For most users this will be:

  • svc.blockdaemon.com/nft/v1

An example of this is shown below:

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

Note: If you created your Ubiquity API Key before September 2022, add the legacy Ubiquity NFT URL:

  • ubiquity.api.blockdaemon.com/nft/v1

An example of this is shown below:

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

Path Parameters

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

  • ethereum/mainnet

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

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

Notes:

  • Asset IDs are returned by GET NFT Assets in the id field.
  • This parameter is required unless you get an asset by contract address and token ID (query parameters).

Query Parameters

Required Parameters

To get an asset by contract address and token ID, use the following parameters:

1. contract address:

  • parameter: contract_address
  • value: e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D

2. token ID:

  • parameter: token_id
  • value: e.g. 9999

Note: These parameters are required unless you get an asset by unique ID (path parameter).

Additional Parameters

To show or hide wallets, use:

  • parameter: show_wallets
  • value: true / false (default)

Example Queries

The queries in this section provide useful examples for GET NFT Asset.

For more details, visit:

Get an Asset by Unique ID

To get an asset in the Ethereum Mainnet network by unique asset ID, use the following query:

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

Get an Asset by Contract Address and Token ID

To get an asset in the Ethereum Mainnet network by contract address and token ID, use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/asset?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&token_id=9999

Get an Asset with a List of Wallets

To get an asset in the Ethereum Mainnet network by unique asset ID and display a list of wallets, use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/asset/5e1f4454-34ff-5118-9987-96b481625128?show_wallets=true

To get an asset in the Ethereum Mainnet network by contract address and token ID and display a list of wallets, use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/asset?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&token_id=9999&show_wallets=true

Example Response

The following is a typical response from GET NFT Asset:

{
    "asset": {
        "token_id": "9999",
        "token_type": "ERC721",
        "media": {
            "image_url": "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": [
            {
                "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"
            }
        ],
        "burned": false
    }
}

Notes:

  • To find the NFT owner’s address, see the wallets field. ERC-1155 tokens can be owned by multiple wallets, so this field returns an array. Wallets are displayed only if you use the following query parameter: show_wallets=true.
  • The media.image_url field returns media paths for the top popular collections. Use the following endpoint to retrieve media: GET NFT Media
  • You can refresh the data in the media, description, and attributes sections by using the following endpoint: POST Refresh NFT Token

We don't support Internet Explorer

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