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_Events_By_Event_Handle is an example object payload from Aptos, with 9 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
Top-level fields
Example Payload
{
"method": "GET",
"path": "/accounts/{address}/events/{event_handle}/{field_name}",
"operationId": "get_events_by_event_handle",
"summary": "Get events by event handle",
"description": "This API uses the given account `address`, `eventHandle`, and `fieldName`\nto build a key that can globally identify an event types. It then uses this\nkey to return events emitted to the given account matching that event type.",
"tags": [
"Events"
],
"parameters": [
{
"name": "address",
"in": "path",
"required": true,
"description": "Hex-encoded 32 byte Aptos account, with or without a `0x` prefix, for\nwhich events are queried. This refers to the account that events were\nemitted to, not the account hosting the move module that emits that\nevent type.",
"schema": {
"$ref": "#/components/schemas/Address"
}
},
{
"name": "event_handle",
"in": "path",
"required": true,
"description": "Name of struct to lookup event handle e.g. `0x1::account::Account`",
"schema": {
"$ref": "#/components/schemas/MoveStructTag"
}
},
{
"name": "field_name",
"in": "path",
"required": true,
"description": "Name of field to lookup event handle e.g. `withdraw_events`",
"schema": {
"$ref": "#/components/schemas/IdentifierWrapper"
}
},
{
"name": "start",
"in": "query",
"required": false,
"description": "Starting sequence number of events.\n\nIf unspecified, by default will retrieve the most recent",
"schema": {
"$ref": "#/components/schemas/U64"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"description": "Max number of events to retrieve.\n\nIf unspecified, defaults to default page size",
"schema": {
"type": "integer",
"format": "uint16"
}
}
],
"requestBody": null,
"responses": {
"200": {
"contentType": "application/json",
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/VersionedEvent"
}
},
"example": {}
},
"400": {
"contentType": "application/json",
"schema": {
"$ref": "#/components/schemas/AptosError"
},
"example": {}
},
"403": {
"contentType": "application/json",
"schema": {
"$ref": "#/components/schemas/AptosError"
},
"example": {}
},
"404": {
"contentType": "application/json",
"schema": {
"$ref": "#/components/schemas/AptosError"
},
"example": {}
},
"410": {
"contentType": "application/json",
"schema": {
"$ref": "#/components/schemas/AptosError"
},
"example": {}
},
"500": {
"contentType": "application/json",
"schema": {
"$ref": "#/components/schemas/AptosError"
},
"example": {}
},
"503": {
"contentType": "application/json",
"schema": {
"$ref": "#/components/schemas/AptosError"
},
"example": {}
}
}
}
Work with this as data
Every example here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for examples
4 MCP tools reach this
find_examplesBrowse and filter every example in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/examples/get_events_by_event_handle"
curl "https://apis.io/api/v1/examples?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.