Skip to main content

​
Overview

Describes how to retrieve account financial data once an account reaches ACTIVE status. These endpoints support portfolio dashboards, buying-power validation, and position management interfaces.

​
Key Endpoints

Get Account Balances — GET /v1/accounts/{accountId}/balances — Returns current cash and equity information. List All Open Positions — GET /v1/accounts/{accountId}/positions — Returns securities with non-zero quantities. Get Single Position — GET /v1/accounts/{accountId}/positions/{symbol} — Returns 404 if no position exists for that symbol.

​
Balance Field Definitions

The response includes: total cash, settled/unsettled cash components, buying power, equity value, long market value, previous close equity, portfolio value, and timestamp.

​
Position Field Definitions

Position data encompasses: ticker symbol, asset class, share quantity, average entry price, side (long), market value, cost basis, unrealized gain/loss in dollars and percentage, current price, prior day close, and intraday change metrics.

​
Settlement Timing

ACH deposits require 1–3 business days to settle in production (instant in sandbox). Equity sale proceeds settle T+1. Unsettled funds appear separately and don’t count toward buying power.

​
Practical Recommendations

Combine balances and positions endpoints with market data services to build dashboards, and compare estimated order costs against available buying power before presenting confirmation screens.