Utilities

Get Account Portfolio

Changed on

Retrieves the token balances across all supported chains for a user's abstracted account

get/accounts/{accountAddress}/portfolio

Request

Path parameters

accountAddressstring required

Query parameters

chainIdsstring
tokensstring
filterEmptyboolean

Headers

x-api-version'2026-01.alps' required

API version. Required; pinned to this document.

x-api-keystring required

API key.

Response

OK

Example response

{
  "portfolio": [
    {
      "balance": {
        "locked": "0",
        "unlocked": "1000000"
      },
      "tokenName": "USDC",
      "tokenDecimals": 6,
      "tokenChainBalance": [
        {
          "chainId": 1,
          "balance": {
            "locked": "0",
            "unlocked": "1000000"
          },
          "tokenAddress": "0xa0B86A33e6441B8C4505B8C4505b8C4505B8C450"
        }
      ]
    }
  ]
}

Changes

    • breaking

      the x-api-version request header's property undefined was restricted to a list of enum values

    • breaking

      the header request parameter x-api-version was restricted to a list of enum values

    • breaking

      the header request parameter x-api-version became required

    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response's body type changed from no type to object for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • info

      api operation id getPortfolio was added

    • info

      added the new enum value 2026-01.alps to the header request parameter x-api-version

    • info

      removed the pattern ^\d{4}-\d{2}\.[a-z0-9]+$ from the header request parameter x-api-version

    • info

      for the query request parameter chainIds, the type was generalized from array to string

    • info

      for the query request parameter tokens, the type was generalized from array to string

    • info

      removed response discriminator for the response status

    • info

      removed response discriminator for the response status

    • info

      removed response discriminator for the response status

    • info

      removed subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 from the response body oneOf list for the response status

    • info

      removed subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 from the response body oneOf list for the response status

    • info

      removed subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 from the response body oneOf list for the response status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      api tag Utilities added

    • info

      api tag Portfolio removed