Documentation / API reference / EVM
Get EVM Log
Last reviewed 2026-09-18
Returns indexed EVM event logs with contract addresses, topics, transaction hashes and decoded arguments when available. Filter by contract address, event name, topic or block and time ranges.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
block_number | query | integer (int32) | ||
block_start | query | integer (int32) | Start of block range (inclusive) | |
block_end | query | integer (int32) | End of block range (inclusive) | |
timestamp_start | query | integer (int64) | Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | |
timestamp_end | query | integer (int64) | End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | |
transaction_hash | query | string | ||
address | query | string | ||
event_name | query | string | ||
topic0 | query | string | ||
page | query | integer (int32) | ||
limit | query | integer (int32) | ||
order | query | string | One of block_number_asc, block_number_desc, timestamp_asc, timestamp_desc, id_asc, id_desc. |
Responses
200 — Logs retrieved successfully
| Field | Type | Required |
|---|---|---|
data | array | Yes |
data[].abi_json | object, nullable | |
data[].address | string | Yes |
data[].args | object, nullable | |
data[].block_number | integer (int32) | Yes |
data[].data | string, nullable | |
data[].event_name | string, nullable | |
data[].full_signature | string, nullable | |
data[].hashable_signature | string, nullable | |
data[].id | string | Yes |
data[].index | integer (int32) | Yes |
data[].removed | boolean | Yes |
data[].timestamp | string (date-time) | Yes |
data[].topic0 | string, nullable | |
data[].topic1 | string, nullable | |
data[].topic2 | string, nullable | |
data[].topic3 | string, nullable | |
data[].topic4 | string, nullable | |
data[].transaction_hash | string | Yes |
pagination | object | Yes |
pagination.current_page | integer (int32) | Yes |
pagination.next_page | integer (int32), nullable | |
pagination.per_page | integer (int32) | Yes |
pagination.prev_page | integer (int32), nullable | |
pagination.total_items | integer (int32) | Yes |
pagination.total_pages | integer (int32) | Yes |
Example response
json
{}Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Logs not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.