Overview
Describes how to retrieve account financial data once an account reachesACTIVE 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.Account Activities
Introduction
“Account activities give you a unified view of everything that has happened in an account: trades executed, dividends credited, deposits settled, fees charged, and corporate actions applied.”What Counts as an Activity?
The platform surfaces activities from two primary sources: trade executions via the orders endpoint, and deposits, withdrawals, dividends, interest, and corporate actions via the funding endpoint.Retrieving Order-Level Activity
List orders and examine execution details for individual trades. Each order record includes identifiers, symbol, asset class, order type, side, quantity, fill price, status, and timestamps. The executions endpoint provides lot-level fill data — each execution shows “a distinct fill at a specific price and time,” with the volume-weighted average equaling the parent order’s filled average price.Retrieving Funding Activity
The funding activity endpoint surfaces cash events including deposits, withdrawals, dividends, and fees. Records contain an activity identifier, account identifier, activity type, amount, status, description, and timestamps.Activity Types Reference
The system tracks these activity types (returned lowercase):deposit, withdrawal, transfer_in, transfer_out, and journal.
Activity Statuses
Activities can bepending, sent, completed, cancelled, returned, or failed.