portfolio

Get portfolio

Changed on

Retrieves the complete portfolio for an address including token balances and app positions across all supported chains.

get/v1/portfolio/{address}

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

addressstring required

Wallet address (0x prefixed hex string)

Query parameters

syncboolean

If true, waits for position data to be aggregated before responding (up to 30s)

excludeDustboolean
Example:true

If true, filters out dust positions (balance < $0.001 USD)

trustedboolean
Example:true

If true, only returns trusted tokens

chainIdsstring
Example:1,137,42161

Comma-separated list of chain IDs to filter by. If omitted, returns data for all chains.

fiatCodestring
Example:USD

Fiat currency code for balance conversion (e.g., USD, EUR)

Response

totalBalanceFiatstring required

Total balance in fiat currency across all tokens and positions. Decimal string without exponent notation or thousand separators.

totalTokenBalanceFiatstring required

Total balance in fiat currency for all token holdings. Decimal string without exponent notation or thousand separators.

totalPositionsBalanceFiatstring required

Total balance in fiat currency for all app positions. Decimal string without exponent notation or thousand separators.

Example response

{
  "totalBalanceFiat": "954181237.094243",
  "totalTokenBalanceFiat": "935542322.9685864",
  "totalPositionsBalanceFiat": "18638914.125656575",
  "tokenBalances": [
    {
      "balanceFiat": "4801.653401839",
      "price": "3890.12",
      "priceChangePercentage1d": "-0.0431"
    }
  ],
  "positionBalances": [
    {
      "balanceFiat": "18638914.125656575",
      "groups": [
        {
          "items": [
            {
              "balanceFiat": "18638914.125656575",
              "priceChangePercentage1d": "-0.0431"
            }
          ]
        }
      ]
    }
  ]
}

Changes

  • 7ab46d591d53Revision changes
    • breaking

      for the query request parameter excludeDust, default value true was removed

    • breaking

      for the query request parameter fiatCode, default value USD was removed

    • breaking

      for the query request parameter sync, default value false was removed

    • breaking

      for the query request parameter trusted, default value true was removed

  • bf7a88dbb9cfRevision changes
    • info

      added the new optional query request parameter sync