Tracking Positions

​

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.

---

​

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 various activity types: DEPOSIT, WITHDRAWAL, DIV, DIVTAX, JNLC, PTC, REORG, SSO, ACATC, and ACATS.

​

Activity Statuses

Activities can be PENDING, SETTLED, FAILED, or CANCELLED.

​

Building a Transaction History UI

Combine orders and funding activity into a unified transaction timeline sorted chronologically.

​

Reconciliation

For daily reconciliation, retrieve settled funding activity, filled orders, and current balances, then verify that “previous_equity + net_trades + net_cash_activity ≈ current_equity.”