Account Balances
Retrieve comprehensive account balance information including cash balances, buying power, margin requirements, and account equity. Monitor available funds and trading capacity in real-time.
Use Case: Display current buying power before placing a trade to ensure sufficient funds are available.
Documentation Index
Fetch the complete documentation index at: https://finance.dev/llms.txt
Use this file to discover all available pages before exploring further.
Demo response (all fields)
Numeric amounts are decimal strings. This shape matches trade-xh-svcBalanceResponse (flat JSON body). Internal domain types may include extra fields (for example creditMultiplier) that are not returned on this HTTP endpoint. The sample lists every JSON field the handler can emit:
Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Path Parameters
Account whose balances you want to read. Enter the account ID from GET /v1/users/me/accounts.
Response
Account balances retrieved successfully
Response body for GET /v1/accounts/{id}/balances (trade-xh-svc BalanceResponse). Returned as the top-level JSON object (not wrapped in balance/availability). Numeric amounts are decimal strings. Domain-only fields such as creditMultiplier are not exposed on this HTTP response.
Account these balances belong to. Match it to the account selected by the user.
Estimated buying power available for day trades, returned as a decimal string. Use this before intraday trading workflows.
Overall buying power available for new trades, returned as a decimal string. Use this as the primary pre-trade capacity value.
Buying power available for options trades, returned as a decimal string. Use this before showing options order entry.
Buying power available for equity trades, returned as a decimal string. Use this before stock order entry.
Total account equity, returned as a decimal string. Use this for account summary and portfolio value displays.
Profit or loss already locked in from closed trades, returned as a decimal string.
Profit or loss on currently open positions, returned as a decimal string. This can change with market prices.
Cash that has settled and is available under settlement rules, returned as a decimal string.
Cash from recent activity that has not fully settled yet, returned as a decimal string.
Cash balance at the start of the trading day, returned as a decimal string. Use this when explaining changes in cash during the day.
Maintenance margin requirement, returned as a decimal string. Use this to show how much equity the account must maintain for current positions.
Total margin exposure before offsets, returned as a decimal string. Use this for risk and account health displays.
Special Memorandum Account value, returned as a decimal string. Use this for margin accounts when showing additional buying-power capacity.
Credit value reported by the brokerage, returned as a decimal string. Use this for margin/accounting views when present.
Remaining credit available, returned as a decimal string. Use this to explain how much reported credit capacity remains.
Pattern day trader value or indicator reported by the brokerage, returned as a decimal string. Use this for day-trading risk notices.
Pattern-day-trader credit remaining, returned as a decimal string. Use this when showing day-trade buying-power constraints.
Number of orders currently pending. Use this to explain why available buying power may be reserved.
Estimated margin requirement reserved by pending orders, returned as a decimal string.
Total value bought for the reporting window, returned as a decimal string. Use this in trading activity summaries.
Total value sold for the reporting window, returned as a decimal string. Use this in trading activity summaries.
Reg T overnight buying power available for day-trade-related calculations, returned as a decimal string.
Funds reserved or held back by the brokerage, returned as a decimal string. Subtract this from available cash displays when explaining restricted funds.
Market value of positions at the start of the day, returned as a decimal string. Use this for daily performance comparisons.
Total account equity at the start of the day, returned as a decimal string. Use this as the baseline for day-over-day equity changes.
When start-of-day total equity was last updated. Omitted when not set.