nr_getAssetTransfers

📘

Supported on BSC and ETH mainnet only.
Similar feature to Docs on EtherScan.

Parameters

• category A list of category identifiers. Supported values include "external", "20", "721", and "1155".

  • external refers specifically to normal transactions, the same meaning as Etherscan’s “Normal Transactions”. This includes native coin transfers (e.g., BNB/ETH) between EOAs, or contract interactions that do not emit ERC-20/721/1155 transfer events.
  • "20" indicates ERC-20 transfer events.
  • "721" indicates ERC-721 NFT transfer events.
  • "1155" indicates ERC-1155 transfer events.

• fromBlock A hexadecimal block number or "latest". If both fromBlock and toBlock are provided, their range must be no more than 1000 blocks. If only fromBlock is provided, toBlock is auto-filled as fromBlock + 1000.

• toBlock A hexadecimal block number or "latest". If both are provided, difference must be ≤ 1000 blocks. If only toBlock is provided, fromBlock is auto-filled as toBlock - 1000.

• contractAddresses Array of contract addresses. Maximum 100 items.

• fromAddress Optional filter for the sender address.

• toAddress Optional filter for the recipient address.

• order Sorting order, either "asc" or "desc".

• transactionHash A specific transaction hash to filter by.

• maxCount Hex-encoded integer specifying max number of returned results. Maximum allowed value: 0x3E8 (1000 decimal).

• pageKey A UUID used for pagination. Omit for the first request; include it to fetch subsequent pages.

Returns

• PageKey - string, page key for next page query
• transfers - details
  • category - external or internal
  • blockNum - number
  • from - string, from addresss
  • to - string, to address
  • value - hexadecimal string, raw transfer value
  • erc721TokenId - 32-byte fixed-length hexadecimal string
  • erc1155MetaData - string, page key for next page query
    • tokenId - hexadecimal string
    • value - hexadecimal string, raw transfer value
  • asset - ETH/BNB or the token's symbol. null if not defined in the contract and not available from other sources.
  • hash - string, transaction hash
  • contractAddress - contract address (hex string). null if external transfer
  • decimal - contract decimal (hex string). null if not defined in the contract and not available from other sources.
  • blockTimestamp - timestamp of the block from which the transaction event originated
  • gasPrice - gas price for external transfer, not return when category is others
  • gasUsed - gas used for external transfer, not return when category is others
  • receiptsStatus - receipt status, 1 is success,0 is failed

API Endpoint

The format of a MegaNode API endpoint is https://{chain}-{network}.nodereal.io/v1/{API-key}
Here is an example:

https://bsc-mainnet.nodereal.io/v1/4c0a1c23661a4e26bcbcwed461e34ea9

For other chains or networks, you could refer to this guidance Find API key & endpoint.

Example

Request

curl https://eth-mainnet.nodereal.io/v1/your-api-key \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"nr_getAssetTransfers","params":[{"category": ["external","20"],"fromBlock": "0xE81916","toBlock": "0xE81917","order": "asc","excludeZeroValue": false,"maxCount": "0x5","pageKey": "qg000000-0075-RyKy-efk2-Fx9n32gAu432"}],"id":1}'

Result

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "pageKey": "qh000000-0X5j-WSqq-mCLq-kPfWRH8B1GPS",
    "transfers": [
      {
        "category": "external",
        "blockNum": "0x6c92dd",
        "from": "0x646eafba97ec6ee7631887cdee468b323dd65d4f",
        "to": "0x8f07f7312f3ede8b0094f09ab1554c8d89f47ddf",
        "value": "0x0",
        "asset": "BNB",
        "hash": "0xf7605ce61c1855348cde8512d752265a8cbbf57e0ac4c8bc259155f8c1592838",
        "blockTimeStamp": 1620089457,
        "gasPrice": 5000000000,
        "gasUsed": 35813,
        "receiptsStatus": 1
      },
      {
        "category": "20",
        "blockNum": "0x3b8322",
        "from": "0x0554a5d083abf2f056ae3f6029e1714b9a655174",
        "to": "0x28451d455f009a30b37bbe74175c9f3460f45cc7",
        "value": "0x00000000000000000000000000000000000000000000000564d702d38f5e0000",
        "asset": "TWT",
        "hash": "0xc16db18719864e6188578d5870e6f30e84d93c52beeb3630ead1a251e460ce4b",
        "contractAddress": "0x4b0f1812e5df2a09796481ff14017e6005508003",
        "decimal": "18",
        "blockTimeStamp": 1610380207
      },
      {
        "category": "721",
        "blockNum": "0xe97966",
        "from": "0x0000000000000000000000000000000000000000",
        "to": "0xa35ea428864f790f76b80d834b7dbe4340fd8d90",
        "value": "0x0",
        "erc721TokenId": "0x000000000000000000000000000000000000000000000000000000000016ed41",
        "asset": "SpaceShip",
        "hash": "0x6ed64468e1ee365e9670ec373eecdae2ff186d3354e2f88824eddd8d2f1bcccd",
        "contractAddress": "0x25828c7d4914694cbb514bb8f88ef94e715e4819",
        "blockTimeStamp": 1644998842
      },
      {
        "category": "1155",
        "blockNum": "0xeed938",
        "from": "0x0000000000000000000000000000000000000000",
        "to": "0x3acd618733de89269496768784d6b07f844ce480",
        "value": "0x0",
        "erc1155Metadata": [
          {
            "tokenId": "51c7d5f32f7dee06107a3d522b6e0902521ba99806e191acd74b349e00000001",
            "value": "0000000000000000000000000000000000000000000000000000000000000001"
          }
        ],
        "asset": "MELOSPRELUDE1",
        "hash": "0xa931aab01613dce9ab17f22caad4efa3fd209785f675c5d81f19b10179d2f631",
        "contractAddress": "0x42616b05cfe1af50e4488c8930d7e7d65bf87ce9",
        "blockTimeStamp": 1646059155
      }
    ]
  }
}