Movement Labs LogoMovement Docs
Node API

Get events by event handle

This API uses the given account address, eventHandle, and fieldName to build a key that can globally identify an event types. It then uses this key to return events emitted to the given account matching that event type.

GET
/accounts/{address}/events/{event_handle}/{field_name}

Path Parameters

addressstring

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.

Formathex
event_handlestring

Name of struct to lookup event handle e.g. 0x1::account::Account

Match^0x[0-9a-zA-Z:_<>]+$
field_namestring

Name of field to lookup event handle e.g. withdraw_events

Query Parameters

start?string

Starting sequence number of events.

If unspecified, by default will retrieve the most recent

Formatuint64
limit?integer

Max number of events to retrieve.

If unspecified, defaults to default page size

Formatuint16

Response Body

curl -X GET "https://full.mainnet.movementinfra.xyz/v1/accounts/0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 /events/0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>/string?start=32425224034&limit=0"
[
  {
    "version": "32425224034",
    "guid": {
      "creation_number": "32425224034",
      "account_address": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 "
    },
    "sequence_number": "32425224034",
    "type": "string",
    "data": null
  }
]
{
  "message": "string",
  "error_code": "account_not_found",
  "vm_error_code": 0
}
{
  "message": "string",
  "error_code": "account_not_found",
  "vm_error_code": 0
}
{
  "message": "string",
  "error_code": "account_not_found",
  "vm_error_code": 0
}
{
  "message": "string",
  "error_code": "account_not_found",
  "vm_error_code": 0
}
{
  "message": "string",
  "error_code": "account_not_found",
  "vm_error_code": 0
}
{
  "message": "string",
  "error_code": "account_not_found",
  "vm_error_code": 0
}