Sign in

v1

latestOpenAPI 3.0.32026-07-173986194.3 KB

Returns a list of runtime events.

get/{runtime}/events

Path parameters

runtime'emerald' | 'sapphire' | 'pontusxtest' | 'pontusxdev' | 'cipher' required

The runtime which to query.

Query parameters

limitinteger

The maximum numbers of items to return.

offsetinteger

The number of items to skip before starting to collect the result set.

blockinteger

A filter on block round.

tx_indexinteger

A filter on transaction index. The returned events all need to originate from a transaction that appeared in tx_index-th position in the block. It is invalid to specify this filter without also specifying a block. Specifying tx_index and round is an alternative to specifying tx_hash; either works to fetch events from a specific transaction.

tx_hashstring

A filter on the hash of the transaction that originated the events. Specifying tx_index and round is an alternative to specifying tx_hash; either works to fetch events from a specific transaction. This can be an Ethereum transaction hash; the query will compare against both a transaction's regular tx_hash and eth_tx_hash (if it exists).

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'
Example:consensus_accounts.deposit

A filter on the event type.

relstring

A filter on related accounts. Every returned event will refer to this account. For example, for a accounts.Transfer event, this will be the sender or the recipient of tokens.

evm_log_signaturestring

A filter on the evm log signatures. Note: The filter will only match on parsed (verified) EVM events.

contract_addressstring

A filter on a smart contract. Every returned event will have been emitted by the contract at this address.

nft_idstring

A filter on NFT events. Every returned event will be specifically about this NFT instance ID. You must specify the contract_address filter with this filter. Currently this only supports ERC-721 Transfer events. This may expand to support other event types in the future. If you want only ERC-721 Transfer events, specify evm_log_signature=ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef to avoid inadvertently getting other event types if they are supported later. Using an evm_log_signature filter with this set to any other value will match no events.

Response

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

total_countinteger 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_clippedboolean required

Whether total_count is clipped for performance reasons.

Example response

{
  "total_count": 412,
  "is_total_count_clipped": true,
  "events": [
    {
      "round": 3283246,
      "tx_hash": "0d0531d6b8a468c07440182b1cdda517f5a076d69fb2199126a83082ecfc0f41",
      "timestamp": "2022-03-01T00:00:00Z",
      "type": "consensus_accounts.deposit",
      "evm_log_name": "Transfer",
      "evm_token": {
        "symbol": "USDT",
        "decimals": 18
      }
    }
  ]
}