API Endpoint

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

method_path:/api/v2/assets/batch/{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
List for pair of contract_address and token ID	List for pair of contract_address and token ID	body	true	List for pair of contract_address and token ID	List for pair of contract_address and token ID
contract_address_with_token_id_list	List of contract address with token ID. Maximum size is 50.		true	array	Pair of contract_address and token ID
contract_address	The contract address		true	string
token_id	The token ID		true	string
show_attribute	Whether to obtain attributes for the assets option		false	boolean

Request Example:

{
  "contract_address_with_token_id_list": [
    {
      "contract_address": "0x3e855b7941fe8ef5f07dad68c5140d6a3ec1b286",
      "token_id": "0x000000000000000000000000000000000000000000000000000000000000013a"
    }
  ],
  "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	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(double)
latest_trade_symbol	The latest trade symbol for the item	string
latest_trade_timestamp	The latest trade timestamp in milliseconds for the item	integer(int64)
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(double)
mint_timestamp	The timestamp in milliseconds when the item was minted	integer(int64)
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(int64)
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(int32)
rarity_score	The rarity score for the item	number(double)
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
msg	Error message when request fails	string

Example:

{
	"code": 200,
	"data": [
		{
			"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"
		}
	],
	"msg": ""
}