Skip to main content

/v1/accounts/:address:/events/:creation_number:

Event types are globally identifiable by an account address and monotonically increasing creation_number, one per event type emitted to the given account. This API returns events corresponding to that event type.

Parameters​

  • address REQUIRED: (string) - Hex-encoded 32-byte Aptos account, with or without a 0x prefix, for which events are queried. This refers to the account that events were emitted to, not the account hosting the move module that emits that event type.
  • creation_number REQUIRED: (string<uint64>)- Creation number corresponding to the event stream originating from the given account.
  • limit OPTIONAL: (string<uint64>) - Max number of events to retrieve.
  • start OPTIONAL: (string<uint64>) - Starting sequence number of events.

Returns​

array of:

  • version (string<uint64>): A string containing a 64-bit unsigned integer.
  • guid (object)
    • creation_number (string<uint64>): A string containing a 64-bit unsigned integer.
    • account_address (string<hex>): A hex-encoded 32 byte Aptos account address.
  • sequence_number (string<uint64>): A string containing a 64-bit unsigned integer.
  • type (string): String representation of an on-chain Move type tag that is exposed in transaction payload. Values: - bool - u8 - u64 - u128 - address - signer - vector: vector<{non-reference MoveTypeId}> - struct: {address}::{module_name}::{struct_name}::<{generic types}>
Vector type value examples:
- `vector<u8>`
- `vector<vector<u64>>`
- `vector<0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>>`
Struct type value examples:
- `0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>
- `0x1::account::Account`
Note:
1. Empty chars should be ignored when comparing 2 struct tag ids.
2. When used in an URL path, should be encoded by url-encoding (AKA percent-encoding).
  • data The JSON representation of the event

Example​

Request

curl --request GET \
  --url https://aptos-mainnet.blastapi.io/<project-id>/v1/accounts/0xc32f662cd9718f02d8a8e5628f8f642fa27cd9b5f457b406ed734901a4939e34/events/32425224034 \
  --header 'Content-Type: application/json'

Response

{
  "guid": {
    "creation_number": "32425224034",
    "account_address": "0xc32f662cd9718f02d8a8e5628f8f642fa27cd9b5f457b406ed734901a4939e34"
  },
  "sequence_number": "32425224034",
  "type": "string",
  "data": null
}