Skip to main content

Parameters

filter
object
required
Filter options

Returns

logs
array
Array of log objects

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:
TierChainsMax block range (inclusive)
DefaultAll other supported EVM chains20,000 blocks (toBlock − fromBlock ≤ 19,999)
Heavy chainsBase, Celo, Cronos1,000 blocks (toBlock − fromBlock ≤ 999)
MonadMonad10,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=YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "eth_getLogs", "params": [{"fromBlock": "latest", "toBlock": "latest", "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}], "id": 1}'