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:Text | 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 |
Please visit the Support Status of Numbers Search Engine to check the currently supported file formats and blockchain networks.
{
"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 modified 5d ago