AptosAptos API Endpoints

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

Uses the given account address, event_handle, and field_name to retrieve events emitted to the account that match the corresponding event type. The combination of these parameters constructs a globally unique event stream identifier. Pagination is supported via start and limit.

⚠ This endpoint is only available with Blast access.

Path parameters

addressstringRequired

Hex-encoded 32-byte Aptos account address, with or without 0x prefix.

event_handlestringRequired
Struct type name that contains the event handle.
field_namestringRequired
Field name within the struct that holds the event handle.

Query parameters

startstringOptional
Starting sequence number of events.
limitstringOptional
Maximum number of events to return.

Response

Array of events matching the specified type.
versionstring or null
Ledger version in which the event was emitted.
guidobject or null
sequence_numberstring or null
typestring or null
Move type of the event.
dataobject or null
JSON representation of the event data.