nr_getAssetTransfers

This API method helps you to get the transfers for any address, block, etc.

📘

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

Parameters

  • category - example: List [ "external", "20" ]; ------ external, internal; 20, 721, 1155;
  • fromBlock - hexadecimal string or latest, the difference between fromBlock and toBlock must be less than or equal to 1000, when both are specified. If the request has fromBlock but miss toBlock, toBlock will be auto-filled by fromBlock+1000
  • toBlock - hexadecimal string or latest, the difference between fromBlock and toBlock must be less than or equal to 1000, when both are specified. If the request has toBlock but miss fromBlock, fromBlock will be auto-filled by toBlock-1000
  • contractAddresses - contract addresses array; max items: 100
  • fromAddress - string
  • toAddress - string
  • order - option: asc or desc
  • transactionHash - string
  • excludeZeroValue - boolean, true for excluding zero value data, false for all data
  • maxCount - hex encoded value, define once request return data count, max value:0x3E8
  • PageKey - uuid for pagination. If more results are available, a uuid pageKey will be returned in the response. Pass that uuid into pageKey to fetch the next maxCount. For first page, don't need this param.

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
      }
    ]
  }
}