---
title: "Get current native balance for a symbol"
method: GET
path: "/money/balances/by_symbol/{symbol}"
tags: ["money", "balances"]
---

# Get current native balance for a symbol

`GET /money/balances/by_symbol/{symbol}`

## Request

- Base URL: `https://api.stablesea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stablesea.com/money/balances/by_symbol/{symbol}`
- Auth: none declared

Returns the caller-group's current native-unit balance for the given symbol.

## Path parameters

- `symbol` string, required

## Response `200`

OK

- BalancesGetBalanceForSymbolOutput
  - `amount` string, required
  - `amount_view` MoneyfmtMoneyAmountView, required
    - `float` number, double, required
    - `formatted` MoneyfmtFormattedMoneyAmountView, required
      - `compact` string, required
      - `currency_sign` string, required
      - `currency_sign_position` string, required
      - `full` string, required
    - `precise` string, required
    - `symbol` string, required
    - `zero` boolean, required
  - `balance` BalancesMoneyAccountBalanceView
    - `available_balance` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `pending_incoming` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `pending_outgoing` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `pending_outgoing_net` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `projected_balance` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `settled_balance` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
  - `native_balance` BalancesMoneyAccountBalanceView
    - `available_balance` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `pending_incoming` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `pending_outgoing` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `pending_outgoing_net` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `projected_balance` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `settled_balance` MoneyfmtMoneyAmountView, required
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
  - `symbol` string, required

## Other responses

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

## Changes

- **2026-10-29** `e003c8a67b62`: 4 info
  - added the optional property `error/authorization` to the response with the `400` status
  - added the optional property `error/authorization` to the response with the `401` status
  - added the optional property `error/authorization` to the response with the `403` status
  - added the optional property `error/authorization` to the response with the `default` status
- **2026-09-01** `f2d9f80610d9`: 4 info
  - added the optional property `error/api_client_id` to the response with the `400` status
  - added the optional property `error/api_client_id` to the response with the `401` status
  - added the optional property `error/api_client_id` to the response with the `403` status
  - added the optional property `error/api_client_id` to the response with the `default` status
- **2026-08-21** `60e021790e7a`: 2 info
  - added the required property `balance/pending_outgoing_net` to the response with the `200` status
  - added the required property `native_balance/pending_outgoing_net` to the response with the `200` status

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/money/balances/by_symbol/:symbol/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/772c80d83658?raw)
