Sign in

Returns a list of runtime events.

Changed on
get/{runtime}/events

Request

  • Base URL: https://nexus.oasis.io/v1
  • URL: https://nexus.oasis.io/v1/{runtime}/events
  • Auth: none declared

Path parameters

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

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' | 'rofl.instance_registered' | 'roflmarket.provider_created' | 'roflmarket.provider_updated' | 'roflmarket.provider_removed' | 'roflmarket.instance_created' | 'roflmarket.instance_updated' | 'roflmarket.instance_accepted' | 'roflmarket.instance_cancelled' | 'roflmarket.instance_removed' | 'roflmarket.instance_command_queued'
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
      }
    }
  ]
}

Changes

  • v107a2d7aea71cRevision changes
    • breaking

      the path request parameter runtime was restricted to a list of enum values

    • info

      added the new enum value cipher to the path request parameter runtime

    • info

      added the new enum value emerald to the path request parameter runtime

    • info

      added the new enum value pontusxdev to the path request parameter runtime

    • info

      added the new enum value pontusxtest to the path request parameter runtime

    • info

      added the new enum value sapphire to the path request parameter runtime

    • info

      for the path request parameter runtime, the type was generalized from no type to string

  • v138dec379b7c3Revision changes
    • warning

      added the new roflmarket.instance_accepted enum value to the /////////// response property for the response status

    • warning

      added the new roflmarket.instance_cancelled enum value to the /////////// response property for the response status

    • warning

      added the new roflmarket.instance_command_queued enum value to the /////////// response property for the response status

    • warning

      added the new roflmarket.instance_created enum value to the /////////// response property for the response status

    • warning

      added the new roflmarket.instance_removed enum value to the /////////// response property for the response status

    • warning

      added the new roflmarket.instance_updated enum value to the /////////// response property for the response status

    • warning

      added the new roflmarket.provider_created enum value to the /////////// response property for the response status

    • warning

      added the new roflmarket.provider_removed enum value to the /////////// response property for the response status

    • warning

      added the new roflmarket.provider_updated enum value to the /////////// response property for the response status

    • info

      added the enum value roflmarket.instance_accepted to the property allOf[RuntimeEventType]/ of the query request parameter type

    • info

      added the enum value roflmarket.instance_cancelled to the property allOf[RuntimeEventType]/ of the query request parameter type

    • info

      added the enum value roflmarket.instance_command_queued to the property allOf[RuntimeEventType]/ of the query request parameter type

    • info

      added the enum value roflmarket.instance_created to the property allOf[RuntimeEventType]/ of the query request parameter type

    • info

      added the enum value roflmarket.instance_removed to the property allOf[RuntimeEventType]/ of the query request parameter type

    • info

      added the enum value roflmarket.instance_updated to the property allOf[RuntimeEventType]/ of the query request parameter type

    • info

      added the enum value roflmarket.provider_created to the property allOf[RuntimeEventType]/ of the query request parameter type

    • info

      added the enum value roflmarket.provider_removed to the property allOf[RuntimeEventType]/ of the query request parameter type

    • info

      added the enum value roflmarket.provider_updated to the property allOf[RuntimeEventType]/ of the query request parameter type