NFTBank.ai
  • Introduction
  • Featured Partners
  • Disclaimer
  • [Premium] Valuation API
    • Historical Valuation API
      • /v3/estimated-price
      • /v3/floor-price
    • Realtime Valuation API
      • /v3/realtime-estimated-price
      • /v3/realtime-floor-price
  • NFTBank Price Estimate API
    • Estimated Price Endpoints
      • /dapp/list
      • /dapp/:dapp_id
      • /estimates/:asset_contract/:token_id
      • /estimates/bulk
    • Supported Collections
    • Price Estimate Performance
  • NFTBank Floor Price API
    • Floor Price Endpoints
      • /floor_price/dapp/list
      • /floor_price/dapp/:asset_contract
      • /floor_price/:asset_contract
      • /floor_price/:asset_contract/bulk
      • /floor_price/:asset_contract/:token_id
      • /floor_price/:asset_contract/:token_id/bulk
    • Supported Collections
  • Asset API
    • Asset API Endpoints
      • /asset/:asset_contract/:token_id
      • /asset-events/:asset_contract/:token_id
      • /collections/:asset_contract
  • User Inventory API
    • User Inventory API Endpoints
      • /user-inventory/:chain_id/:address
  • Market Status API
    • Market Status API Endpoints
      • /market-status/:network_id/:asset_contract
  • Additional Resources
    • Request for API key
    • Request for new APIs
    • Attribution & Usage Policy
    • Join Our Discord
Powered by GitBook
On this page

Was this helpful?

  1. NFTBank Price Estimate API
  2. Estimated Price Endpoints

/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")

{
    "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
}

curl request example

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

{
    "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
}
Previous/estimates/:asset_contract/:token_idNextSupported Collections

Last updated 3 years ago

Was this helpful?