get https://api.openpool.co/wallet/nft_balance/
This endpoint returns Current NFT Balances, Cost and Floor Price for one or multiple wallets. NFT Floor Price is from Opensea or LooksRare. Use this endpoint to create NFT analytics or track NFT performance.
- Multiple Addresses - NFT Balances & Performance can be returned for a single wallet or multiple wallets. For multiple wallets, the aggregated Cost Basis and Floor Price for the group of wallets queried will be returned in addition to Cost and Floor Price for each individual NFT.
- Cost Basis - The NFT Cost Basis includes any gas fees paid in the minting process. Or, if the NFT was obtained via a Swap, the Cost Basis reflects the token value exchanged for the NFT at the time of purchase, inclusive of gas fees paid in the swap transaction.
- Floor Price - For Floor Price, OpenPool looks across both Opensea and LooksRare. To be conservative, if an NFT is listed on both marketplaces, OpenPool returns the lower Floor Price.
- Currency - NFT cost and floor price data will be returned in both native cryptocurrency and in USD.
Successful Query Example
Single Wallet
curl --request GET \
--url 'https://api.openpool.co/wallet/nft_balance/?wallet=0x59a5493513ba2378ed57ae5ecfb8a027e9d80365' \
--header 'X-API-KEY: <insert_api_key>' \
--header 'accept: application/json'
Multiple Wallets
curl --request GET \
--url 'https://api.openpool.co/wallet/nft_balance/?wallet=0x59a5493513ba2378ed57ae5ecfb8a027e9d80365%2C0x3b3525f60eeea4a1ef554df5425912c2a532875d' \
--header 'X-API-KEY: <insert_api_key>' \
--header 'accept: application/json'
Successful Response Example
{
"count": 100,
"next": null,
"previous": null,
"results": {
"data": [
{
"id": 15227698,
"balance": 1,
"cost": {
"value": "0.16",
"currency": "ETH",
"fiat": "419.99",
"fiat_currency": "USD"
},
"floor": {
"value": 0.0377,
"currency": "ETH",
"fiat": 69.589299,
"fiat_currency": "USD"
},
"nft": {
"id": 94,
"collection": {
"floor": [
{
"venue": {
"id": 1,
"name": "openSea",
"image_url": "https://storage.googleapis.com/opensea-static/Logomark/Logomark-Blue.png"
},
"floor": "0.03770000",
"currency": "ETH",
"timestamp": "2023-04-03T01:50:46.593000Z"
}
],
"blockchain": {
"id": 12,
"name": "Ethereum",
"slug": "ethereum",
"image_url": "https://openpool.s3.amazonaws.com/landingImages/eth.png"
},
"address": "0x25ed58c027921e14d86380ea2646e3a1b5c55a8b",
"name": "Devs for Revolution",
"symbol": "DEVS",
"description": "Devs for Revolution grants token holders official Developer DAO membership.\n\nhttps://developerdao.notion.site/Getting-Started-with-Developer-DAO-2bddd332c51a4957b0b83f60f9fa4ebe",
"image_url": "https://i.seadn.io/gae/6Jbode0t_bTO9MHYoYvjIW9nHENCxOs40EGg3Z5ptg4lLlD2z2WXEAIrjyV929aQnIi94hPL4VZ3Pl2NWOO_tSaO6gdjdrcMHrF9?w=500&auto=format",
"opensea_status": null,
"is_spam": false
},
"token_id": "1223",
"name": "Dev #1223",
"image": "https://openseauserdata.com/files/69acdb304a8ab5038eff1c0f29c9af0b.svg",
"preview": "https://openseauserdata.com/files/69acdb304a8ab5038eff1c0f29c9af0b.svg",
"thumbnail": "https://openseauserdata.com/files/69acdb304a8ab5038eff1c0f29c9af0b.svg",
"original": null,
"animation_image": null,
"animation_original": null,
"description": "Developers around the world are tired of working and contributing their time and effort to enrich the top 1%. Join the movement that is community owned, building the future from the bottom up.",
"external_url": null
},
"wallet": "0x9c21a04468e028f9b7215392bbe5171f634bc76a"
},
...
],
"summary": {
"total_value": 106.4800630959,
"total_cost": 708.1395942600001,
"count": 100
}
}
}