nft

Historical Transactions

Retrieves a chronological list of historical NFT transactions for a specified collection on Ethereum, with customizable block ranges, pagination, and sorting. The response includes comprehensive details (block numbers, timestamps, transaction hashes, addresses, token IDs, gas metrics) to facilitate NFT auditing, market analysis, and dashboard integrations.

💡 Compute Unit Value: 90 (Fixed)

get/defi/v1/nft/historicaltransactions

Request

Base URL
https://svc.blockdaemon.com
URL
https://svc.blockdaemon.com/defi/v1/nft/historicaltransactions
Auth
API key in header X-API-Key

Query parameters

chainId'1'

The unique ID to direct queries or transactions to the correct blockchain. Find more here.

Example:1

chainSymbolstring

The abbreviated chain name for queries or transactions.

Example:ETH

nftCollectionstring required

The smart contract address of the NFT collection whose balance is to be retrieved.

Example:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D

nftProtocolIdstring

Specifies the NFT standard to use for the query. Acceptable values are 721 for ERC-721 tokens and 1155 for ERC-1155 tokens. If not provided, the default value is 721

Example:721

startBlockstring

Specifies the starting block number for the event log query. If not provided, the default value is set to 100 blocks prior to the latest finalized block, ensuring a recent historical range is returned.

Example:100000

pagestring

Indicates the page number for paginated results. Defaults to '1' if no value is specified, allowing for easy navigation through large sets of log data.

Example:1

endBlockstring

Specifies the ending block number for the event log query. If omitted, the default is the latest finalized block, capturing all events up to the most recent block.

Example:100010

sort'desc' | 'asc'

Determines the order in which the transactions are returned. Acceptable values are 'asc' for ascending order and 'desc' for descending order. If not provided, the default value is 'desc', which returns the most recent logs first.

Example:desc

Response

Successful response

statusinteger

msgstring

dataobject

Example response

{
  "status": 200,
  "msg": "success",
  "data": {
    "transactions": [
      {
        "blockNumber": "18968332",
        "timeStamp": "1704790283",
        "hash": "0x719286621b2b2e4aeda8e61a0ce2e58bd6f4806d1d411653172ec5380ec2c3d6",
        "nonce": "722",
        "blockHash": "0x6929852257b9d94b5f9b5908d851a25488d3a2afd11c103229f7a8fb305b5898",
        "from": "0x2efdb6dd6daa243fdf30cac2391adb8350d5e322",
        "contractAddress": "0x306b1ea3ecdf94ab739f1910bbda052ed4a9f949",
        "to": "0xae78174d3ab843dd349acb975ed1b3b1431a55e8",
        "tokenID": "769",
        "tokenName": "Beanz",
        "tokenSymbol": "BEANZ",
        "tokenDecimal": "0",
        "transactionIndex": "43",
        "gas": "173141",
        "gasPrice": "16138857662",
        "gasUsed": "128215",
        "cumulativeGasUsed": "9277786",
        "input": "deprecated",
        "confirmations": "513",
        "methodId": "0x00000000",
        "methodSignature": "get_block_hash_257335279069929(uint256)"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.