eth_getLogsHTTP

Returns event logs matching a filter. Keep block ranges small (often 1–a few thousand blocks) to avoid timeouts and huge payloads.

Chain EthereumTransport HTTPTry-it live

How to use

Pick an API key (or paste one) in the Try it panel.
Object params use a tall JSON editor — click Fill example if available.
Send request — live against the gateway; counts toward daily quota.

Parameters

JSON-RPC positional arguments — order matches the array sent in params. Index badges below match array positions.

filterObjectrequired

Log filter object (JSON).

fromBlockinclusive start of the block range
toBlockinclusive end; use small windows and a supported finality boundary
blockHashexact block hash; cannot be combined with fromBlock or toBlock
addressone emitting contract address or an array of addresses on the selected network
topicsordered positions combined with AND; an array within a position is OR; null = wildcard

Topic 0 is an event signature only for non-anonymous ABI events. Missing bounds and supported tags depend on the upstream; use explicit bounds for reproducibility.

params array (shape)

eth_getLogs · paramsjson

1[
2  {
3    "fromBlock": "$LATEST_BLOCK_NUMBER",
4    "toBlock": "$LATEST_BLOCK_NUMBER",
5    "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
6  }
7]

Try it

Live request via the gateway — counts toward your account's daily quota. Chain: ethereum

JSON mode

API key

Try-it runs with one of your own keys — sign in or create a free account first.

Parameters

0filterObjectrequired

Log filter object (JSON).

fromBlockinclusive start of the block range
toBlockinclusive end; use small windows and a supported finality boundary
blockHashexact block hash; cannot be combined with fromBlock or toBlock
addressone emitting contract address or an array of addresses on the selected network
topicsordered positions combined with AND; an array within a position is OR; null = wildcard

Topic 0 is an event signature only for non-anonymous ABI events. Missing bounds and supported tags depend on the upstream; use explicit bounds for reproducibility.

Paste a JSON object. Indent freely — we parse it into the params array.

Example request

eth_getLogs · requestbash

1curl 'https://ethras.org/v1/ethereum/<YOUR_KEY>' \
2  -H 'Content-Type: application/json' \
3  -d '{
4    "id": 1,
5    "jsonrpc": "2.0",
6    "method": "eth_getLogs",
7    "params": [
8      {
9        "fromBlock": "latest",
10        "toBlock": "latest",
11        "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
12      }
13    ]
14  }'

Example response

Illustrative example: long hex values and object fields may be shortened for readability. Available fields depend on the network, client, protocol upgrade and transaction type.

eth_getLogs · responsejson

1{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "result": [
5    {
6      "address": "0xdac1...",
7      "topics": [
8        "0xddf2..."
9      ],
10      "data": "0x0000...",
11      "blockNumber": "0x186a9f7",
12      "logIndex": "0x0"
13    }
14  ]
15}

Response fields

The result row describes the complete result; other rows describe its object fields or array elements. Indented rows describe nested members. For subscriptions,params.* rows describe later notifications rather than the initial reply.

Field	Type	Description
`address`	`DATA(20B)`	Contract that emitted the log.
`topics`	`DATA(32B)[]`	Up to four 32-byte topics. Non-anonymous Solidity events include the signature hash at topics[0]; anonymous events omit it.
`data`	`DATA`	Unindexed log bytes. Decode ABI-encoded non-indexed event arguments using the emitter's event ABI.
`blockNumber`	`QUANTITY`	Block containing the log.
`blockHash`	`DATA(32B)`	Hash of that block.
`transactionHash`	`DATA(32B)`	Transaction that produced the log.
`transactionIndex`	`QUANTITY`	Index of that transaction in the block.
`logIndex`	`QUANTITY`	Index of the log within the block.
`removed`	`BOOLEAN`	Indicates a log removed from the canonical chain during reorganization, particularly in subscription/filter notifications.
`blockTimestamp`	`QUANTITY`	Block timestamp in Unix seconds where exposed; availability varies by network and client. Fetch the block by hash if absent.