How to get all tokens for an account?

[hariria]

Solution

Indexer

The easiest way to get all of the tokens for an account is to use the provided Hasura indexer, specifically the current_token_ownerships and current_token_ownerships_v2 queries. Here's an example of how you would get all the current token ownerships for a given account.

TS SDK

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

Indexer Example

To make it easier to see the query inputs and response, I've created an Indexer example below.

This current_token_ownerships query specifies that I would like to include the amount, name, current_token_data and token_properties in the response. See this hasura link for more info on this example

query MyQuery {
  current_token_ownerships(
    where: {owner_address: {_eq: "<HEX_ADDRESS>"}}
  ) {
    amount
    name
    current_token_data {
      description
      name
      maximum
    }
    token_properties
  }
}

Here is an example of the response

{
  "data": {
    "current_token_ownerships": [
      {
        "amount": 1,
        "name": "Capsule #242",
        "current_token_data": {
          "description": "A capsule created with the power of transformation. ",
          "name": "Capsule #242",
          "maximum": 1
        },
        "token_properties": {}
      },
      {
        "amount": 1,
        "name": "Capsule #243",
        "current_token_data": {
          "description": "A capsule created with the power of transformation. ",
          "name": "Capsule #243",
          "maximum": 1
        },
        "token_properties": {}
      },
      {
        "amount": 0,
        "name": "Aptoad #2345",
        "current_token_data": {
          "description": "Aptoad #2345",
          "name": "Aptoad #2345",
          "maximum": 1
        },
        "token_properties": null
      },
    ....
}

To learn more about the different token types available on Aptos, see the docs on Token V1 and the Aptos Digital Asset Standard