Get all multi-chain NFTs by account

This endpoint returns all multi-chain NFTs owned by an account address. And the NFTs are grouped according to contract address.

API Endpoint

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

method_path:/api/v2/assets/chain/{account_address}/{chain_name}

method_type:GET

Request:

Parameters	Descriptions	Query Type	Required	Data Type
account_address	The address of the owner of the assets defaultValue{0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813}	path	true	string
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
chain	The abbreviation of the blockchain. Using ';' to separate multiple blockchainsdefaultValue{eth;bnb}	query	true	string
erc_type	option{null,erc721,erc1155}	query	false	string

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	ChainCollectionAssetModel
chain	The short name of chain	string
collection_assets	List of Collection Asset Model	array	CollectionAssetModel
assets	List of Asset Model	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
contract_address	The contract address	string
contract_name	The name of the contract	string
description	The description	string
floor_price	The floor price of the collection	number
items_total	How many items for the collection	integer
logo_url	The logo URL	string
owns_total	How many items the account address owns	integer
symbol	The symbol	string
msg	Error message when request fails	string

Example:

{
	"code": 200,
	"data": [
		{
			"chain": "eth",
			"collection_assets": [
				{
					"assets": [
						{
							"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"
						}
					],
					"contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
					"contract_name": "BoredApeYachtClub",
					"description": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit www.BoredApeYachtClub.com for more details.",
					"floor_price": 1.113,
					"items_total": 10000,
					"logo_url": "https://logo.nftscan.com/logo/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.png",
					"owns_total": 2,
					"symbol": "BAYC"
				}
			]
		}
	],
	"msg": ""
}