# Introduction ## This document is deprecated! Please access new API docs with following link! ## NFTBank NFTBank is the go-to NFT portfolio manager powered by a powerful ML model for NFT price appraisals. Our price estimates provides users with the most accurate net worth snapshot of their portfolio, with an unparalleled coverage of 1,800 projects and counting. We are building with many partners to enable the NFT financialization, as accurate NFT price feed serves as the backbone of building financial derivates on top of NFTs. See our list of [Featured Partners.](https://docs.nftbank.ai/featured-partners) ## More on Our Price Estimates Our ML model begins with analyzing NFT metadata traits and sales history. As the model matured, we have developed methodologies to most accurately predict individual assets such as applying different weighting to trait values, categories, groupings of trait values, time of sales and more. We are also continuously developing our model to catch edge cases such as wash trading. Still, our model may work better with certain collections, especially with those with rich past sales data and low volatility. Please refer to our [Price Estimate Performance Dashboard](https://docs.nftbank.ai/nft-price-valuation/price-estimate-performance-dashboard) to see our model at work and its accuracy! Here's an[ in depth review](https://medium.com/nftbank-ai/how-to-value-items-in-nft-projects-part-1-a87be8bcb21d) of our model that you can check out too. ## How to Get Started At this time, you need an API key to interact with the NFTBank Price APIs. **We do not charge you any fees for our API**, but different rate limits will be applied depending on use case. If you would like to request a key, please fill out [this form](https://nftbank.typeform.com/to/iZaK3tjj?typeform-source=docs.nftbank.ai). Our team will review the request and be in contact with you shortly. ## Feedback We value user feedback very highly at NFTBank. You can chat with us through telegram, discord or email on any bugs, feedback or observations you might have. Join us in our [Discord](http://discord.gg/wj5VwCk6vr). Our team is very responsive! # Featured Partners Explore how other teams use NFTBank API to pioneer NFT financialisation. ## Wemeta Wemeta is an NFT market specializing in Metaverse lands. NFTBank price API powers land price estimates shown in the UI coupled with other land analytics to allow users to evaluate land value more thoroughly. ![](/files/xinahcAfm9tTqIcbSCmr) ## Parcel Parcel is a vertical NFT market optimized for virtual real estate. NFTBank price API powers real time land appraisal displayed on purchase UI to allow users to make better investment decisions. ![](/files/rv3OXntU69mI44e6Niuw) ## NFTfi NFTfi is a leading P2P NFT collateralized loan platform with over 100mln USD in cumulative loan volume. NFTBank price estimates will be integrated to NFTfi V2, where lenders will be able to see price estimate valuation to accurately gauge collateral value before offering loan amount. ## Pine Protocol Pine Protocol is a decentralised NFT backed borrowing and lending protocol with market innovations such as Pine Now Pine Later, which allows purchasing of NFTs with a loan similar to mortgage. NFTBank price APIs will help assess collateral value of NFT assets on Pine Protocol for users to make smarter investment decisions. ## Pawnfi Pawnfi is a decentralised liquidity protocol for non standards assets such as NFTs and LP tokens. NFTBank price APIs will allow Pawnfi users to recognize the prices of their digital assets in a fair range ## Gringotts DAO Gringotts DAO is a liquidity provider specializing in NFT backed lending. NFTBank price estimate API allows accurate appraisal of collateral value, which allows Gringotts DAO to make better assessment of collateral value and target loan investments. ## And much more... There are many more partners building with us right now\... Soon # Disclaimer Use the data at your own discretion! NFTBank is NOT liable to API users under any theory for any damages suffered by any user of the API or for any special, incidental, indirect, consequential, or similar damages (including, but not limited to damages for loss of profits or confidential or other information, for business interruption, for personal injury, for loss of privacy, for failure to meet any duty including of good faith or of reasonable care, for negligence, and for any other pecuniary or other loss whatsoever) arising out of the use or inability to use the API, or the provision of or failure to provide support services, even if NFTBank has been advised of the possibility of such damages, and regardless of the legal or equitable theory (contract, tort or otherwise) upon which the claim is based. # Historical Valuation API * [/v3/estimated-price](/nft-valuation-api/historical-valuation-api/v3-estimated-price) * [/v3/floor-price](/nft-valuation-api/historical-valuation-api/v3-floor-price) Ready to test out how powerful our appraisals are? 💪 After getting access to API keys using [this form](https://nftbank.typeform.com/to/iZaK3tjj?typeform-source=docs.nftbank.ai), use the API commands in [API overview](https://docs.nftbank.ai/nft-valuation-api/supported-collections) to fetch data. Make sure to check the list of [Supported Collections](https://docs.nftbank.ai/nft-valuation-api/supported-collections) before fetching data and use the contract address listed on the table. If you want to see just how accurate our Price Estimates are, check out our [Price Estimate Performance Dashboard](https://docs.nftbank.ai/nft-valuation-api/price-estimate-performance-dashboard). # /v3/estimated-price ## Get historical daily estimated price `GET` `https://api.nftbank.ai/v3/estimated-price/:network_id/:asset_contract/:token_id` This endpoint allows you to get historical estimated prices. #### Path Parameters | Name | Type | Description | | ------------------------------------------------- | ------ | ----------------------------------------- | | network\_id\* | String | ethereum / matic | | asset\_contract\* | String | The asset contract address of NFT project | | token\_id\* | String | The token ID of the NFT project | #### Query Parameters | Name | Type | Description | | ----------- | ------ | ----------------------- | | start\_date | String | for example: 2022-06-01 | | end\_date | String | for example: 2022-06-05 | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 Cake successfully retrieved." %} ``` { "data": [ { "estimatedPriceEth": "245.106694977666961677", "processedAt": "2022-05-20T00:00:00+00:00" }, { "estimatedPriceEth": "240.758202712365289244", "processedAt": "2022-05-21T00:00:00+00:00" }, { "estimatedPriceEth": "260.739795352682165230", "processedAt": "2022-05-22T00:00:00+00:00" }, { "estimatedPriceEth": "230.379640625894410277", "processedAt": "2022-05-23T00:00:00+00:00" }, { "estimatedPriceEth": "242.542209145351534971", "processedAt": "2022-05-24T00:00:00+00:00" }, { "estimatedPriceEth": "257.419635935314431663", "processedAt": "2022-05-25T00:00:00+00:00" }, { "estimatedPriceEth": "269.927952984344813103", "processedAt": "2022-05-26T00:00:00+00:00" }, { "estimatedPriceEth": "249.029326737429840932", "processedAt": "2022-05-27T00:00:00+00:00" }, { "estimatedPriceEth": "257.153830965227541583", "processedAt": "2022-05-28T00:00:00+00:00" }, { "estimatedPriceEth": "248.596109566667934132", "processedAt": "2022-05-29T00:00:00+00:00" }, { "estimatedPriceEth": "245.547200409165270685", "processedAt": "2022-05-30T00:00:00+00:00" }, { "estimatedPriceEth": "296.743321608524240673", "processedAt": "2022-05-31T00:00:00+00:00" }, { "estimatedPriceEth": "269.802803916100003789", "processedAt": "2022-06-01T00:00:00+00:00" }, { "estimatedPriceEth": "160.904689432328410703", "processedAt": "2022-06-02T00:00:00+00:00" }, { "estimatedPriceEth": "163.086414470856908565", "processedAt": "2022-06-03T00:00:00+00:00" }, { "estimatedPriceEth": "161.931107117959982133", "processedAt": "2022-06-04T00:00:00+00:00" }, { "estimatedPriceEth": "161.983744216539093941", "processedAt": "2022-06-05T00:00:00+00:00" }, { "estimatedPriceEth": "157.443260938765121182", "processedAt": "2022-06-06T00:00:00+00:00" }, { "estimatedPriceEth": "170.237530351220812008", "processedAt": "2022-06-07T00:00:00+00:00" } ], "message": "OK", "statusCode": 20000 } ``` {% endtab %} {% endtabs %} **curl request example** ```bash curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/v3/estimated-price/ethereum/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/1?start_date=2022-05-20&end_date=2022-06-07" ``` **curl response example** ```json { "data": [ { "estimatedPriceEth": "245.106694977666961677", "processedAt": "2022-05-20T00:00:00+00:00" }, { "estimatedPriceEth": "240.758202712365289244", "processedAt": "2022-05-21T00:00:00+00:00" }, { "estimatedPriceEth": "260.739795352682165230", "processedAt": "2022-05-22T00:00:00+00:00" }, { "estimatedPriceEth": "230.379640625894410277", "processedAt": "2022-05-23T00:00:00+00:00" }, { "estimatedPriceEth": "242.542209145351534971", "processedAt": "2022-05-24T00:00:00+00:00" }, { "estimatedPriceEth": "257.419635935314431663", "processedAt": "2022-05-25T00:00:00+00:00" }, { "estimatedPriceEth": "269.927952984344813103", "processedAt": "2022-05-26T00:00:00+00:00" }, { "estimatedPriceEth": "249.029326737429840932", "processedAt": "2022-05-27T00:00:00+00:00" }, { "estimatedPriceEth": "257.153830965227541583", "processedAt": "2022-05-28T00:00:00+00:00" }, { "estimatedPriceEth": "248.596109566667934132", "processedAt": "2022-05-29T00:00:00+00:00" }, { "estimatedPriceEth": "245.547200409165270685", "processedAt": "2022-05-30T00:00:00+00:00" }, { "estimatedPriceEth": "296.743321608524240673", "processedAt": "2022-05-31T00:00:00+00:00" }, { "estimatedPriceEth": "269.802803916100003789", "processedAt": "2022-06-01T00:00:00+00:00" }, { "estimatedPriceEth": "160.904689432328410703", "processedAt": "2022-06-02T00:00:00+00:00" }, { "estimatedPriceEth": "163.086414470856908565", "processedAt": "2022-06-03T00:00:00+00:00" }, { "estimatedPriceEth": "161.931107117959982133", "processedAt": "2022-06-04T00:00:00+00:00" }, { "estimatedPriceEth": "161.983744216539093941", "processedAt": "2022-06-05T00:00:00+00:00" }, { "estimatedPriceEth": "157.443260938765121182", "processedAt": "2022-06-06T00:00:00+00:00" }, { "estimatedPriceEth": "170.237530351220812008", "processedAt": "2022-06-07T00:00:00+00:00" } ], "message": "OK", "statusCode": 20000 } ``` # /v3/floor-price ## Get historical daily floor price `GET` `https://api.nftbank.ai/v3/floor-price/:network_id/:asset_contract` This endpoint allows you to get daily historical floor prices. #### Path Parameters | Name | Type | Description | | ------------------------------------------------- | ------ | ----------------------------------- | | network\_id\* | String | ethereum / matic | | asset\_contract\* | String | The contract address of NFT project | #### Query Parameters | Name | Type | Description | | ----------- | ------ | ----------------------- | | start\_date | String | for example: 2022-06-01 | | end\_date | String | for example: 2022-06-05 | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 Cake successfully retrieved." %} ``` { "data": [ { "floorPriceEth": "94.989999999999994884", "processedAt": "2022-06-01T00:00:00+00:00" }, { "floorPriceEth": "92.599999999999994316", "processedAt": "2022-06-02T00:00:00+00:00" }, { "floorPriceEth": "94.689999999999997726", "processedAt": "2022-06-03T00:00:00+00:00" }, { "floorPriceEth": "94.689999999999997726", "processedAt": "2022-06-04T00:00:00+00:00" }, { "floorPriceEth": "96.000000000000000000", "processedAt": "2022-06-05T00:00:00+00:00" } ], "message": "OK", "statusCode": 20000 } ``` {% endtab %} {% endtabs %} **curl request example** ```bash curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/v3/floor-price/ethereum/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D?start_date=2022-06-01&end_date=2022-06-05" ``` **curl response example** ```json { "data": [ { "floorPriceEth": "94.989999999999994884", "processedAt": "2022-06-01T00:00:00+00:00" }, { "floorPriceEth": "92.599999999999994316", "processedAt": "2022-06-02T00:00:00+00:00" }, { "floorPriceEth": "94.689999999999997726", "processedAt": "2022-06-03T00:00:00+00:00" }, { "floorPriceEth": "94.689999999999997726", "processedAt": "2022-06-04T00:00:00+00:00" }, { "floorPriceEth": "96.000000000000000000", "processedAt": "2022-06-05T00:00:00+00:00" } ], "message": "OK", "statusCode": 20000 } ``` # Realtime Valuation API * [/v3/realtime-estimated-price](/nft-valuation-api/realtime-valuation-api/v3-realtime-estimated-price) * [/v3/realtime-floor-price](/nft-valuation-api/realtime-valuation-api/v3-realtime-floor-price) Ready to test out how powerful our appraisals are? 💪 After getting access to API keys using [this form](https://nftbank.typeform.com/to/iZaK3tjj?typeform-source=docs.nftbank.ai), use the API commands in [API overview](https://docs.nftbank.ai/nft-valuation-api/supported-collections) to fetch data. Make sure to check the list of [Supported Collections](https://docs.nftbank.ai/nft-valuation-api/supported-collections) before fetching data and use the contract address listed on the table. If you want to see just how accurate our Price Estimates are, check out our [Price Estimate Performance Dashboard](https://docs.nftbank.ai/nft-valuation-api/price-estimate-performance-dashboard). # /v3/realtime-estimated-price ## Get realtime estimated price & floor price `GET` `https://api.nftbank.ai/v3/realtime-estimated-price` This endpoint allows you to get estimated price and floor price in realtime. #### Path Parameters | Name | Type | Description | | ------------------------------------------------- | ------ | ------------------------------------- | | network\_id\* | String | ethereum / matic | | asset\_contract\* | String | The contract address of a NFT project | | token\_id\* | String | The token ID of a NFT project | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 Cake successfully retrieved." %} ``` { "data": { "assetContract": "0x8a90cab2b38dba80c64b7734e58ee1db38b8992e", "collectionId": "doodles", "dailyEstimatedPriceEth": "14.886014055200000000", "estimatedPriceEth": "13.578077718700000000", "floorPriceEth": "12.500000000000000000", "networkId": "ethereum", "openseaSlug": "doodles-official", "processedAt": "2022-06-28T06:04:00+00:00", "tokenId": "1" }, "message": "OK", "statusCode": 20000 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/v3/realtime-estimated-price/ethereum/0x8a90cab2b38dba80c64b7734e58ee1db38b8992e/2795" ``` **curl response example** ```json { "data": { "assetContract": "0x8a90cab2b38dba80c64b7734e58ee1db38b8992e", "collectionId": "doodles", "dailyEstimatedPriceEth": "14.886014055200000000", "estimatedPriceEth": "13.578077718700000000", "floorPriceEth": "12.500000000000000000", "networkId": "ethereum", "openseaSlug": "doodles-official", "processedAt": "2022-06-28T06:04:00+00:00", "tokenId": "1" }, "message": "OK", "statusCode": 20000 } ``` # /v3/realtime-floor-price ## Get realtime floor price `GET` `https://api.nftbank.ai/v3/realtime-floor-price` This endpoint allows you to get floor price in realtime. #### Path Parameters | Name | Type | Description | | ------------------------------------------------- | ------ | ------------------------------------- | | network\_id\* | String | ethereum / matic | | asset\_contract\* | String | The contract address of a NFT project | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 Cake successfully retrieved." %} ``` { "data": { "assetContract": "0x8a90cab2b38dba80c64b7734e58ee1db38b8992e", "collectionId": "doodles", "floorPriceEth": "12.500000000000000000", "networkId": "ethereum", "openseaSlug": "doodles-official", "processedAt": "2022-06-28T05:59:00+00:00" }, "message": "OK", "statusCode": 20000 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/v3/realtime-floor-price/ethereum/0x8a90cab2b38dba80c64b7734e58ee1db38b8992e" ``` **curl response example** ```json { "data": { "assetContract": "0x8a90cab2b38dba80c64b7734e58ee1db38b8992e", "collectionId": "doodles", "floorPriceEth": "12.500000000000000000", "networkId": "ethereum", "openseaSlug": "doodles-official", "processedAt": "2022-06-28T05:59:00+00:00" }, "message": "OK", "statusCode": 20000 } ``` # Estimated Price Endpoints * [/dapp/list](/nft-valuation-api-1/nft-price-valuation/dapp-list) * [/dapp/:dapp\_id](/nft-valuation-api-1/nft-price-valuation/dapp-dapp_id) * [/estimates/:asset\_contract/:token\_id](/nft-valuation-api-1/nft-price-valuation/estimates-asset_contract-token_id) * [/estimates/bulk](/nft-valuation-api-1/nft-price-valuation/estimates-bulk) Ready to test out how powerful our appraisals are? 💪 After getting access to API keys using [this form](https://nftbank.typeform.com/to/iZaK3tjj?typeform-source=docs.nftbank.ai), use the API commands in [API overview](https://docs.nftbank.ai/nft-valuation-api/supported-collections) to fetch data. Make sure to check the list of [Supported Collections](https://docs.nftbank.ai/nft-valuation-api/supported-collections) before fetching data and use the contract address listed on the table. If you want to see just how accurate our Price Estimates are, check out our [Price Estimate Performance Dashboard](https://docs.nftbank.ai/nft-valuation-api/price-estimate-performance-dashboard). # /dapp/list ## Get available dapp list `GET` `https://api.nftbank.ai/estimates-v2/dapp/list` This endpoint allows you to get available dapp list. #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 Cake successfully retrieved." %} ``` { "data": [ { "_id": "ethereum-0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "asset_contract": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "asset_info": { "contract_address": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "sandbox", "image_url": "https://lh3.googleusercontent.com/SXH8tW1siikB80rwCRnjm1a5xM_MwTg9Xl9Db6mioIk9HIlDM09pVoSR7GKJgS6ulSUpgW9BDtMk_ePX_NKgO9A=s60", "name": "The Sandbox" }, "max_estimated_at": "Mon, 1 Jan 1970 00:00:00 GMT", "native_token_info": { "token_address": "0x3845badAde8e6dFF049820680d1F14bD3903a5d0", "token_symbol": "SAND" } }, { "_id": "ethereum-0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "asset_contract": "0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "asset_info": { "contract_address": "0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "decentraland", "image_url": "https://lh3.googleusercontent.com/5KIxEGmnAiL5psnMCSLPlfSxDxfRSk4sTQRSyhPdgnu70nGb2YsuVxTmO2iKEkOZOfq476Bl1hAu6aJIKjs1myY=s60", "name": "Decentraland" }, "max_estimated_at": "Mon, 1 Jan 1970 00:00:00 GMT", "native_token_info": { "token_address": "0x0f5d2fb29fb7d3cfee444a200298f468908cc942", "token_symbol": "MANA" } } ], "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" "https://api.nftbank.ai/estimates-v2/dapp/list" ``` **curl response example** ```json { "data": [ { "_id": "ethereum-0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "asset_contract": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "asset_info": { "contract_address": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "sandbox", "image_url": "https://lh3.googleusercontent.com/SXH8tW1siikB80rwCRnjm1a5xM_MwTg9Xl9Db6mioIk9HIlDM09pVoSR7GKJgS6ulSUpgW9BDtMk_ePX_NKgO9A=s60", "name": "The Sandbox" }, "max_estimated_at": "Tue, 08 Feb 2022 00:00:00 GMT", "native_token_info": { "token_address": "0x3845badade8e6dff049820680d1f14bd3903a5d0", "token_symbol": "SAND" } }, { "_id": "ethereum-0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "asset_contract": "0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "asset_info": { "contract_address": "0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "decentraland", "image_url": "https://lh3.googleusercontent.com/5KIxEGmnAiL5psnMCSLPlfSxDxfRSk4sTQRSyhPdgnu70nGb2YsuVxTmO2iKEkOZOfq476Bl1hAu6aJIKjs1myY=s60", "name": "Decentraland" }, "max_estimated_at": "Sat, 09 Apr 2022 00:00:00 GMT", "native_token_info": { "token_address": "0x0f5d2fb29fb7d3cfee444a200298f468908cc942", "token_symbol": "MANA" } } ], "response": 200 } ``` # /dapp/:dapp\_id ## Get dapp info `GET` `https://api.nftbank.ai/estimates-v2/dapp/:dapp_id` This endpoint allows you to get dapp info. #### Path Parameters | Name | Type | Description | | -------- | ------ | ----------- | | dapp\_id | string | Dapp ID | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 " %} ``` { "data": [ { "_id": "ethereum-0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "asset_contract": "0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "asset_info": { "contract_address": "0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "decentraland", "image_url": "https://lh3.googleusercontent.com/5KIxEGmnAiL5psnMCSLPlfSxDxfRSk4sTQRSyhPdgnu70nGb2YsuVxTmO2iKEkOZOfq476Bl1hAu6aJIKjs1myY=s60", "name": "Decentraland" }, "max_estimated_at": "Mon, 1 Jan 1970 00:00:00 GMT", "native_token_info": { "token_address": "0x0f5d2fb29fb7d3cfee444a200298f468908cc942", "token_symbol": "MANA" } } ], "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/estimates-v2/dapp/decentraland" ``` **curl response example** ```json { "data": [ { "_id": "ethereum-0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "asset_contract": "0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "asset_info": { "contract_address": "0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "decentraland", "image_url": "https://lh3.googleusercontent.com/5KIxEGmnAiL5psnMCSLPlfSxDxfRSk4sTQRSyhPdgnu70nGb2YsuVxTmO2iKEkOZOfq476Bl1hAu6aJIKjs1myY=s60", "name": "Decentraland" }, "max_estimated_at": "Wed, 13 Apr 2022 00:00:00 GMT", "native_token_info": { "token_address": "0x0f5d2fb29fb7d3cfee444a200298f468908cc942", "token_symbol": "MANA" } }, { "_id": "ethereum-0x2a187453064356c898cae034eaed119e1663acb8", "asset_contract": "0x2a187453064356c898cae034eaed119e1663acb8", "asset_info": { "contract_address": "0x2a187453064356c898cae034eaed119e1663acb8", "name": "Names", "symbol": "DCLENS" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "decentraland", "image_url": "https://lh3.googleusercontent.com/5KIxEGmnAiL5psnMCSLPlfSxDxfRSk4sTQRSyhPdgnu70nGb2YsuVxTmO2iKEkOZOfq476Bl1hAu6aJIKjs1myY=s60", "name": "Decentraland" }, "max_estimated_at": "Wed, 13 Apr 2022 00:00:00 GMT", "native_token_info": null }, { "_id": "ethereum-0xd35147be6401dcb20811f2104c33de8e97ed6818", "asset_contract": "0xd35147be6401dcb20811f2104c33de8e97ed6818", "asset_info": { "contract_address": "0xd35147be6401dcb20811f2104c33de8e97ed6818", "name": "dcl://dcl_launch", "symbol": "DCLLNCH" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "decentraland", "image_url": "https://lh3.googleusercontent.com/5KIxEGmnAiL5psnMCSLPlfSxDxfRSk4sTQRSyhPdgnu70nGb2YsuVxTmO2iKEkOZOfq476Bl1hAu6aJIKjs1myY=s60", "name": "Decentraland" }, "max_estimated_at": "Sun, 13 Mar 2022 00:00:00 GMT", "native_token_info": null }, { "_id": "ethereum-0x32b7495895264ac9d0b12d32afd435453458b1c6", "asset_contract": "0x32b7495895264ac9d0b12d32afd435453458b1c6", "asset_info": { "contract_address": "0x32b7495895264ac9d0b12d32afd435453458b1c6", "name": "dcl://community_contest", "symbol": "DCLCMMNTCNTST" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "decentraland", "image_url": "https://lh3.googleusercontent.com/5KIxEGmnAiL5psnMCSLPlfSxDxfRSk4sTQRSyhPdgnu70nGb2YsuVxTmO2iKEkOZOfq476Bl1hAu6aJIKjs1myY=s60", "name": "Decentraland" }, "max_estimated_at": "Wed, 13 Apr 2022 00:00:00 GMT", "native_token_info": null } ], "response": 200 } ``` # /estimates/:asset\_contract/:token\_id ## Get estimates `GET` `https://api.nftbank.ai/estimates-v2/estimates/:asset_contract/:token_id` #### Path Parameters | Name | Type | Description | | ------------------------------------------------- | ------ | ---------------------- | | asset\_contract\* | string | Asset contract address | | token\_id\* | string | Token ID | #### Query Parameters | Name | Type | Description | | --------- | ------ | ------------------------------------------------------------- | | chain\_id | string | Chain ID ("ETHEREUM," "MATIC", "KLAYTN", default: "ETHEREUM") | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 " %} ``` {'data': [{'_id': 'ethereum-0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a_110828-20210805', 'asset_contract': '0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a', 'asset_info': {'contract_address': '0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a', 'name': 'Lands', 'symbol': 'LAND'}, 'chain_id': 'ETHEREUM', 'dapp_info': {'id': 'sandbox', 'image_url': 'https://lh3.googleusercontent.com/SXH8tW1siikB80rwCRnjm1a5xM_MwTg9Xl9Db6mioIk9HIlDM09pVoSR7GKJgS6ulSUpgW9BDtMk_ePX_NKgO9A=s60', 'name': 'The Sandbox'}, 'estimate': [{'currency_symbol': 'USD', 'estimate_price': 1489.835075551001}, {'currency_symbol': 'SAND', 'estimate_price': 2283.835248331322}, {'currency_symbol': 'ETH', 'estimate_price': 0.5466964930456125}], 'estimated_at': 'Thu, 05 Aug 2021 00:00:00 GMT', 'item_id': '0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a_110828', 'token_id': '110828', 'traits': {'location_x': 56, 'location_y': 67, 'type': None}}], 'response': 200} ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/estimates-v2/estimates/0xc2c747e0f7004f9e8817db2ca4997657a7746928/1022?chain_id=ETHEREUM" ``` **curl response example** ```json { "data": [ { "_id": "ethereum-0xc2c747e0f7004f9e8817db2ca4997657a7746928_1022-20220413", "asset_contract": "0xc2c747e0f7004f9e8817db2ca4997657a7746928", "asset_info": { "contract_address": "0xc2c747e0f7004f9e8817db2ca4997657a7746928", "name": "Hashmasks", "symbol": "HM" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "hashmask", "image_url": "https://lh3.googleusercontent.com/Mq5O0Kv1gQBxtliiFA9PtgErM2C8zze8kAVD6xN4hlIN21SQXAn7_U3Dh6x3mmBigNOxQLxfujRDPyNzv-akgf2KMUuYOMHH-bnGG8E=s120", "name": "Hashmask" }, "estimate": [ { "currency_symbol": "USD", "estimate_price": 1358.7957577368409 }, { "currency_symbol": "ETH", "estimate_price": 0.44723571321294725 } ], "estimated_at": "Wed, 13 Apr 2022 00:00:00 GMT", "item_id": "0xc2c747e0f7004f9e8817db2ca4997657a7746928_1022", "token_id": "1022", "traits": { "location_x": null, "location_y": null, "type": null } } ], "response": 200 } ``` # /estimates/bulk ## Get bulk estimates `POST` `https://api.nftbank.ai/estimates-v2/estimates/bulk` #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | #### Request Body | Name | Type | Description | | ------------------------------------------------- | ------ | ------------------------------------------------------------- | | asset\_contract\* | string | Asset contract address | | token\_ids\* | array | Token IDs | | chain\_id | string | Chain ID ("ETHEREUM", "MATIC", "KLAYTN", default: "ETHEREUM") | {% tabs %} {% tab title="200 " %} ``` { "data": [ { "_id": "ethereum-0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a_1-19700101", "asset_contract": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "asset_info": { "contract_address": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "sandbox", "image_url": "https://lh3.googleusercontent.com/SXH8tW1siikB80rwCRnjm1a5xM_MwTg9Xl9Db6mioIk9HIlDM09pVoSR7GKJgS6ulSUpgW9BDtMk_ePX_NKgO9A=s60", "name": "The Sandbox" }, "estimate": [ { "currency_symbol": "USD", "estimate_price": 100.000000 }, { "currency_symbol": "SAND", "estimate_price": 1000.000000 }, { "currency_symbol": "ETH", "estimate_price": 0.100000000 } ], "estimated_at": "Mon, 1 Jan 1970 00:00:00 GMT", "item_id": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a_1", "token_id": "1", "traits": { "location_x": 0, "location_y": 0 } }, { "_id": "ethereum-0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a_2-19700101", "asset_contract": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "asset_info": { "contract_address": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "sandbox", "image_url": "https://lh3.googleusercontent.com/SXH8tW1siikB80rwCRnjm1a5xM_MwTg9Xl9Db6mioIk9HIlDM09pVoSR7GKJgS6ulSUpgW9BDtMk_ePX_NKgO9A=s60", "name": "The Sandbox" }, "estimate": [ { "currency_symbol": "USD", "estimate_price": 200.0000000 }, { "currency_symbol": "SAND", "estimate_price": 2000.000000000 }, { "currency_symbol": "ETH", "estimate_price": 0.20000000 } ], "estimated_at": "Mon, 1 Jan 1970 00:00:00 GMT", "item_id": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a_2", "token_id": "2", "traits": { "location_x": 1, "location_y": 1 } } ], "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl --request POST 'https://api.nftbank.ai/estimates-v2/estimates/bulk' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ --data-raw '{ "asset_contract": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "token_ids": ["100001", "159287"], "chain_id": "ETHEREUM"} ' ``` **curl response example** ```json { "data": [ { "_id": "ethereum-0x5cc5b05a8a13e3fbdb0bb9fccd98d38e50f90c38_100001-20220409", "asset_contract": "0x5cc5b05a8a13e3fbdb0bb9fccd98d38e50f90c38", "asset_info": { "contract_address": "0x5cc5b05a8a13e3fbdb0bb9fccd98d38e50f90c38", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "sandbox", "image_url": "https://lh3.googleusercontent.com/SXH8tW1siikB80rwCRnjm1a5xM_MwTg9Xl9Db6mioIk9HIlDM09pVoSR7GKJgS6ulSUpgW9BDtMk_ePX_NKgO9A=s60", "name": "The Sandbox" }, "estimate": [ { "currency_symbol": "USD", "estimate_price": 9664.264426359947 } ], "estimated_at": "Sat, 09 Apr 2022 00:00:00 GMT", "item_id": "0x5cc5b05a8a13e3fbdb0bb9fccd98d38e50f90c38_100001", "token_id": "100001", "traits": { "location_x": -163, "location_y": 41, "type": null } }, { "_id": "ethereum-0x5cc5b05a8a13e3fbdb0bb9fccd98d38e50f90c38_159287-20220409", "asset_contract": "0x5cc5b05a8a13e3fbdb0bb9fccd98d38e50f90c38", "asset_info": { "contract_address": "0x5cc5b05a8a13e3fbdb0bb9fccd98d38e50f90c38", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "sandbox", "image_url": "https://lh3.googleusercontent.com/SXH8tW1siikB80rwCRnjm1a5xM_MwTg9Xl9Db6mioIk9HIlDM09pVoSR7GKJgS6ulSUpgW9BDtMk_ePX_NKgO9A=s60", "name": "The Sandbox" }, "estimate": [ { "currency_symbol": "USD", "estimate_price": 6346.871304778362 } ], "estimated_at": "Sat, 09 Apr 2022 00:00:00 GMT", "item_id": "0x5cc5b05a8a13e3fbdb0bb9fccd98d38e50f90c38_159287", "token_id": "159287", "traits": { "location_x": -37, "location_y": 186, "type": null } } ], "response": 200 } ``` # Supported Collections Are you looking for NFT price valuation? You came to the right place. Using NFTBank's Price Estimate API, you can get access to the ML2-driven NFT price estimate for more than 7400 NFT projects. As of August 4 2022, NFTBank provides Price Estimates for 7400+ projects. Below are examples of top volume NFT collections and their MAPE\*. > \*MAPE stands for [Median Absolute Percentage Error](https://en.wikipedia.org/wiki/Mean_absolute_percentage_error). In plain English, it's the median error rate.\ > **For example, MAPE is 9%, it means that half the time, our estimate may be off by 9% at most .** For a more comprehensive list, refer to this [Table](https://datastudio.google.com/reporting/9f3e792f-14f7-4cc9-af4d-22db9f8a6016/page/ZYpoC). # Price Estimate Performance NFTBank's price estimate model covers over 1.8K projects and is operating stably with excellent performance. We released a number of dashboards where you can check how accurate the NFTBank price estimates model is. ### Model Performance Dashboard (by project) You can easily check the performance of the estimate price by entering the project name in the search bar on [the dashboard](https://datastudio.google.com/u/0/reporting/9f3e792f-14f7-4cc9-af4d-22db9f8a6016/page/ZYpoC). ![](/files/2p6Fnmaild6HUMfstKdM) ### Model Performance Dashboard (by item) You can check the actual price at which the items were traded and their predicted price and their daily performance on [the dashboard](https://datastudio.google.com/s/sUIiAgkC9Dw). ![](/files/XP7WQ755oLJTdMMmdd6h) # Floor Price Endpoints * [/floor\_price/dapp/list](/nftbank-floor-price-api/nftbank-floor-price-api/floor_price-dapp-list) * [/floor\_price/dapp/:asset\_contract](/nftbank-floor-price-api/nftbank-floor-price-api/floor_price-dapp-asset_contract) * [/floor\_price/:asset\_contract](/nftbank-floor-price-api/nftbank-floor-price-api/floor_price-asset_contract) * [/floor\_price/:asset\_contract/bulk](/nftbank-floor-price-api/nftbank-floor-price-api/floor_price-asset_contract-bulk) * [/floor\_price/:asset\_contract/:token\_id](/nftbank-floor-price-api/nftbank-floor-price-api/floor_price-asset_contract-token_id) * [/floor\_price/:asset\_contract/:token\_id/bulk](/nftbank-floor-price-api/nftbank-floor-price-api/floor_price-asset_contract-token_id-bulk) After getting access to API keys using [this form](https://nftbank.typeform.com/to/iZaK3tjj?typeform-source=docs.nftbank.ai), use the API commands in [API overview ](https://docs.nftbank.ai/nftbank-floor-price-api/nftbank-floor-price-api)to fetch data. Make sure to check the list of [Supported Collections ](https://docs.nftbank.ai/nftbank-floor-price-api/supported-collections)before fetching data and use the contract address listed on the table. # /floor\_price/dapp/list ## Get available dapp list `GET` `https://api.nftbank.ai/estimates-v2/floor_price/dapp/list` This endpoint allows you to get available dapp list. #### Query Parameters | Name | Type | Description | | ------ | ------- | ----------- | | offset | integer | default: 0 | | limit | integer | default: 50 | #### Headers | Name | Type | Description | | --------- | ------ | -------------------------------------------- | | x-api-key | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 Cake successfully retrieved." %} ``` { "data": [ { "_id": "ethereum-0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "asset_contract": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "asset_info": { "contract_address": "0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "sandbox", "image_url": "https://lh3.googleusercontent.com/SXH8tW1siikB80rwCRnjm1a5xM_MwTg9Xl9Db6mioIk9HIlDM09pVoSR7GKJgS6ulSUpgW9BDtMk_ePX_NKgO9A=s60", "name": "The Sandbox" }, "max_estimated_at": "Mon, 1 Jan 1970 00:00:00 GMT", "native_token_info": { "token_address": "0x3845badAde8e6dFF049820680d1F14bD3903a5d0", "token_symbol": "SAND" } }, { "_id": "ethereum-0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "asset_contract": "0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "asset_info": { "contract_address": "0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d", "name": "Lands", "symbol": "LAND" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "decentraland", "image_url": "https://lh3.googleusercontent.com/5KIxEGmnAiL5psnMCSLPlfSxDxfRSk4sTQRSyhPdgnu70nGb2YsuVxTmO2iKEkOZOfq476Bl1hAu6aJIKjs1myY=s60", "name": "Decentraland" }, "max_estimated_at": "Mon, 1 Jan 1970 00:00:00 GMT", "native_token_info": { "token_address": "0x0f5d2fb29fb7d3cfee444a200298f468908cc942", "token_symbol": "MANA" } } ], "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" "https://api.nftbank.ai/estimates-v2/floor_price/dapp/list" ``` **curl response example** ```json { "data": [ { "_id": "ethereum_0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "activeness": true, "asset_contract": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "asset_info": { "contract_address": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "name": "MandelNFT", "symbol": "MANDELNFT" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "asset-0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "image_url": "https://lh3.googleusercontent.com/sCdLxTfLImszLQ4SbujAub64e4TUR6n0vndE9nc1H2LE1Xt4Ac1rd8S63EgNZ-V4LGw646lmF7LztlZ2EJnC2-yAwhEBTMqZUQdTOQ=s120", "name": "MandelNFT" }, "native_token_info": { "token_address": "0x0000000000000000000000000000000000000000", "token_symbol": "ETH" } } ], "response": 200 } ``` # /floor\_price/dapp/:asset\_contract ## Get dapp info `GET` `https://api.nftbank.ai/estimates-v2/floor_price/dapp/:asset_contract?chain_id=ETHEREUM` This endpoint allows you to get dapp info. #### Path Parameters | Name | Type | Description | | --------------- | ------ | ---------------------- | | asset\_contract | string | Asset contract address | #### Query Parameters | Name | Type | Description | | --------- | ------ | ------------------------------------------------------------- | | chain\_id | string | Chain ID ("ETHEREUM", "MATIC", "KLAYTN", default: "ETHEREUM") | #### Headers | Name | Type | Description | | --------- | ------ | -------------------------------------------- | | x-api-key | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 " %} ``` ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/estimates-v2/floor_price/dapp/list?offset=0&limit=50"curl ``` **curl response example** ```json { "data": [ { "_id": "ethereum_0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "activeness": true, "asset_contract": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "asset_info": { "contract_address": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "name": "MandelNFT", "symbol": "MANDELNFT" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "asset-0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "image_url": "https://lh3.googleusercontent.com/sCdLxTfLImszLQ4SbujAub64e4TUR6n0vndE9nc1H2LE1Xt4Ac1rd8S63EgNZ-V4LGw646lmF7LztlZ2EJnC2-yAwhEBTMqZUQdTOQ=s120", "name": "MandelNFT" }, "native_token_info": { "token_address": "0x0000000000000000000000000000000000000000", "token_symbol": "ETH" } } ], "response": 200 } ``` # /floor\_price/:asset\_contract ## Get floor price `GET` `https://api.nftbank.ai/estimates-v2/floor_price/:asset_contract?chain_id=ETHEREUM` #### Path Parameters | Name | Type | Description | | --------------- | ------ | ---------------------- | | asset\_contract | string | Asset contract address | #### Query Parameters | Name | Type | Description | | --------- | ------ | ------------------------------------------------------------- | | chain\_id | string | Chain ID ("ETHEREUM," "MATIC", "KLAYTN", default: "ETHEREUM") | #### Headers | Name | Type | Description | | --------- | ------ | -------------------------------------------- | | x-api-key | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 " %} ```json { "data": [ { "_id": "ethereum_0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "asset_contract": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "asset_info": { "contract_address": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "name": "MandelNFT", "symbol": "MANDELNFT" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "asset-0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "image_url": "https://lh3.googleusercontent.com/sCdLxTfLImszLQ4SbujAub64e4TUR6n0vndE9nc1H2LE1Xt4Ac1rd8S63EgNZ-V4LGw646lmF7LztlZ2EJnC2-yAwhEBTMqZUQdTOQ=s120", "name": "MandelNFT" }, "estimated_at": "Wed, 15 Sep 2021 00:00:00 GMT", "floor_price": [ { "currency_symbol": "USD", "floor_price": 162.99596920722044 }, { "currency_symbol": "ETH", "floor_price": 0.05 } ] } ], "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/estimates-v2/floor_price/0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147?chain_id=ETHEREUM" ``` **curl response example** ```json { "data": [ { "_id": "ethereum_0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "asset_contract": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "asset_info": { "contract_address": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "name": "MandelNFT", "symbol": "MANDELNFT" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "asset-0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "image_url": "https://lh3.googleusercontent.com/sCdLxTfLImszLQ4SbujAub64e4TUR6n0vndE9nc1H2LE1Xt4Ac1rd8S63EgNZ-V4LGw646lmF7LztlZ2EJnC2-yAwhEBTMqZUQdTOQ=s120", "name": "MandelNFT" }, "estimated_at": "Wed, 15 Sep 2021 00:00:00 GMT", "floor_price": [ { "currency_symbol": "USD", "floor_price": 162.99596920722044 }, { "currency_symbol": "ETH", "floor_price": 0.05 } ] } ], "response": 200 } ``` # /floor\_price/:asset\_contract/bulk ## Get bulk `POST` `https://api.nftbank.ai/estimates-v2/floor_price/bulk` #### Headers | Name | Type | Description | | --------- | ------ | -------------------------------------------- | | x-api-key | string | API key request via \[API key request] link. | #### Request Body | Name | Type | Description | | --------------- | ------ | ------------------------------------------------------------- | | asset\_contract | string | Asset contract address | | chain\_id | string | Chain ID ("ETHEREUM", "MATIC", "KLAYTN", default: "ETHEREUM") | {% tabs %} {% tab title="200 " %} ```json { "data": [ { "_id": "ethereum_0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "asset_contract": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "asset_info": { "contract_address": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "name": "MandelNFT", "symbol": "MANDELNFT" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "asset-0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "image_url": "https://lh3.googleusercontent.com/sCdLxTfLImszLQ4SbujAub64e4TUR6n0vndE9nc1H2LE1Xt4Ac1rd8S63EgNZ-V4LGw646lmF7LztlZ2EJnC2-yAwhEBTMqZUQdTOQ=s120", "name": "MandelNFT" }, "estimated_at": "Wed, 15 Sep 2021 00:00:00 GMT", "floor_price": [ { "currency_symbol": "USD", "floor_price": 162.99596920722044 }, { "currency_symbol": "ETH", "floor_price": 0.05 } ] }, { "_id": "ethereum_0xd4e4078ca3495de5b1d4db434bebc5a986197782", "asset_contract": "0xd4e4078ca3495de5b1d4db434bebc5a986197782", "asset_info": { "contract_address": "0xd4e4078ca3495de5b1d4db434bebc5a986197782", "name": "Autoglyphs", "symbol": "☵" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "autoglyphs", "image_url": "https://lh3.googleusercontent.com/BX7cWHwWFzo6FVh-Ql_qzFbXtADQgLLlpLOl3l9tS6hUPlgtGHgHn_E1FxiHXmzNlvig00ZEAk9uZU-tMPT2Fg=s60", "name": "Autoglyphs" }, "estimated_at": "Wed, 15 Sep 2021 00:00:00 GMT", "floor_price": [ { "currency_symbol": "USD", "floor_price": 1526019.84195948 }, { "currency_symbol": "ETH", "floor_price": 411.7 } ] } ], "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ --request POST 'https://api.nftbank.ai/estimates-v2/floor_price/bulk' \ -H 'Content-Type: application/json' \ --data-raw '{ "chain_id": "ETHEREUM", "asset_contracts": [ "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "0xd4e4078ca3495de5b1d4db434bebc5a986197782" ] }' ``` **curl response example** ```json { "data": [ { "_id": "ethereum_0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "asset_contract": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "asset_info": { "contract_address": "0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "name": "MandelNFT", "symbol": "MANDELNFT" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "asset-0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147", "image_url": "https://lh3.googleusercontent.com/sCdLxTfLImszLQ4SbujAub64e4TUR6n0vndE9nc1H2LE1Xt4Ac1rd8S63EgNZ-V4LGw646lmF7LztlZ2EJnC2-yAwhEBTMqZUQdTOQ=s120", "name": "MandelNFT" }, "estimated_at": "Wed, 15 Sep 2021 00:00:00 GMT", "floor_price": [ { "currency_symbol": "USD", "floor_price": 162.99596920722044 }, { "currency_symbol": "ETH", "floor_price": 0.05 } ] }, { "_id": "ethereum_0xd4e4078ca3495de5b1d4db434bebc5a986197782", "asset_contract": "0xd4e4078ca3495de5b1d4db434bebc5a986197782", "asset_info": { "contract_address": "0xd4e4078ca3495de5b1d4db434bebc5a986197782", "name": "Autoglyphs", "symbol": "☵" }, "chain_id": "ETHEREUM", "dapp_info": { "id": "autoglyphs", "image_url": "https://lh3.googleusercontent.com/BX7cWHwWFzo6FVh-Ql_qzFbXtADQgLLlpLOl3l9tS6hUPlgtGHgHn_E1FxiHXmzNlvig00ZEAk9uZU-tMPT2Fg=s60", "name": "Autoglyphs" }, "estimated_at": "Wed, 15 Sep 2021 00:00:00 GMT", "floor_price": [ { "currency_symbol": "USD", "floor_price": 1526019.84195948 }, { "currency_symbol": "ETH", "floor_price": 411.7 } ] } ], "response": 200 } ``` \*\*\*\* # /floor\_price/:asset\_contract/:token\_id ## Get floor price of one token `GET` `https://api.nftbank.ai/estimates-v2/floor_price/:asset_contract/:token_id?chain_id=ETHEREUM` #### Path Parameters | Name | Type | Description | | ------------------------------------------------- | ------ | ---------------------- | | asset\_contract\* | string | Asset contract address | | token\_id\* | string | Token ID | #### Query Parameters | Name | Type | Description | | --------- | ------ | ------------------------------------------------------------- | | chain\_id | string | Chain ID ("ETHEREUM," "MATIC", "KLAYTN", default: "ETHEREUM") | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 " %} ```json { "data": [ { "_id": "ethereum_0xd8b7cc75e22031a72d7b8393113ef2536e17bde6_1000100971", "asset_contract": "0xd8b7cc75e22031a72d7b8393113ef2536e17bde6", "chain_id": "ETHEREUM", "estimated_at": "Fri, 08 Apr 2022 03:00:00 GMT", "token_id": "1000100971", "traits": [ { "floor_price_eth": 0.08, "floor_price_usd": 233.99402127183194, "is_enough_data": true, "trait_type": "blom", "trait_value": "theme:_quilted" }, { "floor_price_eth": 0.08, "floor_price_usd": 233.99402127183194, "is_enough_data": true, "trait_type": "blom", "trait_value": "reversed:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "name", "trait_value": "blom" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "mirrored:_0" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "preset:_blom" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "plotter:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "has_skips:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "draw_lines:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "draw_triangles:_1" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "draw_swirls:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "draw_normals:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "draw_squares:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "particle_count:_many" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "artist", "trait_value": "lucastswick" } ] } ], "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/estimates-v2/floor_price/0xd8b7cc75e22031a72d7b8393113ef2536e17bde6/1000100971?chain_id=ETHEREUM" ``` **curl response example** ```json { "data": [ { "_id": "ethereum_0xd8b7cc75e22031a72d7b8393113ef2536e17bde6_1000100971", "asset_contract": "0xd8b7cc75e22031a72d7b8393113ef2536e17bde6", "chain_id": "ETHEREUM", "estimated_at": "Fri, 08 Apr 2022 03:00:00 GMT", "token_id": "1000100971", "traits": [ { "floor_price_eth": 0.08, "floor_price_usd": 233.99402127183194, "is_enough_data": true, "trait_type": "blom", "trait_value": "theme:_quilted" }, { "floor_price_eth": 0.08, "floor_price_usd": 233.99402127183194, "is_enough_data": true, "trait_type": "blom", "trait_value": "reversed:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "name", "trait_value": "blom" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "mirrored:_0" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "preset:_blom" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "plotter:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "has_skips:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "draw_lines:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "draw_triangles:_1" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "draw_swirls:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "draw_normals:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "draw_squares:_false" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "blom", "trait_value": "particle_count:_many" }, { "floor_price_eth": 0.029, "floor_price_usd": 93.75221468098789, "is_enough_data": true, "trait_type": "artist", "trait_value": "lucastswick" } ] } ], "response": 200 } ``` # /floor\_price/:asset\_contract/:token\_id/bulk ## Get floor prices of multiple tokens `POST` `https://api.nftbank.ai/estimates-v2/floor_price/:asset_contract/bulk` #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | #### Request Body | Name | Type | Description | | ------------------------------------------------- | ------ | ------------------------------------------------------------- | | asset\_contract\* | string | Asset contract address | | token\_ids\* | array | Array of token IDs | | chain\_id | string | Chain ID ("ETHEREUM", "MATIC", "KLAYTN", default: "ETHEREUM") | {% tabs %} {% tab title="200 " %} ```json { "data": [ { "_id": "ethereum_0xcbc67ea382f8a006d46eeeb7255876beb7d7f14d_5416", "asset_contract": "0xcbc67ea382f8a006d46eeeb7255876beb7d7f14d", "chain_id": "ETHEREUM", "estimated_at": "Fri, 08 Apr 2022 04:00:00 GMT", "token_id": "5416", "traits": [ { "floor_price_eth": 0.4, "floor_price_usd": 1376.1344953956675, "is_enough_data": true, "trait_type": "music_-_percussion", "trait_value": "alt_crunch" }, { "floor_price_eth": 0.35, "floor_price_usd": 1032.582066560952, "is_enough_data": true, "trait_type": "background_effect", "trait_value": "attitude" }, { "floor_price_eth": 0.35, "floor_price_usd": 1232.5546536724835, "is_enough_data": true, "trait_type": "vibe", "trait_value": "chill_(blue)" }, { "floor_price_eth": 0.35, "floor_price_usd": 1232.5546536724835, "is_enough_data": true, "trait_type": "piercing", "trait_value": "nose_ring_(silver)" }, { "floor_price_eth": 0.35, "floor_price_usd": 1232.3384911265273, "is_enough_data": true, "trait_type": "background", "trait_value": "red" }, { "floor_price_eth": 0.34, "floor_price_usd": 1169.7143210863173, "is_enough_data": true, "trait_type": "music_-_shred_guitar", "trait_value": "true" }, { "floor_price_eth": 0.31, "floor_price_usd": 1061.1206639639606, "is_enough_data": true, "trait_type": "music_-_power_chords", "trait_value": "true" }, { "floor_price_eth": 0.3, "floor_price_usd": 1026.8909651264134, "is_enough_data": true, "trait_type": "music_-_fresh", "trait_value": "1" }, { "floor_price_eth": 0.3, "floor_price_usd": 951.4113313496862, "is_enough_data": true, "trait_type": "generative_ability", "trait_value": "diamond" }, { "floor_price_eth": 0.3, "floor_price_usd": 951.4113313496862, "is_enough_data": true, "trait_type": "hair", "trait_value": "yellow" }, { "floor_price_eth": 0.297, "floor_price_usd": 951.4113313496862, "is_enough_data": true, "trait_type": "music_-_light", "trait_value": "1" }, { "floor_price_eth": 0.27, "floor_price_usd": 919.6976203046967, "is_enough_data": true, "trait_type": "music_-_weird", "trait_value": "0" }, { "floor_price_eth": 0.27, "floor_price_usd": 924.2018686137721, "is_enough_data": true, "trait_type": "bpm", "trait_value": "100" }, { "floor_price_eth": 0.25, "floor_price_usd": 792.8427761247385, "is_enough_data": true, "trait_type": "music_-_song_key", "trait_value": "eb_minor" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_grime", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_slime", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_robotic", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_esoteric", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "mouth", "trait_value": "standard" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "artist", "trait_value": "nayomi" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_joy", "trait_value": "0" } ] }, { "_id": "ethereum_0xcbc67ea382f8a006d46eeeb7255876beb7d7f14d_9065", "asset_contract": "0xcbc67ea382f8a006d46eeeb7255876beb7d7f14d", "chain_id": "ETHEREUM", "estimated_at": "Fri, 08 Apr 2022 04:00:00 GMT", "token_id": "9065", "traits": [ { "floor_price_eth": 0.45, "floor_price_usd": 1397.732424371413, "is_enough_data": true, "trait_type": "music_-_bass", "trait_value": "plucky_hop" }, { "floor_price_eth": 0.45, "floor_price_usd": 1540.3364476896202, "is_enough_data": true, "trait_type": "music_-_lead", "trait_value": "short_bubble" }, { "floor_price_eth": 0.35, "floor_price_usd": 1232.3384911265273, "is_enough_data": true, "trait_type": "music_-_pad", "trait_value": "square_course" }, { "floor_price_eth": 0.31, "floor_price_usd": 1002.1788465898704, "is_enough_data": true, "trait_type": "music_-_song_key", "trait_value": "g_major" }, { "floor_price_eth": 0.31, "floor_price_usd": 1032.582066560952, "is_enough_data": true, "trait_type": "skin", "trait_value": "charcoal" }, { "floor_price_eth": 0.31, "floor_price_usd": 1002.1788465898704, "is_enough_data": true, "trait_type": "pull_ring", "trait_value": "pink_ring" }, { "floor_price_eth": 0.3, "floor_price_usd": 1026.8909651264134, "is_enough_data": true, "trait_type": "music_-_joy", "trait_value": "3" }, { "floor_price_eth": 0.3, "floor_price_usd": 951.4113313496862, "is_enough_data": true, "trait_type": "generative_ability", "trait_value": "diamond" }, { "floor_price_eth": 0.3, "floor_price_usd": 1026.8909651264134, "is_enough_data": true, "trait_type": "music_-_percussion", "trait_value": "paper_nice" }, { "floor_price_eth": 0.3, "floor_price_usd": 1002.1788465898704, "is_enough_data": true, "trait_type": "eyes", "trait_value": "standard" }, { "floor_price_eth": 0.297, "floor_price_usd": 960.1519917328758, "is_enough_data": true, "trait_type": "background", "trait_value": "yellowpink" }, { "floor_price_eth": 0.27, "floor_price_usd": 919.6976203046967, "is_enough_data": true, "trait_type": "music_-_weird", "trait_value": "0" }, { "floor_price_eth": 0.27, "floor_price_usd": 919.6976203046967, "is_enough_data": true, "trait_type": "background_effect", "trait_value": "happy" }, { "floor_price_eth": 0.25, "floor_price_usd": 792.8427761247385, "is_enough_data": true, "trait_type": "music_-_dark", "trait_value": "1" }, { "floor_price_eth": 0.25, "floor_price_usd": 792.8427761247385, "is_enough_data": true, "trait_type": "music_-_fresh", "trait_value": "0" }, { "floor_price_eth": 0.25, "floor_price_usd": 792.8427761247385, "is_enough_data": true, "trait_type": "artist", "trait_value": "gnar_heart" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_grime", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_light", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_slime", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_robotic", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_esoteric", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "bpm", "trait_value": "128" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "mouth", "trait_value": "standard" } ] } ], "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ --request POST 'https://api.nftbank.ai/estimates-v2/floor_price/0xcbc67ea382f8a006d46eeeb7255876beb7d7f14d/bulk' \ -H 'Content-Type: application/json' \ --data-raw '{ "chain_id": "ETHEREUM", "token_ids": [ "9065", "5416" ] }' ``` **curl response example** ```json { "data": [ { "_id": "ethereum_0xcbc67ea382f8a006d46eeeb7255876beb7d7f14d_5416", "asset_contract": "0xcbc67ea382f8a006d46eeeb7255876beb7d7f14d", "chain_id": "ETHEREUM", "estimated_at": "Fri, 08 Apr 2022 04:00:00 GMT", "token_id": "5416", "traits": [ { "floor_price_eth": 0.4, "floor_price_usd": 1376.1344953956675, "is_enough_data": true, "trait_type": "music_-_percussion", "trait_value": "alt_crunch" }, { "floor_price_eth": 0.35, "floor_price_usd": 1032.582066560952, "is_enough_data": true, "trait_type": "background_effect", "trait_value": "attitude" }, { "floor_price_eth": 0.35, "floor_price_usd": 1232.5546536724835, "is_enough_data": true, "trait_type": "vibe", "trait_value": "chill_(blue)" }, { "floor_price_eth": 0.35, "floor_price_usd": 1232.5546536724835, "is_enough_data": true, "trait_type": "piercing", "trait_value": "nose_ring_(silver)" }, { "floor_price_eth": 0.35, "floor_price_usd": 1232.3384911265273, "is_enough_data": true, "trait_type": "background", "trait_value": "red" }, { "floor_price_eth": 0.34, "floor_price_usd": 1169.7143210863173, "is_enough_data": true, "trait_type": "music_-_shred_guitar", "trait_value": "true" }, { "floor_price_eth": 0.31, "floor_price_usd": 1061.1206639639606, "is_enough_data": true, "trait_type": "music_-_power_chords", "trait_value": "true" }, { "floor_price_eth": 0.3, "floor_price_usd": 1026.8909651264134, "is_enough_data": true, "trait_type": "music_-_fresh", "trait_value": "1" }, { "floor_price_eth": 0.3, "floor_price_usd": 951.4113313496862, "is_enough_data": true, "trait_type": "generative_ability", "trait_value": "diamond" }, { "floor_price_eth": 0.3, "floor_price_usd": 951.4113313496862, "is_enough_data": true, "trait_type": "hair", "trait_value": "yellow" }, { "floor_price_eth": 0.297, "floor_price_usd": 951.4113313496862, "is_enough_data": true, "trait_type": "music_-_light", "trait_value": "1" }, { "floor_price_eth": 0.27, "floor_price_usd": 919.6976203046967, "is_enough_data": true, "trait_type": "music_-_weird", "trait_value": "0" }, { "floor_price_eth": 0.27, "floor_price_usd": 924.2018686137721, "is_enough_data": true, "trait_type": "bpm", "trait_value": "100" }, { "floor_price_eth": 0.25, "floor_price_usd": 792.8427761247385, "is_enough_data": true, "trait_type": "music_-_song_key", "trait_value": "eb_minor" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_grime", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_slime", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_robotic", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_esoteric", "trait_value": "0" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "mouth", "trait_value": "standard" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "artist", "trait_value": "nayomi" }, { "floor_price_eth": 0.23, "floor_price_usd": 729.4153540347595, "is_enough_data": true, "trait_type": "music_-_joy", "trait_value": "0" } ] } ], "response": 200 } ``` # Supported Collections Please find below list of supported collections for NFTBank Floor API. NFTBank currently provides floor price for 5,300+ projects. We are constantly expanding our Floor API coverage to keep up with new NFT collections launching each day. If you do not see your desired collection, please reach out to us using [this form](https://nftbank.typeform.com/to/sH77mPIL).\ A list of projects for which price floor is provided can be found on [the dashboard](https://datastudio.google.com/u/1/reporting/50e84ec3-4ca9-4865-95a4-14e3b094a307/page/4FWpC/edit).\ For the trait floor price, please check the following [dashboard](https://datastudio.google.com/u/1/reporting/9a6d714f-28a7-46a0-af82-974f866848e9/page/4FWpC/edit). Example list of supported projects (Top 20 by volume) | Project Name | Asset Contract | | | --------------------- | ------------------------------------------ | - | | terraforms | 0x4e1f41613c9084fdb9e34e11fae9412427480e56 | | | meebits | 0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7 | | | dotdotdots | 0xce25e60a89f200b1fa40f6c313047ffe386992c3 | | | boredapeyachtclub | 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d | | | mutant-ape-yacht-club | 0x60e4d786628fea6478f785a6d7e704777c86a7c6 | | | azuki | 0xed5af388653567af2f388e6224dc7c4b3241c544 | | | invisiblefriends | 0x59468516a8259058bad1ca5f8f4bff190d30e066 | | | cryptopunks | 0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb | | | clonex | 0x49cf6f5d44e70224e2e23fdcdd2c053f30ada28b | | | bored-ape-kennel-club | 0xba30e5f9bb24caa003e9f2f0497ad287fdf95623 | | | mfer | 0x79fcdef22feed20eddacbb2587640e45491b757f | | | World Of Women | 0xe785e82358879f061bc3dcac6f0444462d4b5330 | | | Dour Darcels | 0x8d609bd201beaea7dccbfbd9c22851e23da68691 | | | Sandbox's LANDs | 0x5cc5b05a8a13e3fbdb0bb9fccd98d38e50f90c38 | | | WonderPals | 0x3acce66cd37518a6d77d9ea3039e00b3a2955460 | | | Starcatchers | 0x69b9c98e8d715c25b330d0d4eb07e68cbb7f6cfc | | | The Doggies | 0xc7df86762ba83f2a6197e1ff9bb40ae0f696b9e6 | | | Gutter Juice | 0x092bbc993042a69811d23feb0e64e3bfa0920c6a | | | Dippies | 0x82f5ef9ddc3d231962ba57a9c2ebb307dc8d26c2 | | | Fighter | 0x87e738a3d5e5345d6212d8982205a564289e6324 | | \\ # Asset API Endpoints * [/asset/:asset\_contract/:token\_id](/asset-api/nftbank-asset-api/asset-asset_contract-token_id) * [/asset-events/:asset\_contract/:token\_id](/asset-api/nftbank-asset-api/asset-events-asset_contract-token_id) * [/collections/:asset\_contract](/asset-api/nftbank-asset-api/collections-asset_contract) After getting access to API keys using [this form](https://nftbank.typeform.com/to/iZaK3tjj?typeform-source=docs.nftbank.ai), use the API commands in [API overview](/asset-api/nftbank-asset-api) to fetch data. # /asset/:asset\_contract/:token\_id ## Get metadata of a NFT token `GET` `https://api.nftbank.ai/estimates-v2/asset/:asset_contract/:token_id` This endpoint allows you to get NFT metadata #### Path Parameters | Name | Type | Description | | --------------- | ------ | ----------- | | asset\_contract | string | | | token\_id | string | | #### Query Parameters | Name | Type | Description | | ------------------------------------------- | ------ | ----------------- | | chain\_id\* | string | default: ethereum | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 Cake successfully retrieved." %} ```json { "data": [ { "asset_contract": "0xd8b7cc75e22031a72d7b8393113ef2536e17bde6", "collection": "gen-art-drop", "creator_address": "0xf7d96d2d672af54c661ef5049adc3482a191484d", "image_thumbnail_url": "https://lh3.googleusercontent.com/81LnazmH-vqrkbUDddGZq1a7Zz18jqQrZ_mP_7MxzYTmwNt03YkblT5NGRFuupQPLxBcWEh69-uiYZBIl18SyfPML7ox5-qXvhsAYg=s128", "image_url": "https://lh3.googleusercontent.com/81LnazmH-vqrkbUDddGZq1a7Zz18jqQrZ_mP_7MxzYTmwNt03YkblT5NGRFuupQPLxBcWEh69-uiYZBIl18SyfPML7ox5-qXvhsAYg", "network_id": "ethereum", "token_id": "1000100971", "token_metadata": "https://api.gen.art/public/attributes/1000100971", "traits": [ { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "color_family:_souk", "slug": "blom-color-family-souk", "trait_type": "Blóm", "trait_value": "Color Family: Souk" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "particle_count:_many", "slug": "blom-particle-count-many", "trait_type": "Blóm", "trait_value": "Particle Count: many" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "theme:_quilted", "slug": "blom-theme-quilted", "trait_type": "Blóm", "trait_value": "Theme: quilted" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "reversed:_false", "slug": "blom-reversed-false", "trait_type": "Blóm", "trait_value": "Reversed: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "has_skips:_false", "slug": "blom-has-skips-false", "trait_type": "Blóm", "trait_value": "Has Skips: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "plotter:_false", "slug": "blom-plotter-false", "trait_type": "Blóm", "trait_value": "Plotter: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "draw_lines:_false", "slug": "blom-draw-lines-false", "trait_type": "Blóm", "trait_value": "Draw Lines: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "draw_triangles:_1", "slug": "blom-draw-triangles-1", "trait_type": "Blóm", "trait_value": "Draw Triangles: 1" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "draw_squares:_false", "slug": "blom-draw-squares-false", "trait_type": "Blóm", "trait_value": "Draw Squares: false" }, { "display_type": null, "normalized_trait_type": "artist", "normalized_trait_value": "lucastswick", "slug": "artist-lucastswick", "trait_type": "Artist", "trait_value": "lucastswick" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "draw_swirls:_false", "slug": "blom-draw-swirls-false", "trait_type": "Blóm", "trait_value": "Draw Swirls: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "mirrored:_0", "slug": "blom-mirrored-0", "trait_type": "Blóm", "trait_value": "Mirrored: 0" }, { "display_type": null, "normalized_trait_type": "name", "normalized_trait_value": "blom", "slug": "name-blom", "trait_type": "Name", "trait_value": "Blóm" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "preset:_blom", "slug": "blom-preset-blom", "trait_type": "Blóm", "trait_value": "Preset: blom" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "draw_normals:_false", "slug": "blom-draw-normals-false", "trait_type": "Blóm", "trait_value": "Draw Normals: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "total_frames:_84", "slug": "blom-total-frames-84", "trait_type": "Blóm", "trait_value": "Total Frames: 84" } ] } ], "response": 200 }n ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/estimates-v2/asset/0xd8b7cc75e22031a72d7b8393113ef2536e17bde6/1000100971?chain_id=ETHEREUM" ``` **curl response example** ```json { "data": [ { "asset_contract": "0xd8b7cc75e22031a72d7b8393113ef2536e17bde6", "collection": "gen-art-drop", "creator_address": "0xf7d96d2d672af54c661ef5049adc3482a191484d", "image_thumbnail_url": "https://lh3.googleusercontent.com/81LnazmH-vqrkbUDddGZq1a7Zz18jqQrZ_mP_7MxzYTmwNt03YkblT5NGRFuupQPLxBcWEh69-uiYZBIl18SyfPML7ox5-qXvhsAYg=s128", "image_url": "https://lh3.googleusercontent.com/81LnazmH-vqrkbUDddGZq1a7Zz18jqQrZ_mP_7MxzYTmwNt03YkblT5NGRFuupQPLxBcWEh69-uiYZBIl18SyfPML7ox5-qXvhsAYg", "network_id": "ethereum", "token_id": "1000100971", "token_metadata": "https://api.gen.art/public/attributes/1000100971", "traits": [ { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "color_family:_souk", "slug": "blom-color-family-souk", "trait_type": "Blóm", "trait_value": "Color Family: Souk" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "particle_count:_many", "slug": "blom-particle-count-many", "trait_type": "Blóm", "trait_value": "Particle Count: many" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "theme:_quilted", "slug": "blom-theme-quilted", "trait_type": "Blóm", "trait_value": "Theme: quilted" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "reversed:_false", "slug": "blom-reversed-false", "trait_type": "Blóm", "trait_value": "Reversed: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "has_skips:_false", "slug": "blom-has-skips-false", "trait_type": "Blóm", "trait_value": "Has Skips: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "plotter:_false", "slug": "blom-plotter-false", "trait_type": "Blóm", "trait_value": "Plotter: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "draw_lines:_false", "slug": "blom-draw-lines-false", "trait_type": "Blóm", "trait_value": "Draw Lines: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "draw_triangles:_1", "slug": "blom-draw-triangles-1", "trait_type": "Blóm", "trait_value": "Draw Triangles: 1" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "draw_squares:_false", "slug": "blom-draw-squares-false", "trait_type": "Blóm", "trait_value": "Draw Squares: false" }, { "display_type": null, "normalized_trait_type": "artist", "normalized_trait_value": "lucastswick", "slug": "artist-lucastswick", "trait_type": "Artist", "trait_value": "lucastswick" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "draw_swirls:_false", "slug": "blom-draw-swirls-false", "trait_type": "Blóm", "trait_value": "Draw Swirls: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "mirrored:_0", "slug": "blom-mirrored-0", "trait_type": "Blóm", "trait_value": "Mirrored: 0" }, { "display_type": null, "normalized_trait_type": "name", "normalized_trait_value": "blom", "slug": "name-blom", "trait_type": "Name", "trait_value": "Blóm" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "preset:_blom", "slug": "blom-preset-blom", "trait_type": "Blóm", "trait_value": "Preset: blom" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "draw_normals:_false", "slug": "blom-draw-normals-false", "trait_type": "Blóm", "trait_value": "Draw Normals: false" }, { "display_type": null, "normalized_trait_type": "blom", "normalized_trait_value": "total_frames:_84", "slug": "blom-total-frames-84", "trait_type": "Blóm", "trait_value": "Total Frames: 84" } ] } ], "response": 200 } ``` # /asset-events/:asset\_contract/:token\_id ## Get events of NFT token. `GET` `https://api.nftbank.ai/estimates-v2/asset-events/:asset_contract/:token_id?chain_id=ETHEREUM` This endpoint allows you to get dapp info. #### Path Parameters | Name | Type | Description | | --------------- | ------ | ---------------------- | | asset\_contract | string | Asset contract address | #### Query Parameters | Name | Type | Description | | --------- | ------ | ------------------------------------------------------------- | | chain\_id | string | Chain ID ("ETHEREUM", "MATIC", "KLAYTN", default: "ETHEREUM") | #### Headers | Name | Type | Description | | --------- | ------ | -------------------------------------------- | | x-api-key | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 " %} ```json { "data": [ { "amount": 1.0, "asset_contract": "0xd8b7cc75e22031a72d7b8393113ef2536e17bde6", "block_timestamp": "Sun, 17 Oct 2021 12:09:44 GMT", "buyer_address": "0x4337a241dd81f774017db547c789f067f68f8501", "seller_address": "0x0000000000000000000000000000000000000000", "sold_price_eth": 0.1, "sold_price_usd": 385.4498461449342, "token_id": "1000100971", "transaction_hash": "0xa9b61b98936b81a585ea333dc6b0b60724b86bfc01febb083ae240eaaf192c6b" } ], "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/estimates-v2/asset-events/:asset_contract/:token_id?chain_id=ETHEREUM"curl ``` **curl response example** ```json { "data": [ { "amount": 1.0, "asset_contract": "0xd8b7cc75e22031a72d7b8393113ef2536e17bde6", "block_timestamp": "Sun, 17 Oct 2021 12:09:44 GMT", "buyer_address": "0x4337a241dd81f774017db547c789f067f68f8501", "seller_address": "0x0000000000000000000000000000000000000000", "sold_price_eth": 0.1, "sold_price_usd": 385.4498461449342, "token_id": "1000100971", "transaction_hash": "0xa9b61b98936b81a585ea333dc6b0b60724b86bfc01febb083ae240eaaf192c6b" } ], "response": 200 } ``` # /collections/:asset\_contract ## Get statistics of a NFT collection `GET` `https://api.nftbank.ai/estimates-v2/collections/:asset_contract?chain_id=ETHEREUM` #### Path Parameters | Name | Type | Description | | ------------------------------------------------- | ------ | ---------------------- | | asset\_contract\* | string | Asset contract address | #### Query Parameters | Name | Type | Description | | --------- | ------ | ------------------------------------------------------------- | | chain\_id | string | Chain ID ("ETHEREUM," "MATIC", "KLAYTN", default: "ETHEREUM") | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 " %} ```json { "data": { "floor_price_eth": null, "floor_price_usd": null, "pastday_average_eth": 0.0225, "pastday_average_usd": 73.04430876814243, "pastday_trade_volume_eth": 0.045, "pastday_trade_volume_usd": 146.08861753628486, "pastmonth_average_eth": 0.42657307692307705, "pastmonth_average_usd": 1347.2409118668888, "pastmonth_trade_volume_eth": 11.090899999999992, "pastmonth_trade_volume_usd": 35028.26370853913, "pastmonth_transaction_count": 15, "pastweek_average_eth": 0.42657307692307705, "pastweek_average_usd": 1347.2409118668888, "pastweek_floor_price_eth": null, "pastweek_floor_price_usd": null, "pastweek_trade_volume_eth": 11.090899999999992, "pastweek_trade_volume_usd": 35028.26370853913, "total_trade_volume_eth": 188.03110000000515, "total_trade_volume_usd": 589790.7729914561 }, "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ "https://api.nftbank.ai/estimates-v2/collections/0xa2dbd9e7e2969db08b6a8c6cbc9d002663e70147?chain_id=ETHEREUM" ``` **curl response example** ```json { "data": { "floor_price_eth": null, "floor_price_usd": null, "pastday_average_eth": 0.0225, "pastday_average_usd": 73.04430876814243, "pastday_trade_volume_eth": 0.045, "pastday_trade_volume_usd": 146.08861753628486, "pastmonth_average_eth": 0.42657307692307705, "pastmonth_average_usd": 1347.2409118668888, "pastmonth_trade_volume_eth": 11.090899999999992, "pastmonth_trade_volume_usd": 35028.26370853913, "pastmonth_transaction_count": 15, "pastweek_average_eth": 0.42657307692307705, "pastweek_average_usd": 1347.2409118668888, "pastweek_floor_price_eth": null, "pastweek_floor_price_usd": null, "pastweek_trade_volume_eth": 11.090899999999992, "pastweek_trade_volume_usd": 35028.26370853913, "total_trade_volume_eth": 188.03110000000515, "total_trade_volume_usd": 589790.7729914561 }, "response": 200 } ``` # User Inventory API Endpoints * [/user-inventory/:chain\_id/:address](/user-inventory-api/nftbank-asset-api/user-inventory-chain_id-address) After getting access to API keys using [this form](https://nftbank.typeform.com/to/iZaK3tjj?typeform-source=docs.nftbank.ai), use the API commands in [API overview](/asset-api/nftbank-asset-api) to fetch data. # /user-inventory/:chain\_id/:address ## Get user NFT inventories `GET` `https://api.nftbank.ai/estimates-v2/user-inventory/:chain_id/:address` #### Path Parameters | Name | Type | Description | | ------------------------------------------- | ------ | ------------------------------------------------------------- | | chain\_id\* | string | Chain ID ("ETHEREUM", "MATIC", "KLAYTN", default: "ETHEREUM") | | address\* | strig | | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 " %} ```json { "data": [ { "address": "0x0c6dc7d75cadbbf5fd52afc2079c15d5cd430061", "asset_owned": [ { "acquisition_network_id": "matic", "acquisition_timestamp": "Wed, 09 Feb 2022 15:48:57 GMT", "acquisition_transaction_hash": "0x1645df403a67b68e16f69c2e4b03f288d7d46ef2583171bed5cb5e9e5b09ce5a", "asset_contract": "0xcb50c174cc4b3f61599d2695e6270e1c9f4d80c3", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0xcb50c174cc4b3f61599d2695e6270e1c9f4d80c3_105312291668557186697918027683670432318895095400549111254310979446", "item_type": "erc721", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Thu, 17 Mar 2022 00:51:00 GMT", "acquisition_transaction_hash": "0x34d828f063de45da97f235cc27669cfc845f53c8bcc4c4879aa525cdd98dbbfd", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_68823720108467550463180343326013748842981341638018517040828597995133582018208", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Sat, 12 Feb 2022 12:38:42 GMT", "acquisition_transaction_hash": "0xd3120e6c49efc22f5587a874fd159fc3c08b71f8ca72d04ef239b9a6a59f7250", "asset_contract": "0x26bd28360f9c55d009e685b01d1959824978a138", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x26bd28360f9c55d009e685b01d1959824978a138_1", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Wed, 16 Feb 2022 18:13:29 GMT", "acquisition_transaction_hash": "0x12f639f659550c74863176bc87fd6836cef216d255ec3407bb26025f86d0fb9d", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_104103992698705454582768022046262302786263141743841414824419568505640425333024", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Sun, 10 Apr 2022 12:35:36 GMT", "acquisition_transaction_hash": "0x699ee256940a67d16d28fe5c4f871167c2ec20c7f861eb816f91b75c7d8439ec", "asset_contract": "0x27d61dd2fa6889bdd7ee4023350581b9f9b14335", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x27d61dd2fa6889bdd7ee4023350581b9f9b14335_1", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Wed, 02 Feb 2022 07:18:52 GMT", "acquisition_transaction_hash": "0xd032e2a750cb4bfa9904319749b08021bf72113a2a7be04072a8a6fba0026a3e", "asset_contract": "0xa5ab11cf40cb3e020f9c2ef894c2324287804b58", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0xa5ab11cf40cb3e020f9c2ef894c2324287804b58_0", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Tue, 15 Mar 2022 09:35:58 GMT", "acquisition_transaction_hash": "0x747d2d1d739a224a2ac5fa83b80a0280cceb5eeab4326a482e8e51e40a611c06", "asset_contract": "0x87dcfe3d1915c26cc8aad4e851f3765ffb085cde", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x87dcfe3d1915c26cc8aad4e851f3765ffb085cde_24147", "item_type": "erc721", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Tue, 08 Mar 2022 20:53:52 GMT", "acquisition_transaction_hash": "0xcd3f808aeff933ccb4db17e13d41ed00ccee27c91827f085503a06b8f0c0beb8", "asset_contract": "0xbdb49e024fb25bcef581f51d8e90c0667c3013d2", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0xbdb49e024fb25bcef581f51d8e90c0667c3013d2_3930", "item_type": "erc721", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Fri, 21 Jan 2022 08:22:33 GMT", "acquisition_transaction_hash": "0xb5136fb6e942b248f6eba8d3f9d4539971ece0c02f3572f4c68fb4210544c36b", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_110285470574657408917971892665988722660517933657128765072726712934739642165008", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Thu, 20 Jan 2022 20:34:08 GMT", "acquisition_transaction_hash": "0x791b9d36a112189c012a6f447404e3f3f2237ae64481888163567bf1aa79755f", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_110285470574657408917971892665988722660517933657128765072726712804997270078440", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Tue, 25 Jan 2022 20:05:42 GMT", "acquisition_transaction_hash": "0x0f4191122703d30182c30dcc6ff66f7390b265c765921b94243d2b9b35250dbc", "asset_contract": "0x1ccbf04c6b2e88e1187d0b18eb5a856013890400", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x1ccbf04c6b2e88e1187d0b18eb5a856013890400_1834", "item_type": "erc721", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Mon, 14 Mar 2022 19:52:07 GMT", "acquisition_transaction_hash": "0x1c37d41b9f77160aa8c84b06bc019b04b3df2cb95ddd60ce63e221b6039b7742", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_104103992698705454582768022046262302786263141743841414824419568521033587631888", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Mon, 14 Mar 2022 22:09:39 GMT", "acquisition_transaction_hash": "0x3fdadbb31efb4d26ca55ad8a41d9a260e60859dde524854d6b288313be862d25", "asset_contract": "0x87dcfe3d1915c26cc8aad4e851f3765ffb085cde", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x87dcfe3d1915c26cc8aad4e851f3765ffb085cde_1912", "item_type": "erc721", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Wed, 09 Mar 2022 10:48:46 GMT", "acquisition_transaction_hash": "0x25293fd6fcd84403619f2e07cc0e1c5e31bc4ceca5b6ffe7a81e53071f8b6d2f", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_44503375309253988396066999025134117773656457345501738163498275092591783454480", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Sat, 26 Feb 2022 12:14:27 GMT", "acquisition_transaction_hash": "0x26aaaeb5c5f1903fd6db9287c2bff177c00e6c8d55ba2e9f7859725306a1dd7e", "asset_contract": "0x23a8c2ce858b2e66222567923641cb6417994caf", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x23a8c2ce858b2e66222567923641cb6417994caf_1", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Sun, 06 Mar 2022 15:44:05 GMT", "acquisition_transaction_hash": "0x5b9abc64a9e11c606a6500d082d7b47ab191a70fab0ab72c1ede7846318a0a74", "asset_contract": "0x51c792ca81b4520bc457f443dc26091dd4c87bcd", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x51c792ca81b4520bc457f443dc26091dd4c87bcd_4", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Sun, 13 Mar 2022 11:43:36 GMT", "acquisition_transaction_hash": "0xeaef5cfaa0e78202df695dc511c1dd1e28ebb121ea6dc4c2b0750de154aa4488", "asset_contract": "0x7ac04336b214ea81546685d2bf27222bc4ee02ea", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x7ac04336b214ea81546685d2bf27222bc4ee02ea_1", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Mon, 14 Mar 2022 11:05:06 GMT", "acquisition_transaction_hash": "0x06ba4a1e1fcc079485fe13d2ed5140a52c6040fa345452eed17f87bd7a1163c1", "asset_contract": "0x724de6381fb9e036b2c8a7d51c7980ed5bd70288", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x724de6381fb9e036b2c8a7d51c7980ed5bd70288_0", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null } ], "total_cost_basis_eth": 0.0, "total_cost_basis_usd": 0.0, "total_estimated_price_eth": null, "total_estimated_price_usd": null, "total_floor_price_eth": null, "total_floor_price_usd": null } ], "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ --request GET 'https://api.nftbank.ai/estimates-v2/user-inventory/matic/0x0c6dc7d75cadbbf5fd52afc2079c15d5cd430061' \ -H 'Content-Type: application/json' ``` **curl response example** ```json { "data": [ { "address": "0x0c6dc7d75cadbbf5fd52afc2079c15d5cd430061", "asset_owned": [ { "acquisition_network_id": "matic", "acquisition_timestamp": "Wed, 09 Feb 2022 15:48:57 GMT", "acquisition_transaction_hash": "0x1645df403a67b68e16f69c2e4b03f288d7d46ef2583171bed5cb5e9e5b09ce5a", "asset_contract": "0xcb50c174cc4b3f61599d2695e6270e1c9f4d80c3", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0xcb50c174cc4b3f61599d2695e6270e1c9f4d80c3_105312291668557186697918027683670432318895095400549111254310979446", "item_type": "erc721", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Thu, 17 Mar 2022 00:51:00 GMT", "acquisition_transaction_hash": "0x34d828f063de45da97f235cc27669cfc845f53c8bcc4c4879aa525cdd98dbbfd", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_68823720108467550463180343326013748842981341638018517040828597995133582018208", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Sat, 12 Feb 2022 12:38:42 GMT", "acquisition_transaction_hash": "0xd3120e6c49efc22f5587a874fd159fc3c08b71f8ca72d04ef239b9a6a59f7250", "asset_contract": "0x26bd28360f9c55d009e685b01d1959824978a138", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x26bd28360f9c55d009e685b01d1959824978a138_1", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Wed, 16 Feb 2022 18:13:29 GMT", "acquisition_transaction_hash": "0x12f639f659550c74863176bc87fd6836cef216d255ec3407bb26025f86d0fb9d", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_104103992698705454582768022046262302786263141743841414824419568505640425333024", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Sun, 10 Apr 2022 12:35:36 GMT", "acquisition_transaction_hash": "0x699ee256940a67d16d28fe5c4f871167c2ec20c7f861eb816f91b75c7d8439ec", "asset_contract": "0x27d61dd2fa6889bdd7ee4023350581b9f9b14335", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x27d61dd2fa6889bdd7ee4023350581b9f9b14335_1", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Wed, 02 Feb 2022 07:18:52 GMT", "acquisition_transaction_hash": "0xd032e2a750cb4bfa9904319749b08021bf72113a2a7be04072a8a6fba0026a3e", "asset_contract": "0xa5ab11cf40cb3e020f9c2ef894c2324287804b58", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0xa5ab11cf40cb3e020f9c2ef894c2324287804b58_0", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Tue, 15 Mar 2022 09:35:58 GMT", "acquisition_transaction_hash": "0x747d2d1d739a224a2ac5fa83b80a0280cceb5eeab4326a482e8e51e40a611c06", "asset_contract": "0x87dcfe3d1915c26cc8aad4e851f3765ffb085cde", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x87dcfe3d1915c26cc8aad4e851f3765ffb085cde_24147", "item_type": "erc721", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Tue, 08 Mar 2022 20:53:52 GMT", "acquisition_transaction_hash": "0xcd3f808aeff933ccb4db17e13d41ed00ccee27c91827f085503a06b8f0c0beb8", "asset_contract": "0xbdb49e024fb25bcef581f51d8e90c0667c3013d2", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0xbdb49e024fb25bcef581f51d8e90c0667c3013d2_3930", "item_type": "erc721", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Fri, 21 Jan 2022 08:22:33 GMT", "acquisition_transaction_hash": "0xb5136fb6e942b248f6eba8d3f9d4539971ece0c02f3572f4c68fb4210544c36b", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_110285470574657408917971892665988722660517933657128765072726712934739642165008", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Thu, 20 Jan 2022 20:34:08 GMT", "acquisition_transaction_hash": "0x791b9d36a112189c012a6f447404e3f3f2237ae64481888163567bf1aa79755f", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_110285470574657408917971892665988722660517933657128765072726712804997270078440", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Tue, 25 Jan 2022 20:05:42 GMT", "acquisition_transaction_hash": "0x0f4191122703d30182c30dcc6ff66f7390b265c765921b94243d2b9b35250dbc", "asset_contract": "0x1ccbf04c6b2e88e1187d0b18eb5a856013890400", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x1ccbf04c6b2e88e1187d0b18eb5a856013890400_1834", "item_type": "erc721", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Mon, 14 Mar 2022 19:52:07 GMT", "acquisition_transaction_hash": "0x1c37d41b9f77160aa8c84b06bc019b04b3df2cb95ddd60ce63e221b6039b7742", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_104103992698705454582768022046262302786263141743841414824419568521033587631888", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Mon, 14 Mar 2022 22:09:39 GMT", "acquisition_transaction_hash": "0x3fdadbb31efb4d26ca55ad8a41d9a260e60859dde524854d6b288313be862d25", "asset_contract": "0x87dcfe3d1915c26cc8aad4e851f3765ffb085cde", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x87dcfe3d1915c26cc8aad4e851f3765ffb085cde_1912", "item_type": "erc721", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Wed, 09 Mar 2022 10:48:46 GMT", "acquisition_transaction_hash": "0x25293fd6fcd84403619f2e07cc0e1c5e31bc4ceca5b6ffe7a81e53071f8b6d2f", "asset_contract": "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x2953399124f0cbb46d2cbacd8a89cf0599974963_44503375309253988396066999025134117773656457345501738163498275092591783454480", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Sat, 26 Feb 2022 12:14:27 GMT", "acquisition_transaction_hash": "0x26aaaeb5c5f1903fd6db9287c2bff177c00e6c8d55ba2e9f7859725306a1dd7e", "asset_contract": "0x23a8c2ce858b2e66222567923641cb6417994caf", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x23a8c2ce858b2e66222567923641cb6417994caf_1", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Sun, 06 Mar 2022 15:44:05 GMT", "acquisition_transaction_hash": "0x5b9abc64a9e11c606a6500d082d7b47ab191a70fab0ab72c1ede7846318a0a74", "asset_contract": "0x51c792ca81b4520bc457f443dc26091dd4c87bcd", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x51c792ca81b4520bc457f443dc26091dd4c87bcd_4", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Sun, 13 Mar 2022 11:43:36 GMT", "acquisition_transaction_hash": "0xeaef5cfaa0e78202df695dc511c1dd1e28ebb121ea6dc4c2b0750de154aa4488", "asset_contract": "0x7ac04336b214ea81546685d2bf27222bc4ee02ea", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x7ac04336b214ea81546685d2bf27222bc4ee02ea_1", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null }, { "acquisition_network_id": "matic", "acquisition_timestamp": "Mon, 14 Mar 2022 11:05:06 GMT", "acquisition_transaction_hash": "0x06ba4a1e1fcc079485fe13d2ed5140a52c6040fa345452eed17f87bd7a1163c1", "asset_contract": "0x724de6381fb9e036b2c8a7d51c7980ed5bd70288", "cost_basis_eth": 0.0, "cost_basis_usd": 0.0, "floor_price_eth": null, "floor_price_usd": null, "item_id": "0x724de6381fb9e036b2c8a7d51c7980ed5bd70288_0", "item_type": "erc1155", "network_id": "matic", "original_estimated_price_eth": null, "original_estimated_price_usd": null } ], "total_cost_basis_eth": 0.0, "total_cost_basis_usd": 0.0, "total_estimated_price_eth": null, "total_estimated_price_usd": null, "total_floor_price_eth": null, "total_floor_price_usd": null } ], "response": 200 } ``` \*\*\*\* # Market Status API Endpoints * [/market-status/:network\_id/:asset\_contract](/market-status-api/nftbank-asset-api/asset-asset_contract-token_id) After getting access to API keys using [this form](https://nftbank.typeform.com/to/iZaK3tjj?typeform-source=docs.nftbank.ai), use the API commands in [API overview](/asset-api/nftbank-asset-api) to fetch data. # /market-status/:network\_id/:asset\_contract ## Get Daily Historical Status of a NFT collection `GET` `https://api.nftbank.ai/v3/market-status/:network_id/:asset_contract` This endpoint allows you to get NFT metadata #### Path Parameters | Name | Type | Description | | --------------- | ------ | ----------- | | asset\_contract | string | | | token\_id | string | | #### Query Parameters | Name | Type | Description | | ------------------------------------------- | ------ | ------------------------------ | | chain\_id\* | string | default: ethereum | | start\_date | string | default: current date - 7 days | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------- | | x-api-key\* | string | API key request via \[API key request] link. | {% tabs %} {% tab title="200 Cake successfully retrieved." %} ```json { "data": [ { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.000000000000000000", "blockDate": "2022-10-21T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.019900000000000001", "maxPriceEth": "0.000000000000000000", "minPriceEth": "0.000000000000000000", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 0.0, "p1SoldPriceEth": "0.000000000000000000", "p2SoldPriceEth": "0.000000000000000000", "p3SoldPriceEth": "0.000000000000000000", "p4SoldPriceEth": "0.000000000000000000", "p5SoldPriceEth": "0.000000000000000000", "p6SoldPriceEth": "0.000000000000000000", "p7SoldPriceEth": "0.000000000000000000", "p8SoldPriceEth": "0.000000000000000000", "p9SoldPriceEth": "0.000000000000000000", "todayListed": 2.0, "tokenType": "erc721", "totalListed": 47.0, "totalSupply": 4848.0, "tradeVolume": 0.0, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.019900000000000001", "blockDate": "2022-10-20T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.019900000000000001", "maxPriceEth": "0.019900000000000001", "minPriceEth": "0.019900000000000001", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 1.0, "p1SoldPriceEth": "0.019900000000000001", "p2SoldPriceEth": "0.019900000000000001", "p3SoldPriceEth": "0.019900000000000001", "p4SoldPriceEth": "0.019900000000000001", "p5SoldPriceEth": "0.019900000000000001", "p6SoldPriceEth": "0.019900000000000001", "p7SoldPriceEth": "0.019900000000000001", "p8SoldPriceEth": "0.019900000000000001", "p9SoldPriceEth": "0.019900000000000001", "todayListed": 1.0, "tokenType": "erc721", "totalListed": 46.0, "totalSupply": 4848.0, "tradeVolume": 0.0199, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.000000000000000000", "blockDate": "2022-10-19T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.019900000000000001", "maxPriceEth": "0.000000000000000000", "minPriceEth": "0.000000000000000000", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 0.0, "p1SoldPriceEth": "0.000000000000000000", "p2SoldPriceEth": "0.000000000000000000", "p3SoldPriceEth": "0.000000000000000000", "p4SoldPriceEth": "0.000000000000000000", "p5SoldPriceEth": "0.000000000000000000", "p6SoldPriceEth": "0.000000000000000000", "p7SoldPriceEth": "0.000000000000000000", "p8SoldPriceEth": "0.000000000000000000", "p9SoldPriceEth": "0.000000000000000000", "todayListed": 0.0, "tokenType": "erc721", "totalListed": 47.0, "totalSupply": 4848.0, "tradeVolume": 0.0, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.000000000000000000", "blockDate": "2022-10-06T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.020000000000000000", "maxPriceEth": "0.000000000000000000", "minPriceEth": "0.000000000000000000", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 0.0, "p1SoldPriceEth": "0.000000000000000000", "p2SoldPriceEth": "0.000000000000000000", "p3SoldPriceEth": "0.000000000000000000", "p4SoldPriceEth": "0.000000000000000000", "p5SoldPriceEth": "0.000000000000000000", "p6SoldPriceEth": "0.000000000000000000", "p7SoldPriceEth": "0.000000000000000000", "p8SoldPriceEth": "0.000000000000000000", "p9SoldPriceEth": "0.000000000000000000", "todayListed": 3.0, "tokenType": "erc721", "totalListed": 51.0, "totalSupply": 4848.0, "tradeVolume": 0.0, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.065000000000000002", "blockDate": "2022-10-05T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.020000000000000000", "maxPriceEth": "0.100000000000000006", "minPriceEth": "0.029999999999999999", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 2.0, "p1SoldPriceEth": "0.036999999999999998", "p2SoldPriceEth": "0.044000000000000004", "p3SoldPriceEth": "0.050999999999999997", "p4SoldPriceEth": "0.058000000000000003", "p5SoldPriceEth": "0.065000000000000002", "p6SoldPriceEth": "0.071999999999999995", "p7SoldPriceEth": "0.079000000000000001", "p8SoldPriceEth": "0.086000000000000007", "p9SoldPriceEth": "0.093000000000000013", "todayListed": 0.0, "tokenType": "erc721", "totalListed": 50.0, "totalSupply": 4848.0, "tradeVolume": 0.13, "varSoldPriceEth": "0.002450000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.014999999999999999", "blockDate": "2022-10-04T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.016400000000000001", "maxPriceEth": "0.014999999999999999", "minPriceEth": "0.014999999999999999", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 1.0, "p1SoldPriceEth": "0.014999999999999999", "p2SoldPriceEth": "0.014999999999999999", "p3SoldPriceEth": "0.014999999999999999", "p4SoldPriceEth": "0.014999999999999999", "p5SoldPriceEth": "0.014999999999999999", "p6SoldPriceEth": "0.014999999999999999", "p7SoldPriceEth": "0.014999999999999999", "p8SoldPriceEth": "0.014999999999999999", "p9SoldPriceEth": "0.014999999999999999", "todayListed": 1.0, "tokenType": "erc721", "totalListed": 53.0, "totalSupply": 4848.0, "tradeVolume": 0.015, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.000000000000000000", "blockDate": "2022-10-03T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.016400000000000001", "maxPriceEth": "0.000000000000000000", "minPriceEth": "0.000000000000000000", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 0.0, "p1SoldPriceEth": "0.000000000000000000", "p2SoldPriceEth": "0.000000000000000000", "p3SoldPriceEth": "0.000000000000000000", "p4SoldPriceEth": "0.000000000000000000", "p5SoldPriceEth": "0.000000000000000000", "p6SoldPriceEth": "0.000000000000000000", "p7SoldPriceEth": "0.000000000000000000", "p8SoldPriceEth": "0.000000000000000000", "p9SoldPriceEth": "0.000000000000000000", "todayListed": 1.0, "tokenType": "erc721", "totalListed": 53.0, "totalSupply": 4848.0, "tradeVolume": 0.0, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.012299999999999998", "blockDate": "2022-10-02T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.012999999999999999", "maxPriceEth": "0.012299999999999998", "minPriceEth": "0.012299999999999998", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 3.0, "p1SoldPriceEth": "0.012299999999999998", "p2SoldPriceEth": "0.012299999999999998", "p3SoldPriceEth": "0.012299999999999998", "p4SoldPriceEth": "0.012299999999999998", "p5SoldPriceEth": "0.012299999999999998", "p6SoldPriceEth": "0.012299999999999998", "p7SoldPriceEth": "0.012299999999999998", "p8SoldPriceEth": "0.012299999999999998", "p9SoldPriceEth": "0.012299999999999998", "todayListed": 0.0, "tokenType": "erc721", "totalListed": 58.0, "totalSupply": 4848.0, "tradeVolume": 0.036899999999999995, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.000000000000000000", "blockDate": "2022-10-01T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.012999999999999999", "maxPriceEth": "0.000000000000000000", "minPriceEth": "0.000000000000000000", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 0.0, "p1SoldPriceEth": "0.000000000000000000", "p2SoldPriceEth": "0.000000000000000000", "p3SoldPriceEth": "0.000000000000000000", "p4SoldPriceEth": "0.000000000000000000", "p5SoldPriceEth": "0.000000000000000000", "p6SoldPriceEth": "0.000000000000000000", "p7SoldPriceEth": "0.000000000000000000", "p8SoldPriceEth": "0.000000000000000000", "p9SoldPriceEth": "0.000000000000000000", "todayListed": 0.0, "tokenType": "erc721", "totalListed": 60.0, "totalSupply": 4848.0, "tradeVolume": 0.0, "varSoldPriceEth": "0.000000000000000000" } ], "message": "OK", "response": 200 } ``` {% endtab %} {% endtabs %} **curl request example** ```shell curl -i -H "x-api-key: YOUR_API_KEY" \ --request GET 'https://api.nftbank.ai/v3/market-status/ethereum/0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65?start_date=2022-10-19' \ -H 'Content-Type: application/json' ``` **curl response example** ```json { "data": [ { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.000000000000000000", "blockDate": "2022-10-21T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.019900000000000001", "maxPriceEth": "0.000000000000000000", "minPriceEth": "0.000000000000000000", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 0.0, "p1SoldPriceEth": "0.000000000000000000", "p2SoldPriceEth": "0.000000000000000000", "p3SoldPriceEth": "0.000000000000000000", "p4SoldPriceEth": "0.000000000000000000", "p5SoldPriceEth": "0.000000000000000000", "p6SoldPriceEth": "0.000000000000000000", "p7SoldPriceEth": "0.000000000000000000", "p8SoldPriceEth": "0.000000000000000000", "p9SoldPriceEth": "0.000000000000000000", "todayListed": 2.0, "tokenType": "erc721", "totalListed": 47.0, "totalSupply": 4848.0, "tradeVolume": 0.0, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.019900000000000001", "blockDate": "2022-10-20T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.019900000000000001", "maxPriceEth": "0.019900000000000001", "minPriceEth": "0.019900000000000001", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 1.0, "p1SoldPriceEth": "0.019900000000000001", "p2SoldPriceEth": "0.019900000000000001", "p3SoldPriceEth": "0.019900000000000001", "p4SoldPriceEth": "0.019900000000000001", "p5SoldPriceEth": "0.019900000000000001", "p6SoldPriceEth": "0.019900000000000001", "p7SoldPriceEth": "0.019900000000000001", "p8SoldPriceEth": "0.019900000000000001", "p9SoldPriceEth": "0.019900000000000001", "todayListed": 1.0, "tokenType": "erc721", "totalListed": 46.0, "totalSupply": 4848.0, "tradeVolume": 0.0199, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.000000000000000000", "blockDate": "2022-10-19T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.019900000000000001", "maxPriceEth": "0.000000000000000000", "minPriceEth": "0.000000000000000000", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 0.0, "p1SoldPriceEth": "0.000000000000000000", "p2SoldPriceEth": "0.000000000000000000", "p3SoldPriceEth": "0.000000000000000000", "p4SoldPriceEth": "0.000000000000000000", "p5SoldPriceEth": "0.000000000000000000", "p6SoldPriceEth": "0.000000000000000000", "p7SoldPriceEth": "0.000000000000000000", "p8SoldPriceEth": "0.000000000000000000", "p9SoldPriceEth": "0.000000000000000000", "todayListed": 0.0, "tokenType": "erc721", "totalListed": 47.0, "totalSupply": 4848.0, "tradeVolume": 0.0, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.000000000000000000", "blockDate": "2022-10-06T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.020000000000000000", "maxPriceEth": "0.000000000000000000", "minPriceEth": "0.000000000000000000", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 0.0, "p1SoldPriceEth": "0.000000000000000000", "p2SoldPriceEth": "0.000000000000000000", "p3SoldPriceEth": "0.000000000000000000", "p4SoldPriceEth": "0.000000000000000000", "p5SoldPriceEth": "0.000000000000000000", "p6SoldPriceEth": "0.000000000000000000", "p7SoldPriceEth": "0.000000000000000000", "p8SoldPriceEth": "0.000000000000000000", "p9SoldPriceEth": "0.000000000000000000", "todayListed": 3.0, "tokenType": "erc721", "totalListed": 51.0, "totalSupply": 4848.0, "tradeVolume": 0.0, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.065000000000000002", "blockDate": "2022-10-05T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.020000000000000000", "maxPriceEth": "0.100000000000000006", "minPriceEth": "0.029999999999999999", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 2.0, "p1SoldPriceEth": "0.036999999999999998", "p2SoldPriceEth": "0.044000000000000004", "p3SoldPriceEth": "0.050999999999999997", "p4SoldPriceEth": "0.058000000000000003", "p5SoldPriceEth": "0.065000000000000002", "p6SoldPriceEth": "0.071999999999999995", "p7SoldPriceEth": "0.079000000000000001", "p8SoldPriceEth": "0.086000000000000007", "p9SoldPriceEth": "0.093000000000000013", "todayListed": 0.0, "tokenType": "erc721", "totalListed": 50.0, "totalSupply": 4848.0, "tradeVolume": 0.13, "varSoldPriceEth": "0.002450000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.014999999999999999", "blockDate": "2022-10-04T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.016400000000000001", "maxPriceEth": "0.014999999999999999", "minPriceEth": "0.014999999999999999", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 1.0, "p1SoldPriceEth": "0.014999999999999999", "p2SoldPriceEth": "0.014999999999999999", "p3SoldPriceEth": "0.014999999999999999", "p4SoldPriceEth": "0.014999999999999999", "p5SoldPriceEth": "0.014999999999999999", "p6SoldPriceEth": "0.014999999999999999", "p7SoldPriceEth": "0.014999999999999999", "p8SoldPriceEth": "0.014999999999999999", "p9SoldPriceEth": "0.014999999999999999", "todayListed": 1.0, "tokenType": "erc721", "totalListed": 53.0, "totalSupply": 4848.0, "tradeVolume": 0.015, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.000000000000000000", "blockDate": "2022-10-03T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.016400000000000001", "maxPriceEth": "0.000000000000000000", "minPriceEth": "0.000000000000000000", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 0.0, "p1SoldPriceEth": "0.000000000000000000", "p2SoldPriceEth": "0.000000000000000000", "p3SoldPriceEth": "0.000000000000000000", "p4SoldPriceEth": "0.000000000000000000", "p5SoldPriceEth": "0.000000000000000000", "p6SoldPriceEth": "0.000000000000000000", "p7SoldPriceEth": "0.000000000000000000", "p8SoldPriceEth": "0.000000000000000000", "p9SoldPriceEth": "0.000000000000000000", "todayListed": 1.0, "tokenType": "erc721", "totalListed": 53.0, "totalSupply": 4848.0, "tradeVolume": 0.0, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.012299999999999998", "blockDate": "2022-10-02T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.012999999999999999", "maxPriceEth": "0.012299999999999998", "minPriceEth": "0.012299999999999998", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 3.0, "p1SoldPriceEth": "0.012299999999999998", "p2SoldPriceEth": "0.012299999999999998", "p3SoldPriceEth": "0.012299999999999998", "p4SoldPriceEth": "0.012299999999999998", "p5SoldPriceEth": "0.012299999999999998", "p6SoldPriceEth": "0.012299999999999998", "p7SoldPriceEth": "0.012299999999999998", "p8SoldPriceEth": "0.012299999999999998", "p9SoldPriceEth": "0.012299999999999998", "todayListed": 0.0, "tokenType": "erc721", "totalListed": 58.0, "totalSupply": 4848.0, "tradeVolume": 0.036899999999999995, "varSoldPriceEth": "0.000000000000000000" }, { "assetContract": "0x7c2e2ab0c04b3f0ec882ceb41462e8c998f11a65", "avgPriceEth": "0.000000000000000000", "blockDate": "2022-10-01T00:00:00+00:00", "collection": "themetastars", "collectionCount": 1, "floorPriceEth": "0.012999999999999999", "maxPriceEth": "0.000000000000000000", "minPriceEth": "0.000000000000000000", "mintTrades": 0.0, "networkId": "ethereum", "numTrades": 0.0, "p1SoldPriceEth": "0.000000000000000000", "p2SoldPriceEth": "0.000000000000000000", "p3SoldPriceEth": "0.000000000000000000", "p4SoldPriceEth": "0.000000000000000000", "p5SoldPriceEth": "0.000000000000000000", "p6SoldPriceEth": "0.000000000000000000", "p7SoldPriceEth": "0.000000000000000000", "p8SoldPriceEth": "0.000000000000000000", "p9SoldPriceEth": "0.000000000000000000", "todayListed": 0.0, "tokenType": "erc721", "totalListed": 60.0, "totalSupply": 4848.0, "tradeVolume": 0.0, "varSoldPriceEth": "0.000000000000000000" } ], "message": "OK", "response": 200 } ``` # Attribution & Usage Policy When displaying data using NFTBank API, you must abide by below rules. Violation of the policy may result in termination of API access. 1. Usage of NFTBank's Estimate & Floor API must be clearly attributed. 2. NFTBank logo must be included. ([Download Logo](https://www.notion.so/contxtsio/Media-Kit-1637ff057dea4dd3aed44e632ce9df19#f2bf8f8f46504ed1bc9054b1d3796892)) 3. Link to must be included.