This endpoint returns a list of NFT transactions filtered by the param 'to' of the transaction. The transactions are sorted by timestamp with descending direction.
API Endpoint
https://open-platform.nodereal.io/{apiKey}/nftscan
method_path:/api/v2/transactions/to/{to_address}/{chain_name}
method_type:GET
Request:
Parameters | Descriptions | Query Type | Required | Data Type | schema |
---|---|---|---|---|---|
to_address | The to address of the transactiondefaultValue{0x3b968d2d299b895a5fcf3bba7a64ad0f566e6f88} | 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": ""
}