Get transactions by account

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

API Endpoint

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

method_path:/api/v2/transactions/account/{account_address}/{chain_name}

method_type:GET

Request:

ParametersDescriptionsQuery TypeRequiredData Typeschema
account_addressThe account addressdefaultValue{0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813}pathtruestring
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
contract_addressThe NFT contract address. Required if token_id is not nullqueryfalsestring
token_idThe NFT token ID. Can be in Hex or in Numberqueryfalsestring
event_typeThe NFT event type of the transaction(Mint, Transfer, Sale, Burn). Using ';' to separate multiple eventsqueryfalsestring
cursorA cursor to retrieve the next pagequeryfalsestring
limitPage size. Defaults to 20, capped at 100queryfalseinteger(int32)
sort_directionoption{desc,asc}queryfalsestring

Response:

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

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