Links

getLogs

Get blockchain logs matching the given filters

Parameters

  • fromBlock : (string) OPTIONAL - Starting block for logs retrieval (default latest)
  • toBlock : (string) OPTIONAL - Ending block for logs retrieval (default latest)
  • blockHash : (string) - Block hash for retrieving all logs within a single block (equivalent to fromBlock = toBlock)
  • contractAddress :(string) OPTIONAL - The address of the log events sender contract
  • topic0 : (string) OPTIONAL - Topic hash to retrieve logs with
  • topic1 : (string) OPTIONAL - Topic hash to retrieve logs with
  • topic2 : (string) OPTIONAL - Topic hash to retrieve logs with
  • topic3 : (string) OPTIONAL - Topic hash to retrieve logs with
  • 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

  • count: <integer> - The number of the logs returned
  • nextPageKey : <string> - Key to get the next page of results, if more results are available
  • logs: <array> - The array of Log objects
    • blockHash : <string> - The hash of the block containing the logs
    • blockNumber : <integer> - The height of the block containing the logs
    • blockTimestamp : <string> - The timestamp of the block containing the logs
    • transactionHash: <string>- Log transaction hash
    • transactionIndex: <integer> - Log transaction number
    • contractAddress : <string> - The address of the contract generating the log
    • topic0 : (string) - Topic to describe the log event, usually the first topic is the signature of the event name
    • topic1 : (string) - Topic to describe the log event
    • topic2 : (string) - Topic to describe the log event
    • topic3 : (string) - Topic to describe the log event
    • data: <string> - Additional data of the log event

Example Request and Result for getLogs

Request
curl --location 'https://eth-mainnet.blastapi.io/<project-id>/builder/getLogs?blockHash=0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2'
Result
{
"count": 198,
"logs": [
{
"blockHash": "0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2",
"blockNumber": 18375873,
"blockTimestamp": "2023-10-18T07:51:59.000Z",
"transactionHash": "0x2c40ee001352cfb73a2047c0ec71f016a1bd02e7fa2ed35adeaee46ca0c7719e",
"transactionIndex": 0,
"logIndex": 0,
"contractAddress": "0xf482d79ae6e8725c199213fc909d6bc30df62815",
"topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1": "0x000000000000000000000000e65f60ae20998b6cb2d2a6edb2e551843e7bb816",
"topic2": "0x000000000000000000000000c99d5ae8a7c36325294c2424928bd776ab63f8b7",
"data": "0x000000000000000000000000000000000000000000000000007e5196c1911e00"
},
{
"blockHash": "0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2",
"blockNumber": 18375873,
"blockTimestamp": "2023-10-18T07:51:59.000Z",
"transactionHash": "0x9befb89d0180358d300180c24530d9a16382ef770ec3eddab641e878d71d64e6",
"transactionIndex": 1,
"logIndex": 1,
"contractAddress": "0x9b1f3625980e6acb153da8b06235923845ecca01",
"topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1": "0x000000000000000000000000e29a909a294896c167adc29a05681ff987a1d145",
"topic2": "0x000000000000000000000000ca53029a981a807c78c7cde496c5b52ef4532445",
"data": "0x00000000000000000000000000000000000000000000000000000003866a1100"
},
```