curl --request GET \
--url https://api.aries.com/v2/accounts/{id}/balance \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aries.com/v2/accounts/{id}/balance"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v2/accounts/{id}/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v2/accounts/{id}/balance",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v2/accounts/{id}/balance"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v2/accounts/{id}/balance")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v2/accounts/{id}/balance")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"balance": "248874.14377781",
"accountId": "TEST-ACCOUNT-001",
"dayTradeBuyingPower": "50000",
"netBuyingPower": "125000.5",
"optionBuyingPower": "25000",
"stockBuyingPower": "125000.5",
"realizedPl": "37.5",
"unrealizedPl": "836.64377781",
"openPnl": "836.64377781",
"dayOpenPnl": "512.14",
"dayRealizedPnl": "37.5",
"dayTotalPnl": "549.64",
"costOfPositions": "180000",
"settledFunds": "100000",
"unsettledFunds": "5000",
"cashBalance": "105000",
"amountAvailableToWithdraw": "100000",
"startOfDayCash": "95000",
"maintReq": "75000",
"grossMargin": "120000",
"sma": "0",
"credit": "0",
"creditRemaining": "0",
"pdt": "0",
"pdtCreditRemaining": "0",
"pendingOrdersCount": 0,
"pendingOrdersMarginRequirements": "0",
"valueBought": "45000",
"valueSold": "12000",
"dayTradeOvernightRegTBuyingPower": "48000",
"heldBackFunds": "0",
"sodPositionsMarketValue": "180000",
"sodTtlEquity": "248000",
"sodTtlEquityUpdatedAt": "2026-01-15T09:30:00Z",
"smaCreditRemaining": "0",
"intradayMarginBalance": "7000",
"fundsAvailableForWithdrawal": "98500",
"sodMarginTradeBalance": "-40000",
"sodGrossFundsAvailable": "100000",
"sodNetFundsAvailable": "98500",
"sodFundsAvailableDate": "2026-01-14"
}Account Balance
Retrieve comprehensive account balance information (v2) 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.
curl --request GET \
--url https://api.aries.com/v2/accounts/{id}/balance \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aries.com/v2/accounts/{id}/balance"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v2/accounts/{id}/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v2/accounts/{id}/balance",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v2/accounts/{id}/balance"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v2/accounts/{id}/balance")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v2/accounts/{id}/balance")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"balance": "248874.14377781",
"accountId": "TEST-ACCOUNT-001",
"dayTradeBuyingPower": "50000",
"netBuyingPower": "125000.5",
"optionBuyingPower": "25000",
"stockBuyingPower": "125000.5",
"realizedPl": "37.5",
"unrealizedPl": "836.64377781",
"openPnl": "836.64377781",
"dayOpenPnl": "512.14",
"dayRealizedPnl": "37.5",
"dayTotalPnl": "549.64",
"costOfPositions": "180000",
"settledFunds": "100000",
"unsettledFunds": "5000",
"cashBalance": "105000",
"amountAvailableToWithdraw": "100000",
"startOfDayCash": "95000",
"maintReq": "75000",
"grossMargin": "120000",
"sma": "0",
"credit": "0",
"creditRemaining": "0",
"pdt": "0",
"pdtCreditRemaining": "0",
"pendingOrdersCount": 0,
"pendingOrdersMarginRequirements": "0",
"valueBought": "45000",
"valueSold": "12000",
"dayTradeOvernightRegTBuyingPower": "48000",
"heldBackFunds": "0",
"sodPositionsMarketValue": "180000",
"sodTtlEquity": "248000",
"sodTtlEquityUpdatedAt": "2026-01-15T09:30:00Z",
"smaCreditRemaining": "0",
"intradayMarginBalance": "7000",
"fundsAvailableForWithdrawal": "98500",
"sodMarginTradeBalance": "-40000",
"sodGrossFundsAvailable": "100000",
"sodNetFundsAvailable": "98500",
"sodFundsAvailableDate": "2026-01-14"
}Demo response (all fields)
Numeric amounts are returned as decimal strings to preserve precision. The body is a flat JSON object. The sample below lists every JSON field the endpoint can return:{
"balance": "248874.14377781",
"accountId": "TEST-ACCOUNT-001",
"dayTradeBuyingPower": "50000",
"netBuyingPower": "125000.5",
"optionBuyingPower": "25000",
"stockBuyingPower": "125000.5",
"realizedPl": "37.5",
"unrealizedPl": "836.64377781",
"openPnl": "836.64377781",
"dayOpenPnl": "512.14",
"dayRealizedPnl": "37.5",
"dayTotalPnl": "549.64",
"costOfPositions": "180000",
"settledFunds": "100000",
"unsettledFunds": "5000",
"cashBalance": "105000",
"amountAvailableToWithdraw": "100000",
"startOfDayCash": "95000",
"maintReq": "75000",
"grossMargin": "120000",
"sma": "0",
"credit": "0",
"creditRemaining": "0",
"pdt": "0",
"pdtCreditRemaining": "0",
"pendingOrdersCount": 0,
"pendingOrdersMarginRequirements": "0",
"valueBought": "45000",
"valueSold": "12000",
"dayTradeOvernightRegTBuyingPower": "48000",
"heldBackFunds": "0",
"sodPositionsMarketValue": "180000",
"sodTtlEquity": "248000",
"sodTtlEquityUpdatedAt": "2026-01-15T09:30:00Z",
"smaCreditRemaining": "0",
"intradayMarginBalance": "7000",
"fundsAvailableForWithdrawal": "98500",
"sodMarginTradeBalance": "-40000",
"sodGrossFundsAvailable": "100000",
"sodNetFundsAvailable": "98500",
"sodFundsAvailableDate": "2026-01-14"
}
Withdrawable cash and margin fields
fundsAvailableForWithdrawal is the figure to show a user asking how much they can take out. It is derived on every read from the lower of creditRemaining and smaCreditRemaining, adjusted by the clearing firm’s previous-close haircut (sodNetFundsAvailable minus sodGrossFundsAvailable) and floored at zero. intradayMarginBalance is the margin loan outstanding, rolled forward through today’s buys and sells.
The three sod* funds fields are the clearing firm’s own start-of-day numbers and are served as stored: "0" until the day’s load has run. sodFundsAvailableDate is the business date of that load and is omitted when it has never run for the account, so read it before treating a zero as real. sodNetFundsAvailable is previous-close only; do not present it as today’s withdrawable amount.Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Path Parameters
Account whose balance you want to read. Enter the account ID from GET /v1/users/me/accounts.
Response
Account balance retrieved successfully
Response body for GET /v2/accounts/{id}/balance. Returned as the top-level JSON object. Numeric amounts are decimal strings.
Total account balance (net account value), returned as a decimal string. Use this as the headline portfolio value.
Account these balances belong to. Match it to the account selected by the user.
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.
Total purchasing power available right now across all instruments — the main number to show as 'Buying Power' in a trading UI. Decimal string.
How much the user can spend specifically on options. Usually lower than stock buying power because options require cash. Decimal string.
How much the user can spend specifically on stocks. On a margin account this is typically up to 2× cash. Decimal string.
Cumulative profit/loss from positions that have already been closed. Locked in — does not move with the market. Decimal string.
Profit/loss on positions the user currently holds open — paper gains/losses based on current market prices. Changes with the market. Decimal string.
Total open (unrealized) profit/loss across all currently held positions, returned as a decimal string. Mirrors unrealizedPl.
Open (unrealized) profit/loss generated during the current trading day, returned as a decimal string.
Profit/loss realized from positions closed during the current trading day, returned as a decimal string.
Total profit/loss for the current trading day, combining day open and day realized P&L (dayOpenPnl + dayRealizedPnl). Decimal string.
Aggregate cost basis of all currently open positions, returned as a decimal string.
Cash that has fully settled (T+1/T+2 has passed) and is freely available with no restrictions. Decimal 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.
Current cash balance in the account, returned as a decimal string. Can be negative on a margin account.
Cash currently available to withdraw from the account, returned as a decimal string.
Cash balance when today's trading session opened. Useful as the baseline for calculating today's cash change. Decimal 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.
Total amount currently borrowed from the broker on margin (before offsets). Use this in risk and account-health displays. Decimal 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.
Total margin credit line extended to the account. Decimal string.
How much of the credit line is still available to draw against. Decimal string.
Pattern Day Trader flag balance — relates to FINRA Rule 4210 (four-day-trades-in-five-days rule, $25,000 minimum equity). Decimal string.
Remaining day-trade buying power for a PDT-flagged account. Decimal string.
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 (sodTtlEquity) was last updated, in RFC3339 format. Omitted when not set.
Remaining SMA-based buying power still available to draw against, returned as a decimal string.
Margin loan currently outstanding, returned as a positive decimal string and rolled forward through today's trading: the start-of-day margin trade balance (sign-inverted) plus valueSold minus valueBought. Derived at read time, not stored.
Cash available to withdraw right now, returned as a decimal string. The lower of creditRemaining and smaCreditRemaining, adjusted by the clearing firm's previous-close haircut (sodNetFundsAvailable minus sodGrossFundsAvailable) and floored at zero. Derived at read time. Until the start-of-day funds data has loaded (see sodFundsAvailableDate) the haircut is zero and this equals the lower of the two credit figures.
Start-of-day margin trade-date balance as reported by the clearing firm, returned as a decimal string. Negative while a margin loan is outstanding. "0" until the start-of-day load has run for the account.
Gross funds available at the previous close, as reported by the clearing firm, returned as a decimal string. "0" until the start-of-day load has run; check sodFundsAvailableDate before relying on it.
Net funds available to withdraw at the previous close, as reported by the clearing firm, returned as a decimal string. Previous-close only; for the live figure use fundsAvailableForWithdrawal. "0" until the start-of-day load has run.
Business date (YYYY-MM-DD) of the start-of-day funds data behind sodGrossFundsAvailable and sodNetFundsAvailable. Omitted when that data has not loaded for the account, which is the only way to tell a genuine zero from an unloaded one.
Was this page helpful?