---
title: "Returns a list of runtime events."
method: GET
path: "/{runtime}/events"
---

# Returns a list of runtime events.

`GET /{runtime}/events`

## Path parameters

- `runtime` 'emerald' | 'sapphire' | 'pontusxtest' | 'pontusxdev' | 'cipher', required

## Query parameters

- `limit` integer
- `offset` integer
- `block` integer
- `tx_index` integer
- `tx_hash` string
- `type` 'accounts.transfer' | 'accounts.burn' | 'accounts.mint' | 'consensus_accounts.deposit' | 'consensus_accounts.withdraw' | 'consensus_accounts.delegate' | 'consensus_accounts.undelegate_start' | 'consensus_accounts.undelegate_done' | 'core.gas_used' | 'evm.log' | 'rofl.app_created' | 'rofl.app_updated' | 'rofl.app_removed'
- `rel` string
- `evm_log_signature` string
- `contract_address` string
- `nft_id` string

## Response `200`

Runtime events matching the filters, sorted by most recent first.

- RuntimeEventList — A list of runtime events.
  - `total_count` integer, required — The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.
  - `is_total_count_clipped` boolean, required — Whether total_count is clipped for performance reasons.
  - `events` RuntimeEvent[], required
    - `round` integer, required — The block height at which this event was generated.
    - `tx_index` integer — 0-based index of this event's originating transaction within its block. Absent if the event did not originate from a transaction.
    - `tx_hash` string — Hash of this event's originating transaction. Absent if the event did not originate from a transaction.
    - `eth_tx_hash` string — Ethereum transaction hash of this event's originating transaction. Absent if the event did not originate from an EVM transaction.
    - `timestamp` string, date-time, required — The second-granular consensus time of this event's block.
    - `type` 'accounts.transfer' | 'accounts.burn' | 'accounts.mint' | 'consensus_accounts.deposit' | 'consensus_accounts.withdraw' | 'consensus_accounts.delegate' | 'consensus_accounts.undelegate_start' | 'consensus_accounts.undelegate_done' | 'core.gas_used' | 'evm.log' | 'rofl.app_created' | 'rofl.app_updated' | 'rofl.app_removed', required
    - `body` object, required — The decoded event contents, possibly augmented with additional address info. This spec does not encode the many possible types; instead, see [the Go API](https://pkg.go.dev/github.com/oasisprotocol/oasis-sdk/client-sdk/go/modules). This object will conform to one of the `*Event` types two levels down the hierarchy (e.g. `MintEvent` from `accounts > Event > MintEvent`), OR `evm > Event`. For object fields that specify an oasis-style address, Nexus will add a field specifying the corresponding Ethereum address, if known. Currently, the only such possible fields are `from_eth`, `to_eth`, and `owner_eth`.
    - `evm_log_name` string — If the event type is `evm.log`, this field describes the human-readable type of evm event, e.g. `Transfer`. Absent if the event type is not `evm.log`.
    - `evm_log_params` EvmAbiParam[] — The decoded `evm.log` event data. Absent if the event type is not `evm.log`.
      - `name` string, required — The parameter name.
      - `evm_type` string, required — The solidity type of the parameter.
      - `value` unknown, required
    - `evm_token` EvmEventToken — Details about the EVM token involved in the event, if any.
      - `type` 'ERC20' | 'ERC721' — The type of a EVM token.
      - `symbol` string — Symbol of the token, as provided by token contract's `symbol()` method.
      - `decimals` integer — The number of least significant digits in base units that should be displayed as decimals when displaying tokens. `tokens = base_units / (10**decimals)`. Affects display only. Often equals 18, to match ETH.

## Other responses

- `400` — A human-readable error message.
- `404` — An empty response indicating that the requested resource was not found.
- `500` — A human-readable error message.

---

[API](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1.md) · [All operations](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oasisprotocol/oasis-nexus-api-v1/versions/a841981f8ee1/schema)