---
title: "List external wallet balances (business)"
method: GET
path: "/money/accounts/whitelist/balances"
tags: ["money", "accounts"]
---

# List external wallet balances (business)

`GET /money/accounts/whitelist/balances`

Business-scoped cursor-paginated read-only token balances of the caller group's monitored external wallets: customer-connected, enabled, review-cleared wallets on onchain_ethereum or onchain_stellar. Join to GET /money/accounts/whitelist by money_account_id. Balances describe the address; they are not spendable platform funds and are never part of a platform balance.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

OK

- MoneyAccountsListWhitelistedExternalAddressBalancesOutput
  - `balances_as_of_ts` string, date-time, nullable, required — Oldest read_ts among this page's ok and stale items: every balance on the page was read at or after this instant. Null when the page has no ok or stale item.
  - `data` MoneyAccountsWhitelistedExternalAddressBalanceView[], nullable, required
    - `balance_status` 'ok' | 'stale' | 'unavailable' | 'shared_address', required
    - `balances` MoneyAccountsExternalWalletTokenBalanceView[], nullable, required — Non-zero holdings of registered tokens. Empty for unavailable and shared_address, where it means unknown or not read, never holds nothing.
      - `amount` string, required — Exact token quantity as a canonical decimal string, converted from the chain's base units with the registered decimals. Never rounded, never zero (zero holdings are omitted).
      - `asset_ref` string, required — On-chain identity of the token: the ERC-20 contract address on onchain_ethereum, or CODE:ISSUER on onchain_stellar.
      - `symbol` string, required — Display ticker of the registered token. A label, not an identity: asset_ref is the identity.
      - `usd_value` string, nullable, required — USD display value as a decimal string rounded to cents, or null when the token has no USD valuation (valuation_basis none). Display only: never part of a platform balance.
      - `valuation_basis` 'pegged' | 'assumed_par' | 'none', required
    - `money_account_id` string, required
    - `payment_rail` string, required — Chain the wallet is on: onchain_ethereum or onchain_stellar.
    - `read_ts` string, date-time, nullable, required — When the served balances were read from the chain. Null for unavailable and shared_address.
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `total_count` integer, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `default` — Error response.

## Changes

- **2026-09-24** `c1348532239f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/money/accounts/whitelist/balances/get.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) · [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/823fcbbd2f80?raw)