---
title: "Get grouped wallet membership and native/token balance rollups for an account"
method: GET
path: "/accounts/{accountId}/balance"
tags: ["Digital Asset Accounts"]
---

# Get grouped wallet membership and native/token balance rollups for an account

`GET /accounts/{accountId}/balance`

## Request

- Base URL: `http://localhost:3200`
- URL: `http://localhost:3200/accounts/{accountId}/balance`
- Auth: API key in header `X-Steward-API-Key`
- TypeScript: <https://skmtc.dev/steward-fi/apis/steward-api/docs/accounts/:accountId/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

JSON response

- object
  - `ok` true, required
  - `data` object, required
    - `id` string
    - `accountId` string
    - `account_id` string
    - `wallets` object[]
      - `id` string, required
      - `walletId` string, required
      - `membershipId` string, required
      - `name` string, nullable, required
      - `ownerUserId` string, nullable
      - `owner_user_id` string, nullable
      - `walletType` string, nullable
      - `wallet_type` string, nullable
      - `custody` object
        - `type` 'server' | 'user_embedded'
        - `ownerUserId` string, nullable
        - `owner_user_id` string, nullable
      - `signing` object
        - `signerCount` integer
        - `activeSignerCount` integer
        - `quorumCount` integer
        - `activeQuorumCount` integer
      - `capabilities` string[], required
      - `capabilityMetadata` object, required
      - `capability_metadata` object
      - `chainType` 'ethereum' | 'solana' | 'bitcoin' | 'monero', required
      - `chainFamily` 'evm' | 'solana' | 'bitcoin' | 'monero', required
      - `address` string, nullable, required
      - `purpose` string, nullable
      - `venue` string, nullable
      - `createdAt` string, date-time, nullable
    - `capabilities` string[]
    - `capabilityMetadata` object
    - `capability_metadata` object
    - `balances` object[]
      - `walletId` string, required
      - `chainFamily` 'evm' | 'solana' | 'bitcoin' | 'monero', required
      - `chainId` integer, nullable, required
      - `symbol` string, nullable, required
      - `native` string, nullable, required
      - `nativeFormatted` string, nullable, required
      - `walletAddress` string, nullable, required
      - `unavailableReason` string
    - `tokenBalances` object[]
      - `walletId` string, required
      - `chainId` integer, required
      - `token` string, required
      - `symbol` string, required
      - `balance` string, required
      - `formatted` string, required
      - `decimals` integer, required
      - `unavailableReason` string
    - `rollups` object
      - `native` object[]
        - `chainId` integer
        - `symbol` string
        - `native` string
      - `tokens` object[]
        - `chainId` integer
        - `token` string
        - `symbol` string
        - `balance` string
        - `decimals` integer

## Other responses

- `400`: JSON response
- `401`: JSON response
- `403`: JSON response
- `404`: JSON response
- `409`: JSON response

## Changes

- **2026-08-17** `261a7c8070b2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/steward-fi/apis/steward-api/changes/accounts/:accountId/balance/get.md)

---

[API](https://skmtc.dev/steward-fi/apis/steward-api.md) - [All operations](https://skmtc.dev/steward-fi/apis/steward-api/llms.txt) - [OpenAPI document](https://skmtc.dev/steward-fi/apis/steward-api/revisions/b88b4b97a664?raw)