Documentation / API reference / Contract Event
Get Contract Event
Reference
Last reviewed 2026-09-18
Returns indexed smart-contract events with names, arguments, topics and block timestamps. Filter by event name, topics 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) | |
name | query | string | ||
topic_0 | query | string | ||
topic_1 | query | string | ||
topic_2 | query | string | ||
topic_3 | 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, name_asc, name_desc, id_asc, id_desc. |
Responses
200 — Contract events retrieved successfully
| Field | Type | Required |
|---|---|---|
data | array | Yes |
data[].args | object | Yes |
data[].block_number | integer (int32) | Yes |
data[].id | string | Yes |
data[].index | integer (int32) | Yes |
data[].name | string | Yes |
data[].timestamp | string (date-time) | Yes |
data[].topic_0 | string, nullable | |
data[].topic_1 | string, nullable | |
data[].topic_2 | string, nullable | |
data[].topic_3 | string, nullable | |
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 |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.