Search NFTs

This endpoint returns a list of NFT assets by applying search filters in the request body. The assets are sorted by nftscan_id with ascending direction.

Note: when filtering data using only the block_number condition, the range between block_number_start and block_number_end cannot exceed 10000.

API Endpoint{apiKey}/nftscan




ParametersDescriptionsQuery TypeRequiredData Typeschema
chain_nameName of the chain you’re querying. List of supported values: "eth" for Ethereum; "bnb" for BNB Smart Chain; "polygon" for Polygon; "moonbeam" for Moonbeam; "arbitrum" for Arbitrum One; "optimism" for Optimism; "platon" for PlatON; "avalanche" for Avalanche; "cronos" for Cronos; "fantom" for Fantom; "gnosis" for Gnosis;pathtrue
  block_number_endFilter of end block numberfalseinteger(int64)
  block_number_startFilter of start block numberfalseinteger(int64)
  contract_address_listList of contract address. Maximum size is 10.falsearraystring
  cursorA cursor to retrieve the next pagefalsestring
  limitPage size. Defaults to 20, capped at 100falseinteger(int32)
  show_attributeWhether to obtain attributes for the assets option{false,true}falseboolean

Request Example:

  "block_number_end": 15000000,
  "block_number_start": 14000000,
  "contract_address_list": [],
  "cursor": "100",
  "limit": 20,
  "show_attribute": false


ParametersDescriptionsData Typeschema
codeResponse status code (200 means the request was successful, 4XX or 5XX means the request failed)integer(int32)integer(int32)
dataResponse data
  contentThe data contentarrayAssetModel
    amountThe amount of the NFTstring
    attributesList of attributesarrayAssetAttributeValueModel
      attribute_nameThe attribute namestring
      attribute_valueThe value for the attribute namestring
      percentageHow many items have this attribute valuestring
    content_typeThe content typestring
    content_uriThe content URI to displaystring
    contract_addressThe contract addressstring
    contract_nameThe name of the contractstring
    contract_token_idThe token ID of the NFT in Hexstring
    descriptionThe description to displaystring
    erc_typeThe erc type of the NFTstring
    external_linkExternal link to the original websitestring
    image_uriThe image URI to displaystring
    latest_trade_priceThe latest trade price for the itemnumber
    latest_trade_symbolThe latest trade symbol for the itemstring
    latest_trade_timestampThe latest trade timestamp in milliseconds for the iteminteger
    latest_trade_tokenThe latest trade token for the itemstring
    metadata_jsonThe metadata in JSON formatstring
    mint_priceThe price when the item was minted (null if the item is an ERC-1155 NFT)number
    mint_timestampThe timestamp in milliseconds when the item was mintedinteger
    mint_transaction_hashThe transaction hash when the item was mintedstring
    minterThe user address who minted the itemstring
    nameThe namestring
    nftscan_idThe unique ID generated for the item by NFTScanstring
    nftscan_uriThe image URI stored by NFTScan (null if not stored by NFTScan)string
    own_timestampThe timestamp in milliseconds when the item was owned (null if the item is an ERC-1155 NFT)integer
    ownerThe user address who owns the item now (null if the item is an ERC-1155 NFT)string
    rarity_rankThe rarity rank for the iteminteger
    rarity_scoreThe rarity score for the itemnumber
    small_nftscan_uriThe small image URI stored by NFTScan (null if not stored by NFTScan)string
    token_idThe token ID of the NFT in Numberstring
    token_uriThe token URIstring
  nextThe next cursor to be supplied as a query param to retrieve the next pagestring
  totalThe total of the results matching the queryinteger(int64)
msgError message when request failsstring


	"code": 200,
	"data": {
		"content": [
				"amount": "1",
				"attributes": [
						"attribute_name": "Background",
						"attribute_value": "Yellow",
						"percentage": "16.49%"
				"content_type": "image/png",
				"content_uri": "QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi",
				"contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
				"contract_name": "BoredApeYachtClub",
				"contract_token_id": "0x0000000000000000000000000000000000000000000000000000000000000001",
				"description": "",
				"erc_type": "erc721",
				"external_link": "",
				"image_uri": "QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi",
				"latest_trade_price": 38.77,
				"latest_trade_symbol": "WETH",
				"latest_trade_timestamp": 1652567645000,
				"latest_trade_token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
				"metadata_json": "{\"image\":\"ipfs://QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi\",\"attributes\":[{\"trait_type\":\"Mouth\",\"value\":\"Grin\"},{\"trait_type\":\"Clothes\",\"value\":\"Vietnam Jacket\"},{\"trait_type\":\"Background\",\"value\":\"Orange\"},{\"trait_type\":\"Eyes\",\"value\":\"Blue Beams\"},{\"trait_type\":\"Fur\",\"value\":\"Robot\"}]}",
				"mint_price": 0.7,
				"mint_timestamp": 1619133220000,
				"mint_transaction_hash": "0xcfb197f62ec5c7f0e71a11ec0c4a0e394a3aa41db5386e85526f86c84b3f2796",
				"minter": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
				"name": "#1",
				"nftscan_id": "NSB313FC3396961075",
				"nftscan_uri": "",
				"own_timestamp": 1619817106000,
				"owner": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
				"rarity_rank": 2668,
				"rarity_score": 1.06,
				"small_nftscan_uri": "",
				"token_id": "1",
				"token_uri": ""
		"next": "NS871DD6359B64187E",
		"total": 30000
	"msg": ""