---
title: "Get current balance of a specific wallet"
method: GET
path: "/wallets/{id}/balance"
tags: ["Wallet"]
---

# Get current balance of a specific wallet

`GET /wallets/{id}/balance`

Returns the current balance of a specific wallet, including the display
balance and its estimated value in the currency requested via
`estimatedBalanceCurrencyCode` (defaults to USD).

## Path parameters

- `id` string, required

## Query parameters

- `estimatedBalanceCurrencyCode` string

## Response `200`

The request has succeeded.

- WalletBalance — The current balance of a single wallet, with its estimated value in the requested currency.
  - `data` object — The balance entry for the wallet.
    - `id` string — Public TypeID, e.g. `txn_01h455vb4pex5vsknk084sn02q`; legacy UUID suffixes are accepted until non-v7 rows are retired.
    - `customerId` string — Public TypeID, e.g. `txn_01h455vb4pex5vsknk084sn02q`; legacy UUID suffixes are accepted until non-v7 rows are retired.
    - `asset` string — Canonical asset symbol (e.g. "usdc").
    - `chain` string — Canonical chain name (e.g. "polygon").
    - `blockchainAsset` BlockchainAsset
      - `protocol` 'evm' | 'svm' | 'sui', required
      - `chainId` string, required
      - `tokenId` string, required
    - `address` string — On-chain wallet address.
    - `balance` string — Balance in display units (decimal string).
    - `currencyName` string — Human-readable currency name (e.g. "USD Coin").
    - `estimatedBalanceValue` string — Estimated balance value in the currency requested via the `estimatedBalanceCurrencyCode` query param, computed by the upstream provider at read time. Defaults to USD when the query param is omitted.
    - `updatedAt` string, date-time — When the cached OMS-side balance row was last updated.

---

[API](https://skmtc.net/polygon-technology/apis/polygon-oms-public-api.md) · [All operations](https://skmtc.net/polygon-technology/apis/polygon-oms-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polygon-technology/polygon-oms-public-api/revisions/18fdaebf64e5/schema)