How do I get historical events for an account?

[hariria]

Solution

Indexer

The easiest way to get all of the historical events for an account is to use the provided Hasura indexer, specifically the events query. Unfortunately, the node is not always a reliable source for events as events and other ledger state can be pruned over time. To learn more see the section on aptos.dev on viewing current and historical state

TS SDK

The TS SDK provides an implementation that queries Aptos' Hasura Indexer mentioned above for events. See this github link for more information.

Example

Here's an example of how you would get all the events associated with a given account.

See the Hasura link for more details on this example

query MyQuery {
  events(
    where: {account_address: {_eq: "<HEX_ADDRESS>"}}
  ) {
    data
    transaction_version
  }
}

This returns a response like so:

{
  "data": {
    "events": [
      {
        "data": {
          "id": {
            "token_data_id": {
              "name": "Margin Trading Live on Testnet!",
              "creator": "0x92d2f7ad00630e4dfffcca01bee12c84edf004720347fb1fd57016d2cc8d3f8",
              "collection": "Galxe OAT"
            },
            "property_version": "0"
          },
          "amount": "1"
        },
        "transaction_version": 97352983
      },
      {
        "data": {
          "id": {
            "token_data_id": {
              "name": "Thala Labs Testnet Campaign",
              "creator": "0x92d2f7ad00630e4dfffcca01bee12c84edf004720347fb1fd57016d2cc8d3f8",
              "collection": "Galxe OAT"
            },
            "property_version": "0"
          },
          "amount": "1"
        },
        "transaction_version": 98788584
      },
   ...
}

For more information on getting events, see the section on API access for historical events on aptos.dev