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.

GET /v1/accounts/{id}/balances

Get Account Balances

cURL

curl --request GET \
  --url https://api.aries.com/v1/accounts/{id}/balances \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "accountId": "TEST-ACCOUNT-001",
  "dayTradeBuyingPower": "50000.00",
  "netBuyingPower": "125000.50",
  "optionBuyingPower": "25000.00",
  "stockBuyingPower": "125000.50",
  "totalEquity": "250000.00",
  "realizedPl": "1500.25",
  "unrealizedPl": "-250.75",
  "settledFunds": "100000.00",
  "unsettledFunds": "5000.00",
  "startOfDayCash": "95000.00",
  "maintReq": "75000.00",
  "grossMargin": "120000.00",
  "sma": "0",
  "credit": "0",
  "creditRemaining": "0",
  "pdt": "0",
  "pdtCreditRemaining": "0",
  "pendingOrdersCount": 2,
  "pendingOrdersMarginRequirements": "2500.00",
  "valueBought": "45000.00",
  "valueSold": "12000.00",
  "dayTradeOvernightRegTBuyingPower": "48000.00",
  "heldBackFunds": "0",
  "sodPositionsMarketValue": "180000.00",
  "sodTtlEquity": "248000.00",
  "sodTtlEquityUpdatedAt": "2026-01-15T09:30:00Z"
}

Demo response (all fields)

Numeric amounts are returned as decimal strings to preserve precision. The body is a flat JSON object — there is no balance/availability wrapper. The sample below lists every JSON field the endpoint can return:

{
  "accountId": "TEST-ACCOUNT-001",
  "dayTradeBuyingPower": "50000.00",
  "netBuyingPower": "125000.50",
  "optionBuyingPower": "25000.00",
  "stockBuyingPower": "125000.50",
  "totalEquity": "250000.00",
  "realizedPl": "1500.25",
  "unrealizedPl": "-250.75",
  "settledFunds": "100000.00",
  "unsettledFunds": "5000.00",
  "startOfDayCash": "95000.00",
  "maintReq": "75000.00",
  "grossMargin": "120000.00",
  "sma": "0",
  "credit": "0",
  "creditRemaining": "0",
  "pdt": "0",
  "pdtCreditRemaining": "0",
  "pendingOrdersCount": 2,
  "pendingOrdersMarginRequirements": "2500.00",
  "valueBought": "45000.00",
  "valueSold": "12000.00",
  "dayTradeOvernightRegTBuyingPower": "48000.00",
  "heldBackFunds": "0",
  "sodPositionsMarketValue": "180000.00",
  "sodTtlEquity": "248000.00",
  "sodTtlEquityUpdatedAt": "2026-01-15T09:30:00Z"
}

Authorizations

Authorization · string · header · required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Path Parameters

id · string · required

Account whose balances you want to read. Enter the account ID from GET /v1/users/me/accounts.

Response

200

application/json

Account balances retrieved successfully

Response body for GET /v1/accounts/{id}/balances. 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.

accountId · string

Account these balances belong to. Match it to the account selected by the user.

dayTradeBuyingPower · string

How much the user can use for same-day round-trip trades. Typically up to 4× equity for pattern day traders. Resets at end of day. Decimal string.

netBuyingPower · string

Total purchasing power available right now across all instruments — the main number to show as 'Buying Power' in a trading UI. Decimal string.

optionBuyingPower · string

How much the user can spend specifically on options. Usually lower than stock buying power because options require cash. Decimal string.

stockBuyingPower · string

How much the user can spend specifically on stocks. On a margin account this is typically up to 2× cash. Decimal string.

totalEquity · string

Cash plus market value of positions minus any margin debit — the account's net worth right now. Use this as the headline portfolio value. Decimal string.

realizedPl · string

Cumulative profit/loss from positions that have already been closed. Locked in — does not move with the market. Decimal string.

unrealizedPl · string

Profit/loss on positions the user currently holds open — paper gains/losses based on current market prices. Changes with the market. Decimal string.

settledFunds · string

Cash that has fully settled (T+1/T+2 has passed) and is freely available with no restrictions. Decimal string.

unsettledFunds · string

Cash from recent sales that hasn't settled yet. Usable for most trades, but cash accounts may restrict using it for new buys. Decimal string.

startOfDayCash · string

Cash balance when today's trading session opened. Useful as the baseline for calculating today's cash change. Decimal string.

maintReq · string

Maintenance requirement — the minimum equity that must be held to support current positions. Drop below this and the account may receive a margin call. Decimal string.

grossMargin · string

Total amount currently borrowed from the broker on margin (before offsets). Use this in risk and account-health displays. Decimal string.

sma · string

Special Memorandum Account — a Reg T concept. Effectively a stored-up pool of 'extra' buying power that grew from past gains in a margin account. Decimal string.

credit · string

Total margin credit line extended to the account. Decimal string.

creditRemaining · string

How much of the credit line is still available to draw against. Decimal string.

pdt · string

Pattern Day Trader flag balance — relates to FINRA Rule 4210 (four-day-trades-in-five-days rule, $25,000 minimum equity). Decimal string.

pdtCreditRemaining · string

Remaining day-trade buying power for a PDT-flagged account. Decimal string.

pendingOrdersCount · integer

Number of orders currently pending. Use this to explain why available buying power may be reserved.

pendingOrdersMarginRequirements · string

Estimated margin requirement reserved by pending orders, returned as a decimal string.

valueBought · string

Total value bought for the reporting window, returned as a decimal string. Use this in trading activity summaries.

valueSold · string

Total value sold for the reporting window, returned as a decimal string. Use this in trading activity summaries.

dayTradeOvernightRegTBuyingPower · string

Reg T overnight buying power available for day-trade-related calculations, returned as a decimal string.

heldBackFunds · string

Funds reserved or held back by the brokerage, returned as a decimal string. Subtract this from available cash displays when explaining restricted funds.

sodPositionsMarketValue · string

Market value of positions at the start of the day, returned as a decimal string. Use this for daily performance comparisons.

sodTtlEquity · string

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.

sodTtlEquityUpdatedAt · string<date-time>

When start-of-day total equity was last updated. Omitted when not set.