Get Event Logs by Address and/or Topic(s)

Event logs for an address and topic. Use and/or with the topic operator to specify topic retrieval options when adding multiple topics. Up to a maximum of 1,000 event logs.

Required:

• fromBlock and toBlock
• At least one of address, topic0, topic1, topic2, topic3
• If any pair of topic parameters is set, the corresponding topicA_B_opr is required.

GET /legacy/logs/get-logs

Get Event Logs by Address and/or Topic(s)

cURL

curl --request GET \
  --url http://localhost/api/legacy/logs/get-logs

200

{
  "message": "<string>",
  "result": [
    {
      "address": "<string>",
      "blockNumber": "<string>",
      "data": "<string>",
      "gasPrice": "<string>",
      "gasUsed": "<string>",
      "logIndex": "<string>",
      "timeStamp": "<string>",
      "topics": [
        "<string>"
      ],
      "transactionHash": "<string>",
      "transactionIndex": "<string>"
    }
  ]
}

Query Parameters

fromBlock · string enum<string>

Start block: integer or the sentinel "latest"

Pattern: ^-?([1-9][0-9]*|0)$

toBlock · string enum<string>

End block: integer or the sentinel "latest"

Pattern: ^-?([1-9][0-9]*|0)$

address · string

Pattern: ^0x([A-Fa-f0-9]{40})$

topic0 · string

Pattern: ^0x[0-9a-fA-F]{64}$

topic1 · string

Pattern: ^0x[0-9a-fA-F]{64}$

topic2 · string

Pattern: ^0x[0-9a-fA-F]{64}$

topic3 · string

Pattern: ^0x[0-9a-fA-F]{64}$

topic0_1_opr · enum<string>

Available options: and, or

topic0_2_opr · enum<string>

Available options: and, or

topic0_3_opr · enum<string>

Available options: and, or

topic1_2_opr · enum<string>

Available options: and, or

topic1_3_opr · enum<string>

Available options: and, or

topic2_3_opr · enum<string>

Available options: and, or

apikey · string

API key for rate limiting or for sensitive endpoints

key · string

Secret key for getting access to restricted resources

Response

200 - application/json

Event logs

message · string · required

Human-readable status string — OK on success, a descriptive error message otherwise.

result · LogItem · object[] · null · null · required

Endpoint-specific payload on success; null on error.

Show child attributes

status · enum<string> · required

1 = OK, 0 = error, 2 = pending.

Available options: 0, 1, 2