Skip to main content

getTokenTransfers

Parameters​

  • contractAddress :(string) REQUIRED - The token contract address
  • fromBlock : (string) OPTIONAL - Starting block for the query
  • toBlock : (string) OPTIONAL - Ending block for the query
  • pageSize : (integer) OPTIONAL - Number of records to be retrieved on one page
  • pageKey : (string) OPTIONAL - Key used to get the next page of results. Must be set to the value of nextPageKey returned in the previous response

Returns​

  • contractAddress: <string> - The token contract address
  • contractDecimals : <string> - Token decimals specified in the contract
  • contractName: <string> - The name of the token
  • contractSymbols: <string> - The name of the token
  • count : <integer> - The number of transfers
  • nextPageKey: <string> - Key to get the next page of results, if more results are available
  • tokenTransfers: <array> - The array of Token Transfers for the specified token contract
    • fromAddress : <string> - The wallet address from which tokens were transferred
    • toAddress : <string> - Destination wallet address
    • value : <string> - The amount of tokens to be transferred
    • blockHash : <string> - The hash of the block in which the transfer transaction was executed
    • blockNumber : <integer> - The height of the block in which the transfer transaction was executed
    • blockTimestamp : <string> - The timestamp of the block in which the transfer transaction was executed
    • transactionHash: <string>- The hash of the token transfer transaction
    • transactionIndex: <integer> - The number or the token transfer transaction
    • logIndex : <integer> - The index of the transaction log

Example Request and Result for getTokenTransfers​

Request

curl --location 'https://eth-mainnet.blastapi.io/<project-id>/builder/getTokenTransfers?contractAddress=0x013062189dc3dcc99e9Cee714c513033b8d99e3c&pageSize=1&fromBlock=188505&toBlock=18188504'

Result

{
    "contractAddress": "0x013062189dc3dcc99e9cee714c513033b8d99e3c",
    "contractDecimals": "18",
    "contractName": "Bware",
    "contractSymbol": "INFRA",
    "count": 1,
    "nextPageKey": "MWNiOWMzZDJjMjkzOjE2OTg2NzU4NDk6MTgxODYxMzI6NDAwMDAxOTAwMDAwMDpCd2FyZTpJTkZSQToxOA",
    "tokenTransfers": [
        {
            "fromAddress": "0xd891830c826a8b0b2205ee9b6581d37a3efdf9af",
            "toAddress": "0x7e20e121ded9ed7c67b4971eed536e8f82873df3",
            "value": "753153937504918480988",
            "blockHash": "0x8c94a152fa30958f289803e783f0da34fba305ad4399ed5a3dada6a2e18dc40d",
            "blockNumber": 18186132,
            "blockTimestamp": "2023-09-21T18:47:59.000Z",
            "transactionHash": "0x4b3bd6e0c0694639162ae1c40a6745ea4308d33898f832e18ea069a6dccef036",
            "transactionIndex": 4,
            "logIndex": 19
        }
    ]
}