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

Each position record includes: id, account_id, ticker symbol, share quantity, average_price (average entry price), current_price, market_value, unrealized_pnl (dollar gain/loss), pnl_percentage, and side (long or short).

​
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.