eth_getLogs

eth_getLogs returns every event log on the Avalanche C-Chain that matches a filter object — a block range (or a single blockHash), one or more contract addresses, and indexed topic filters. It is the primary method for one-shot log queries and for backfilling an indexer over historical blocks, which is how most analytics and DeFi dashboards reconstruct activity from Aave, Trader Joe, or GMX, all of which spend AVAX on gas. Unlike the stateful filter calls, it needs no prior eth_newFilter registration. Send it to https://avalanche.therpc.io/YOUR_API_KEY (chain ID 43114, 0xa86a) and the node returns the full array of matching logs.

Use cases

• Backfill ERC-20 Transfer events for a C-Chain token over a historical block range to seed balances or holder lists.
• Index DeFi protocol events — swaps, deposits, liquidations from Trader Joe, Aave, or GMX — into an analytics dashboard.
• Reconstruct a contract's state by replaying its past events when no view function exposes the data directly.
• Verify that a specific event was emitted inside a given transaction by filtering on its blockHash and topics.

Parameters

Response

Example request

1curl https://avalanche.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_getLogs",
7    "params": [{}],
8    "id": 1
9  }'

Try it live in the Avalanche playground.

Errors & troubleshooting

Common pitfalls

• Logs from not-yet-finalized C-Chain blocks can vanish in a reorg; check each log's removed field and re-query once the block is finalized before trusting the data.
• Wide block ranges or a filter with no address/topic constraints invite provider-side timeouts or range/result-cap errors — paginate in chunks of roughly 1,000–5,000 blocks.
• Looping eth_getLogs with fromBlock: "latest" to watch for new events is wasteful given the C-Chain's fast blocks; use eth_newFilter + eth_getFilterChanges or eth_subscribe for live tailing instead.

Supported networks

• Mainnet — Chain ID: 43114
• Fuji

See also

• eth_newFilter
• eth_getFilterLogs
• eth_subscribe

1curl https://avalanche.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getLogs","params":[{}]}'