Skip to main content
GET
/
v1
/
accounts
/
{id}
/
balances
Get Account Balances
curl --request GET \
  --url https://api.aries.com/v1/accounts/{id}/balances \
  --header 'Authorization: Bearer <token>'
{
  "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 decimal strings. This shape matches trade-xh-svc BalanceResponse (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: 
{
  "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 ID

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.

​
accountId
string

Account identifier

​
dayTradeBuyingPower
string

Day trade buying power (decimal string)

​
netBuyingPower
string

Net buying power (decimal string)

​
optionBuyingPower
string

Option buying power (decimal string)

​
stockBuyingPower
string

Stock buying power (decimal string)

​
totalEquity
string

Total equity (decimal string)

​
realizedPl
string

Realized profit or loss (decimal string)

​
unrealizedPl
string

Unrealized profit or loss (decimal string)

​
settledFunds
string

Settled funds (decimal string)

​
unsettledFunds
string

Unsettled funds (decimal string)

​
startOfDayCash
string

Start-of-day cash (decimal string)

​
maintReq
string

Maintenance requirement (decimal string)

​
grossMargin
string

Gross margin (decimal string)

​
sma
string

Special memorandum account (decimal string)

​
credit
string

Credit (decimal string)

​
creditRemaining
string

Remaining credit (decimal string)

​
pdt
string

Pattern day trader indicator or related value (decimal string)

​
pdtCreditRemaining
string

PDT credit remaining (decimal string)

​
pendingOrdersCount
integer

Number of pending orders

​
pendingOrdersMarginRequirements
string

Margin requirements for pending orders (decimal string)

​
valueBought
string

Value bought (decimal string)

​
valueSold
string

Value sold (decimal string)

​
dayTradeOvernightRegTBuyingPower
string

Day trade overnight Reg T buying power (decimal string)

​
heldBackFunds
string

Held-back funds (decimal string)

​
sodPositionsMarketValue
string

Start-of-day positions market value (decimal string)

​
sodTtlEquity
string

Start-of-day total equity (decimal string)

​
sodTtlEquityUpdatedAt
string<date-time>

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