NFT Search

The NFT Search API enables developers to retrieve the NFT tokens that have been minted for a specific digital asset. The API takes the Nid of the asset as input and returns the cross-network NFT records for that asset. If you are unaware of the Nid of the file, the Asset Search API can be used to find similar assets, or use the [IPFS] Get Nid endpoint to retrieve the Nid of your asset.

Capture Token is required for API authorization. If you do not already have a Capture Token yet, please follow the instruction provided to create one.

The Numbers API is a pay-as-you-go system, which means you only pay for the API calls you make. This is a cost-effective way to use the API and it allows you to control your expenses. Make sure to top up and ensure sufficient funds in your wallet in the form of Credits or NUM to cover the cost. Payment for services is processed using NUM; if you want to know how much it costs in USD, you can check CoinGecko or CoinMarketCap.

API Endpoint: https://eoprdbpm6gbec9w.m.pipedream.net

Cost: 0.01 NUM + Gas (~0.004 NUM per transaction) per API call. No Gas is required if paid with Credits.

Method: GET
Endpoint: /?nid=NID_TO_SEARCH

Description:
This API endpoint finds the NFT records associated to the provided Nid.

Authentication:
This API requires a valid token for Authorization. The token should be passed in the headers of the request using the following format: "Authorization: token YOUR_CAPTURE_TOKEN"

Headers:
- Content-Type: application/json
- Authorization: token YOUR_CAPTURE_TOKEN

Examples:
curl -X GET -H "Content-Type: application/json" \
            -H "Authorization: token YOUR_CAPTURE_TOKEN" \
            https://eoprdbpm6gbec9w.m.pipedream.net?nid=NID_TO_SEARCH

Response:
{
  "nftRecords": list_of_NFT_records,
  "nid": input_asset,
  "orderID": id_of_this_order
}

A detailed explanation of the Nid can be found on the Numbers ID (Nid) page. In this example, you would replace YOUR_CAPTURE_TOKEN with your actual Capture token and NID_TO_SEARCH with the Nid of the metadata you want to cat. More examples can be found below:

Read nftRecords

Description

chain_id

The ID of the NFT blockchain

contract

The contract address of the NFT token

token_id

The ID of the NFT token

asset_cids

A list of assets associated with this token

primary_marketplace

The primary marketplace of this token

current_owner

The current_owner of this NFT token

nft_spec

The spec of the NFT metadata

creator

The minter of the NFT token

created_at

The earliest of initial minting time of the NFT or the initial commit time of the digital media file in the Numbers Protocol

metadata

The metadata of this NFT token

animation_url

The animationURL associatedwith this token

image_url

The original URL of the image field of the NFT token

token_uri

The token URI of the NFT token

Support Status

Please visit the Support Status of Verify Engine to check the currently supported file formats and blockchain networks.

Sample search results

{
  "nftRecords": [
    {
      "chain_id": 1,
      "contract": "0xed5af388653567af2f388e6224dc7c4b3241c544",
      "asset_cids": [],
      "primary_marketplace": "opensea",
      "current_owner": "0x5a8cfbdb26e7429e4920668412347e0da368c5ec",
      "nft_spec": "ERC721",
      "creator": "0xab06f95ad1ac282f7072b4b849259eabc49eb5ba",
      "created_at": "2022-01-13T02:00:38",
      "metadata": {
        "name": "Azuki #982",
        "image": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/982.png",
        "attributes": [
          {
            "trait_type": "Type",
            "value": "Human"
          },
          {
            "trait_type": "Hair",
            "value": "Brown Long"
          }
        ]
      },
      "token_id": "982",
      "image_url": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/982.png",
      "animation_url": null,
      "token_uri": "https://dweb.link/ipfs/QmQFkLSQysj94s5GvTHPyzTxrawwtjgiiYS2TBLgrvw8CW/982"
    },
    {
      "chain_id": 1,
      "contract": "0x0bc040c6f7440b7b2378d4296005aff3eba81511",
      "asset_cids": [
        "bafybeiepger65zllufxocswogj2h3bmnb2vbcekuzhbavbex2edvdzjwja"
      ],
      "primary_marketplace": "opensea",
      "current_owner": "0xdf940f640799ccdfa74d7fc7bd72c1aebd89dc98",
      "nft_spec": "erc721",
      "creator": "0xdf940f640799ccdfa74d7fc7bd72c1aebd89dc98",
      "created_at": "2022-04-04T04:47:26",
      "metadata": {
        "name": "Azuki #982",
        "image": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/982.png",
        "attributes": [
          {
            "trait_type": "Type",
            "value": "Human"
          },
          {
            "trait_type": "Hair",
            "value": "Brown Long"
          }
        ]
      },
      "token_id": "981",
      "image_url": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/982.png",
      "animation_url": null,
      "token_uri": "https://dweb.link/ipfs/QmQFkLSQysj94s5GvTHPyzTxrawwtjgiiYS2TBLgrvw8CW/982"
    }
  ],
  "nid": "bafybeiepger65zllufxocswogj2h3bmnb2vbcekuzhbavbex2edvdzjwja",
  "orderID": "b3b246a7-6266-4bd7-b8c4-c241b47cc6e5"
}

Last updated