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}'

const response = await fetch('https://edge.goldsky.com/standard/evm/1?secret=YOUR_SECRET', {
  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=YOUR_SECRET',
    json={
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "latest",
      "toBlock": "latest",
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
    }
  ],
  "id": 1
}
)
print(response.json()['result'])