Get NFTs by attributes

API Endpoint

https://open-platform.nodereal.io/{apiKey}/nftscan

method_path:/api/v2/assets/attributes/{chain_name}

method_type:POST

Request:

Parameters	Descriptions	Query Type	Required	Data Type	schema
chain_name	Name of the chain you’re querying. List of supported values: "eth" for Ethereum; "bnb" for BNB Smart Chain; "polygon" for Polygon; "moonbeam" for Moonbeam; "arbitrum" for Arbitrum One; "optimism" for Optimism; "platon" for PlatON; "avalanche" for Avalanche; "cronos" for Cronos; "fantom" for Fantom; "gnosis" for Gnosis;	path	true
NftAssetByAttributesReq	NftAssetByAttributesReq	body	true	NftAssetByAttributesReq	NftAssetByAttributesReq
attributes	List of attribute name with attribute value(s). Maximum size is 10		true	array	Pair of attribute_name and attribute_value(s)
attribute_name	The name of the attribute		false	string
attribute_values	The value(s) for the attribute name		false	array	string
contract_address	The contract addressdefaultValue{0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d}		true	string
cursor	A cursor to retrieve the next page		false	string
limit	Page size. Defaults to 20, capped at 100		false	integer(int32)
show_attribute	Whether to obtain attributes for the assets option{false,true}		false	boolean

Request Example:

{
  "attributes": [
    {
      "attribute_name": "Fur",
      "attribute_values": "Black,Blue"
    }
  ],
  "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "cursor": "100",
  "limit": 20,
  "show_attribute": false
}

Response:

Parameters	Descriptions	Data Type	schema
code	Response status code (200 means the request was successful, 4XX or 5XX means the request failed)	integer(int32)	integer(int32)
data	Response data
content	The data content	array	AssetModel
amount	The amount of the NFT	string
attributes	List of attributes	array	AssetAttributeValueModel
attribute_name	The attribute name	string
attribute_value	The value for the attribute name	string
percentage	How many items have this attribute value	string
content_type	The content type	string
content_uri	The content URI to display	string
contract_address	The contract address	string
contract_name	The name of the contract	string
contract_token_id	The token ID of the NFT in Hex	string
description	The description to display	string
erc_type	The erc type of the NFT	string
external_link	External link to the original website	string
image_uri	The image URI to display	string
latest_trade_price	The latest trade price for the item	number
latest_trade_symbol	The latest trade symbol for the item	string
latest_trade_timestamp	The latest trade timestamp in milliseconds for the item	integer
latest_trade_token	The latest trade token for the item	string
metadata_json	The metadata in JSON format	string
mint_price	The price when the item was minted (null if the item is an ERC-1155 NFT)	number
mint_timestamp	The timestamp in milliseconds when the item was minted	integer
mint_transaction_hash	The transaction hash when the item was minted	string
minter	The user address who minted the item	string
name	The name	string
nftscan_id	The unique ID generated for the item by NFTScan	string
nftscan_uri	The image URI stored by NFTScan (null if not stored by NFTScan)	string
own_timestamp	The timestamp in milliseconds when the item was owned (null if the item is an ERC-1155 NFT)	integer
owner	The user address who owns the item now (null if the item is an ERC-1155 NFT)	string
rarity_rank	The rarity rank for the item	integer
rarity_score	The rarity score for the item	number
small_nftscan_uri	The small image URI stored by NFTScan (null if not stored by NFTScan)	string
token_id	The token ID of the NFT in Number	string
token_uri	The token URI	string
next	The next cursor to be supplied as a query param to retrieve the next page	string
total	The total of the results matching the query	integer(int64)
msg	Error message when request fails	string

Example:

{
	"code": 200,
	"data": {
		"content": [
			{
				"amount": "1",
				"attributes": [
					{
						"attribute_name": "Background",
						"attribute_value": "Yellow",
						"percentage": "16.49%"
					}
				],
				"content_type": "image/png",
				"content_uri": "QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi",
				"contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
				"contract_name": "BoredApeYachtClub",
				"contract_token_id": "0x0000000000000000000000000000000000000000000000000000000000000001",
				"description": "",
				"erc_type": "erc721",
				"external_link": "",
				"image_uri": "QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi",
				"latest_trade_price": 38.77,
				"latest_trade_symbol": "WETH",
				"latest_trade_timestamp": 1652567645000,
				"latest_trade_token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
				"metadata_json": "{\"image\":\"ipfs://QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi\",\"attributes\":[{\"trait_type\":\"Mouth\",\"value\":\"Grin\"},{\"trait_type\":\"Clothes\",\"value\":\"Vietnam Jacket\"},{\"trait_type\":\"Background\",\"value\":\"Orange\"},{\"trait_type\":\"Eyes\",\"value\":\"Blue Beams\"},{\"trait_type\":\"Fur\",\"value\":\"Robot\"}]}",
				"mint_price": 0.7,
				"mint_timestamp": 1619133220000,
				"mint_transaction_hash": "0xcfb197f62ec5c7f0e71a11ec0c4a0e394a3aa41db5386e85526f86c84b3f2796",
				"minter": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
				"name": "#1",
				"nftscan_id": "NSB313FC3396961075",
				"nftscan_uri": "https://dm2zb8bwza29x.cloudfront.net/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d/0x0000000000000000000000000000000000000000000000000000000000000001.png",
				"own_timestamp": 1619817106000,
				"owner": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
				"rarity_rank": 2668,
				"rarity_score": 1.06,
				"small_nftscan_uri": "https://d3v0kmlgfpwg7s.cloudfront.net/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d/0x0000000000000000000000000000000000000000000000000000000000000001.png",
				"token_id": "1",
				"token_uri": "https://dweb.link/ipfs/QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/1"
			}
		],
		"next": "NS871DD6359B64187E",
		"total": 30000
	},
	"msg": ""
}