Search transactions

This endpoint returns a list of NFT transactions by applying search filters in the request body. The transactions are sorted by timestamp with descending 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
  event_typeThe NFT event type of the transaction(Mint, Transfer, Sale, Burn). Using ';' to separate multiple eventsfalsestring
  limitPage size. Defaults to 20, capped at 100falseinteger(int32)

Request Example:

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


ParametersDescriptionsData Typeschema
codeResponse status code (200 means the request was successful, 4XX or 5XX means the request failed)integer(int32)integer(int32)
dataResponse dataICursor«TransactionModel »ICursor«TransactionModel »
  contentThe data contentarrayTransactionModel
    aggregate_exchange_nameThe NFT aggregate trading exchange namestring
    amountThe amount of the NFTstring
    block_hashThe block hashstring
    block_numberThe block numberinteger
    contract_addressThe contract addressstring
    contract_nameThe name of the contractstring
    contract_token_idThe token ID of the NFT in Hexstring
    erc_typeThe erc type of the NFTstring
    event_typeThe NFT event type of the transaction(Mint, Transfer, Sale, Burn)string
    exchange_nameThe NFT trading exchange namestring
    fromThe param from of the transactionstring
    gas_feeThe transaction fee in Decimalnumber
    gas_priceThe gas price in Hexstring
    gas_usedHow much gas was used in the transaction in Hexstring
    hashTransaction hashstring
    nftscan_tx_idThe unique ID generated for the transaction record by NFTScanstring
    receiveThe user address who received the NFTstring
    sendThe user address who sent the NFTstring
    timestampThe timestamp in milliseconds of the transactioninteger
    toThe param to of the transactionstring
    token_idThe token ID of the NFT in Numberstring
    trade_priceThe trade price of the transaction in Numbernumber
    trade_symbolThe trade symbol of the trade pricestring
    trade_symbol_addressThe trade symbol contract address (Default null for the native cryptocurrency)string
    trade_valueThe trade value of the transaction in Hexstring
  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": [
				"aggregate_exchange_name": "OpenSea",
				"amount": "1",
				"block_hash": "0xa367b094366bc68de295ae6167797afc55eeb8383869363a6d7eb143c31d8274",
				"block_number": 12344148,
				"contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
				"contract_name": "BoredApeYachtClub",
				"contract_token_id": "0x0000000000000000000000000000000000000000000000000000000000000001",
				"erc_type": "erc721",
				"event_type": "Transfer",
				"exchange_name": "OpenSea",
				"from": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
				"gas_fee": 0.004801802,
				"gas_price": "0xab5d04c00",
				"gas_used": "0x197c3",
				"hash": "0xe93e858f9330afa4581e260198195623aa7f5cd2809012440ea291d317be9f2f",
				"nftscan_tx_id": "1234414801540001",
				"receive": "0x46efbaedc92067e6d60e84ed6395099723252496",
				"send": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
				"timestamp": 1619133220000,
				"to": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
				"token_id": "1",
				"trade_price": 0.1,
				"trade_symbol": "ETH",
				"trade_symbol_address": "",
				"trade_value": "0x0"
		"next": "NS871DD6359B64187E",
		"total": 30000
	"msg": ""