---
title: "Holdings on every chain"
method: GET
path: "/wallet/{wallet}/balances"
tags: ["Portfolio"]
---

# Holdings on every chain

`GET /wallet/{wallet}/balances`

## Request

- Base URL: `https://api.getchord.xyz/v1`
- URL: `https://api.getchord.xyz/v1/wallet/{wallet}/balances`
- Auth: none declared

What a wallet holds right now on Chord's six chains (Monad, Robinhood Chain, Arc, Avalanche, Base, BNB Chain), read on-chain: the native coin plus every token on Chord's list for each chain, priced by Chord's own maps. `raw` is the exact balance in the token's smallest unit (use it for a Max button); `amount` is the same number in whole tokens. Each chain answers on its own deadline: a slow or failing chain comes back `unavailable` with a reason and the others still answer. Only listed tokens are seen; a token outside Chord's lists will not show. Cached 15 s per wallet and chain set.

## Path parameters

- `wallet` string, required: EVM address, hex, case-insensitive.

## Query parameters

- `chains` string

## Response `200`

- object
  - `wallet` string: EVM address, hex, case-insensitive.
  - `totalUsd` number: Sum of priced holdings.
  - `updatedAt` integer: Unix time, milliseconds — when the server built this answer.
  - `chains` object[]
    - `chain` integer
    - `name` string
    - `status` 'ok' | 'unavailable' | 'no_rpc'
    - `reason` string: Only when not ok.
    - `totalUsd` number
    - `holdings` object[]: Highest value first.
      - `symbol` string
      - `name` string, nullable
      - `address` string, nullable: Null for the native coin.
      - `native` boolean
      - `decimals` integer
      - `raw` string: Exact balance, smallest unit.
      - `amount` string: Whole tokens.
      - `priceUsd` number, nullable
      - `valueUsd` number, nullable
      - `logoURI` string, nullable
      - `stable` boolean

## Other responses

- `400`: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).

---

[API](https://skmtc.dev/getchord/apis/chord-api.md) · [All operations](https://skmtc.dev/getchord/apis/chord-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getchord/apis/chord-api/revisions/d3bc4640fea0?raw)