---
title: "Get Account Balances"
method: GET
path: "/v1/accounts/{account_id}/balances"
tags: ["Accounts"]
---

# Get Account Balances

`GET /v1/accounts/{account_id}/balances`

Fetch account balance information

## Path parameters

- `account_id` integer, required

## Query parameters

- `top_margin_contributors_limit` integer

## Response `200`

Account balance information

- object
  - `error` ApiError — A direct mapping of tonic::Status, for use in HTTP responses.
    - `code` integer, required — The error code is used to identify the nature of the error. It corresponds to an HTTP status code.
    - `details` object[]
    - `message` string, required — A human-readable message providing more details about the error.
  - `metadata` ResponseMetadata, required — Metadata for the response. This will always contain a request ID which can be used to identify the request to Clear Street for tracing, and optionally may include pagination data.
    - `next_page_token` string, byte, nullable — Base64URL-encoded pagination token
    - `page_number` integer, nullable — Pagination. Included if this was a GET (list) response
    - `previous_page_token` string, byte, nullable — Base64URL-encoded pagination token
    - `request_id` string, required — A unique ID for this request, generated upon ingestion of the request.
    - `total_items` integer, nullable — Total number of items available (not just in this page).
    - `total_pages` integer, nullable — Total number of pages available.
  - `data` AccountBalances, required — Represents the balance details for a trading account
    - `account_id` integer, required
    - `buying_power` string, required — The total buying power available in the account.
    - `currency` string, required — Currency identifier for all monetary values.
    - `daily_change` string, required — Difference between current equity and start-of-day equity.
    - `daily_pnl` string, required — Total profit or loss since start of day.
    - `daily_realized_pnl` string, required — Realized profit or loss since start of day.
    - `daily_total_pnl` string, required — Total profit or loss since start of day.
    - `daily_unrealized_pnl` string, required — Total unrealized profit or loss across all positions relative to prior close.
    - `equity` string, required — The total equity in the account.
    - `long_market_value` string, required — The total market value of all long positions.
    - `margin_details` MarginDetails
      - `day_trade_buying_power_usage` string, nullable — The amount of day-trade buying power used during the current trading day. When null/undefined, the value should be assumed to be zero. The field is omitted to simplify the response.
      - `day_trade_count` integer, required — The number of day trades executed over the 5 most recent trading days.
      - `initial_margin_excess` string, required — Initial margin excess for trade-date balances.
      - `initial_margin_requirement` string, required — Initial margin requirement for trade-date balances.
      - `intraday_details` MarginSessionDetails, required
        - `buying_power` string, required — Maximum buying power available in the account during the session.
        - `multiplier` string, nullable — Effective multiplier for margin calculations during the session.
      - `maintenance_margin_excess` string, required — Maintenance margin excess for trade-date balances.
      - `maintenance_margin_requirement` string, required — Maintenance margin requirement for trade-date balances.
      - `overnight_details` MarginSessionDetails, required
        - `buying_power` string, required — Maximum buying power available in the account during the session.
        - `multiplier` string, nullable — Effective multiplier for margin calculations during the session.
      - `pattern_day_trader` boolean, required — `true` if the account is currently flagged as a PDT, otherwise `false`.
      - `top_contributors` MarginTopContributor[] — Optional top margin contributors, returned only when explicitly requested.
        - `day_trade_buying_power_usage` string, required — Day-trade buying power consumed by fills against this underlying on the current trade date. Populated only for pattern day trader accounts.
        - `initial_margin_requirement` string, required — Initial margin requirement attributable to this underlying.
        - `maintenance_margin_requirement` string, required — Maintenance margin requirement attributable to this underlying.
        - `market_value` string, required — Net market value attributable to this underlying.
        - `underlying_instrument_id` string, uuid, required — UUID of the underlying security contributing to margin requirement.
      - `usage` MarginDetailsUsage
        - `total` string, required — The total margin available in the current model.
        - `used` string, required — The amount of margin that is currently being utilized.
    - `margin_type` 'OTHER' | 'NONE' | 'PORTFOLIO_MARGIN' | 'RISK_BASED_HAIRCUT_BROKER_DEALER' | 'REG_T' | 'RISK_BASED_HAIRCUT_MARKET_MAKER' | 'CIRO' | 'FUTURES_NLV' | 'FUTURES_TOT_EQ', required — An account's margin type
    - `multiplier` string, nullable — Applied multiplier for margin calculations. When a null/undefined value is observed, it indicates it does not apply.
    - `open_order_adjustment` string, required — Signed buying-power correction from open orders.
    - `settled_cash` string, required — The amount of cash that is settled and available for withdrawal or trading.
    - `short_market_value` string, nullable — The total market value of all short positions. When null/undefined, the value should be assumed to be zero. The field is omitted to simplify the response.
    - `sod` AccountBalancesSod, required
      - `asof` string, date, nullable — Timestamp for the start-of-day values. When a null/undefined value is observed, it indicates that there is no available data.
      - `buying_power` string, required — Start-of-day buying power.
      - `day_trade_buying_power` string, nullable — Start-of-day day-trade buying power. When a null/undefined value is observed, it indicates it does not apply.
      - `equity` string, required — Start-of-day equity.
      - `long_market_value` string, required — Start-of-day long market value.
      - `maintenance_margin_excess` string, nullable — Start-of-day maintenance margin excess. When a null/undefined value is observed, it indicates it does not apply.
      - `maintenance_margin_requirement` string, nullable — Start-of-day maintenance margin requirement. When a null/undefined value is observed, it indicates it does not apply.
      - `short_market_value` string, required — Start-of-day short market value.
      - `trade_cash` string, nullable — Start-of-day trade cash. When a null/undefined value is observed, it indicates it does not apply.
    - `trade_cash` string, required — Trade-date effective cash.
    - `unrealized_pnl` string, required — Total unrealized profit or loss across all open positions.
    - `unsettled_credits` string, required — Trade-date unsettled cash credits.
    - `unsettled_debits` string, required — Trade-date unsettled cash debits.
    - `withdrawable_cash` string, required — The amount of cash currently available to withdraw.

## Other responses

- `403` — Forbidden
- `404` — Account not found
- `500` — Internal server error

---

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