Get transactions by contract

This endpoint returns a list of NFT transactions for an NFT contract address. The transactions are sorted by timestamp with descending direction.

API Endpoint

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

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

method_type:GET

Request:

Parameters	Descriptions	Query Type	Required	Data Type
contract_address	The NFT contract address defaultValue{0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d}	path	true	string
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
event_type	The NFT event type of the transaction(Mint, Transfer, Sale, Burn). Using ';' to separate multiple events	query	false	string
cursor	A cursor to retrieve the next page	query	false	string
limit	Page size. Defaults to 20, capped at 100	query	false	integer(int32)
sort_direction	option{desc,asc}	query	false	string

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