This endpoint returns all 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/account/own/all/{account_address}/{chain_name}
method_type:GET
Request:
| Parameters | Descriptions | Query Type | Required | Data Type | schema |
|---|---|---|---|---|---|
| account_address | The address of the owner of the assets, defaultValue{0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813} | path | true | string | |
| hain_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 | ||
| erc_type | option{,erc721,erc1155} | query | false | string | |
| show_attribute | Whether to obtain attributes for the assets option{{{false,true}}} | query | false | boolean |
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 | 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(double) | |
| items_total | How many items for the collection | integer(int64) | |
| logo_url | The logo URL | string | |
| owns_total | How many items the account address owns | integer(int32) | |
| symbol | The symbol | string | |
| msg | Error message when request fails | string |
Example:
{
"code": 200,
"data": [
{
"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": ""
}