eth_getLogs - Polygon PoS

post https://{network}.g.alchemy.com/v2/{apiKey}

Returns an array of all logs matching a given filter object.

🚧
Log Limits
You can make eth_getLogs requests on any block range with a cap of 10K logs in the response OR a 2K block range with no cap on logs in the response and 150MB limit on the response size
If you need to pull logs frequently, we recommend using WebSockets to push new logs to you when they are available.

📘
Understanding Logs
Want to understand how logs and events work on the EVM? Check out this guide: Understanding Logs: Deep Dive into eth_getLogs

Path Params

apiKey

string

required

Defaults to docs-demo

For higher throughput, create your own API key

Body Params

integer

Defaults to 1

jsonrpc

string

Defaults to 2.0

method

string

Defaults to eth_getLogs

params

array of objects

length between 1 and 1

params

blockHash

string

Using blockHash is equivalent to fromBlock = toBlock = the block number with hash blockHash. If blockHash is present in the filter criteria, then neither fromBlock nor toBlock are allowed.

address

array of strings

Defaults to 0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907

Contract address or a list of addresses from which logs should originate.

address

fromBlock

string

Defaults to 0x429d3b

String - Either the hex value of a block number OR block tags:

block number (in hex) OR
block tag (one of the following):

* `pending` (Not available on Ethereum) - A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool. Intuitively, you can think of these as blocks that have not been mined yet.
* `latest` - The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions.
* `safe` - The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination. Intuitively, this block is “unlikely” to be re-orged.
* `finalized` - The most recent crypto-economically secure block, that has been accepted by >2/3 of validators. Cannot be re-orged outside of manual intervention driven by community coordination. Intuitively, this block is very unlikely to be re-orged.
* `earliest` - The lowest numbered block the client has available. Intuitively, you can think of this as the first block created.

toBlock

string

Defaults to latest

String - Either the hex value of a block number OR block tags:

block number (in hex) OR
block tag (one of the following):

* `pending` (Not available on Ethereum) - A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool. Intuitively, you can think of these as blocks that have not been mined yet.
* `latest` - The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions.
* `safe` - The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination. Intuitively, this block is “unlikely” to be re-orged.
* `finalized` - The most recent crypto-economically secure block, that has been accepted by >2/3 of validators. Cannot be re-orged outside of manual intervention driven by community coordination. Intuitively, this block is very unlikely to be re-orged.
* `earliest` - The lowest numbered block the client has available. Intuitively, you can think of this as the first block created.

topics

array of strings

Defaults to 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef,0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75,0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078

Array of 32 Bytes DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.

topics

Response

Response body

object

integer

jsonrpc

string

result

array of objects

Array of log objects, or an empty array if nothing has changed since last poll.

result

object

blockHash

string

32 Bytes - hash of the block where this log was in. null when its pending. null when its pending log

blockNumber

string

The block number where this log was in. null when its pending. null when its pending log.

transactionIndex

string

Integer of the transactions index position log was created from. null when its pending log.

address

string

20 Bytes - address from which this log originated.

logIndex

string

Integer of the log index position in the block. null when its pending log.

data

string

Contains one or more 32 Bytes non-indexed arguments of the log.

removed

boolean

true when the log was removed, due to a chain reorganization. false if its a valid log.

topics

array of strings

Array of zero to four 32 Bytes DATA of indexed log arguments. In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declare the event with the anonymous specifier.

topics

transactionHash

string

Hash of the transactions this log was created from. null when its pending log.

Language

URL

Request


xxxxxxxxxx
25
1
curl --request POST \
2
     --url https://polygon-mainnet.g.alchemy.com/v2/docs-demo \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "id": 1,
8
  "jsonrpc": "2.0",
9
  "method": "eth_getLogs",
10
  "params": [
11
    {
12
      "address": [
13
        "0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907"
14
      ],
15
      "fromBlock": "0x429d3b",
16
      "toBlock": "latest",
17
      "topics": [
18
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
19
        "0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75",
20
        "0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078"
21
      ]
22
    }
23
  ]
24
}

Click Try It! to start a request and see the response here! Or choose an example:

application/json

ReadMe

Support Hub

eth_getLogs - Polygon PoS

🚧
Log Limits

📘
Understanding Logs

APIs

DEVELOPERS

Company

CONTACT

🚧Log Limits

📘Understanding Logs

200Returns array of log objects, or an empty array if nothing has changed since last poll.

APIs

DEVELOPERS

Company

CONTACT

🚧
Log Limits

📘
Understanding Logs