Skip to navigation

eth_getLogs

Returns an array of all logs matching a given filter object. The filter object can contain address, topics, fromBlock, toBlock, and blockHash parameters (blockHash is mutually exclusive with fromBlock/toBlock).

Provider limits: Conduit-hosted RPCs enforce a maximum block range of 2,000 blocks per eth_getLogs call and a maximum of 10,000 log events per response. Requests exceeding either limit are rejected. To work with large historical ranges, chunk the request into smaller windows. For single-block queries, use blockHash instead of fromBlock/toBlock — it has no range limit and is reorg-safe (the request will fail rather than return stale logs if the block has been re-orged out).

⚡ Compute Units: 75 CU

Request

This endpoint expects an object.
filterobjectRequired
Filter options object

Response

Array of log objects
transactionHashstringformat: "^0x[0-9a-fA-F]{64}$"
removedbooleanOptional
logIndexstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
transactionIndexstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
blockHashstringOptionalformat: "^0x[0-9a-fA-F]{64}$"
blockNumberstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
blockTimestampstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
addressstringOptionalformat: "^0x[0-9a-fA-F]{40}$"
datastringOptionalformat: "^0x[0-9a-fA-F]*$"
topicslist of stringsOptional