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

https://open-platform.nodereal.io/{apiKey}/nftscan

method_path:/api/v2/transactions/filters/{chain_name}

method_type:POST

Request:

Parameters	Descriptions	Query Type	Required	Data Type	schema
chain_name	Name 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;	path	true
NftRecordByParameterReq	NftRecordByParameterReq	body	true	NftRecordByParameterReq	NftRecordByParameterReq
block_number_end	Filter of end block number		false	integer(int64)
block_number_start	Filter of start block number		false	integer(int64)
contract_address_list	List of contract address. Maximum size is 10.		false	array	string
cursor	A cursor to retrieve the next page		false	string
event_type	The NFT event type of the transaction(Mint, Transfer, Sale, Burn). Using ';' to separate multiple events		false	string
limit	Page size. Defaults to 20, capped at 100		false	integer(int32)

Request Example:

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

Response:

Parameters	Descriptions	Data Type	schema
code	Response status code (200 means the request was successful, 4XX or 5XX means the request failed)	integer(int32)	integer(int32)
data	Response data	ICursor«TransactionModel »	ICursor«TransactionModel »
content	The data content	array	TransactionModel
aggregate_exchange_name	The NFT aggregate trading exchange name	string
amount	The amount of the NFT	string
block_hash	The block hash	string
block_number	The block number	integer
contract_address	The contract address	string
contract_name	The name of the contract	string
contract_token_id	The token ID of the NFT in Hex	string
erc_type	The erc type of the NFT	string
event_type	The NFT event type of the transaction(Mint, Transfer, Sale, Burn)	string
exchange_name	The NFT trading exchange name	string
from	The param `from` of the transaction	string
gas_fee	The transaction fee in Decimal	number
gas_price	The gas price in Hex	string
gas_used	How much gas was used in the transaction in Hex	string
hash	Transaction hash	string
nftscan_tx_id	The unique ID generated for the transaction record by NFTScan	string
receive	The user address who received the NFT	string
send	The user address who sent the NFT	string
timestamp	The timestamp in milliseconds of the transaction	integer
to	The param `to` of the transaction	string
token_id	The token ID of the NFT in Number	string
trade_price	The trade price of the transaction in Number	number
trade_symbol	The trade symbol of the trade price	string
trade_symbol_address	The trade symbol contract address (Default null for the native cryptocurrency)	string
trade_value	The trade value of the transaction in Hex	string
next	The next cursor to be supplied as a query param to retrieve the next page	string
total	The total of the results matching the query	integer(int64)
msg	Error message when request fails	string

Example:

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