---
title: "List total balances"
method: GET
path: "/api/v2/wallet/balances"
tags: ["Wallet"]
---

# List total balances

`GET /api/v2/wallet/balances`

Returns total balances by asset across all wallets in an enterprise.

## Query parameters

- `allTokens` boolean
- `coin` union
  - string — A cryptocurrency symbol or token ticker symbol
  - string[]
- `deleted` boolean
- `enterprise` union
  - string
  - string[]
- `excludeEmptyBalances` boolean
- `excludeSpendableBalances` boolean
- `expandCustodialWallet` boolean
- `id` union
  - string
  - string[]
- `includeEvmKeyring` boolean
- `includeStakingBalances` boolean
- `labelContains` string
- `skipPendingTxs` boolean
- `skipTxCounts` boolean
- `type` union
  - 'backing' | 'cold' | 'custodial' | 'custodialPaired' | 'hot' | 'advanced' | 'trading'
  - string[]

## Response `200`

OK

- GetWalletBalanceResponse
  - `balances` object[], required
    - `coin` string, required — A cryptocurrency symbol or token ticker symbol
    - `balanceString` string, required — String representation of the balance in base units. Guaranteed to not lose precision.
    - `confirmedBalanceString` string, required — String representation of the confirmed balance in base units. Guaranteed to not lose precision.
    - `spendableBalanceString` string — String representation of the spendable in base units. Guaranteed to not lose precision. Will not be included if `excludeSpendableBalances=false`
    - `stakingBalanceString` string — The staked balance in base units. Guaranteed to not lose precision. The is only returned if the `includeStakingBalances` query parameter is set to `true`.
    - `rewardBalanceString` string — The staking reward balance in base units. Guaranteed to not lose precision. The is only returned if the `includeStakingBalances` query parameter is set to `true`.
    - `withdrawHoldAmountUsdString` string — Total USD value (in cents) of active ACH-deposit related withdraw holds on this wallet. Only present for OFC wallets when `allTokens=true` is passed.
    - `offchain` OffChainWalletBalance
      - `inboundBalance` string, required — Inbound balance in millisatoshis (remote balance)
      - `inboundPendingBalance` string, required — Pending inbound balance in millisatoshis (pending open remote balance)
      - `inboundUnsettledBalance` string, required — Unsettled inbound balance in millisatoshis (unsettled remote balance)
      - `outboundBalance` string, required — Outbound balance in millisatoshis (local balance)
      - `outboundPendingBalance` string, required — Pending outbound balance in millisatoshis (pending open local balance)
      - `outboundUnsettledBalance` string, required — Unsettled outbound balance in millisatoshis (unsettled local balance)
      - `outboundLockedBalance` string, required — Locked (from pending force closed channels) outbound balance in millisatoshis (locked local balance)
      - `outboundReservedBalance` string, required — Total outbound reserved balance in millisatoshis (reserved local balance)
      - `outboundSpendableBalance` string, required — Total outbound spendable balance in millisatoshis (spendable local balance)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)