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 Numbers Search 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"
}