eth_getLogs - Edge RPC - Goldsky Docs

Parameters

object

required

Filter options

Show properties

string

Start block (hex), or latest, earliest, pending

string

End block (hex), or latest, earliest, pending

string | array

Contract address or list of addresses

array

Array of topic filters (32 bytes each). Use null for wildcard.

string

Filter by specific block hash. Cannot use with fromBlock/toBlock.

Returns

array

Array of log objects

Show properties

string

Address of log origin

array

Array of indexed log arguments

string

Non-indexed arguments (hex)

string

Block number (hex)

string

Transaction hash

string

Transaction index (hex)

string

Block hash

string

Log index in block (hex)

boolean

true if removed due to reorg

Limits

eth_getLogs requests on the edge endpoint are capped per request. The block-range cap varies by chain; address and topic caps apply uniformly across all chains. Address and topic caps (all chains):

Addresses: up to 1,000 addresses in address
Topics: up to 16 values in topics[0]

Block-range cap by chain tier:

Tier	Chains	Max block range (inclusive)
Default	All other supported EVM chains	20,000 blocks (`toBlock − fromBlock ≤ 19,999`)
Heavy chains	Base, Celo, Cronos	1,000 blocks (`toBlock − fromBlock ≤ 999`)
Monad	Monad	10,000 blocks (`toBlock − fromBlock ≤ 9,999`)

Heavy chains have lower caps because their wide-range scans can return very large responses (e.g. a ~12.5k-block Transfer scan on Base can produce ~740 MB). Requests exceeding these limits are rejected with an ErrGetLogsExceededMaxAllowedRange error (HTTP 413). To query a larger range, split the request into multiple calls under the per-chain cap.

Example

curl -X POST "https://edge.goldsky.com/standard/evm/1?secret=demo" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "eth_getLogs", "params": [{"fromBlock": "latest", "toBlock": "latest", "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}], "id": 1}'

const response = await fetch('https://edge.goldsky.com/standard/evm/1?secret=demo', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "latest",
      "toBlock": "latest",
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
    }
  ],
  "id": 1
})
});
const { result } = await response.json();
console.log(result);

import requests

response = requests.post(
    'https://edge.goldsky.com/standard/evm/1?secret=demo',
    json={
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "latest",
      "toBlock": "latest",
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
    }
  ],
  "id": 1
}
)
print(response.json()['result'])

​Parameters

​Returns

​Limits

​Example

Parameters

Returns

Limits

Example