Sign in

v7

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0462198511.0 KB
holdings

Retrieve a position

Retrieve a position within an account.

get/accounts/{account_id}/positions/{position_id}

Path parameters

account_idstring required
position_idstring required

Response

OK

accountstring required

ID of the account that owns the position.

automatic_rolloverboolean required

Whether automatic rollover is enabled.

automatic_rollover_cutoffstring date nullable

Last date automatic rollover can be changed.

available_for_tradingstring required

Instrument quantity available for trading.

average_pricestring nullable required

Average acquisition price per instrument unit.

can_update_automatic_rolloverboolean required

Whether automatic rollover can currently be changed.

closed_atstring date-time nullable required

Time the position was closed.

created_atstring date-time required

Time the position record was created.

idstring required

ID of the position.

modified_atstring date-time required

Time the position record was last modified.

most_recent_maturity_periodstring nullable required

Most recent maturity period used for rollover.

opened_atstring date-time required

Time the position was opened.

reservedstring required

Instrument quantity reserved by pending orders.

settledstring required

Settled instrument quantity.

status'open' | 'closing' | 'closed' required
totalstring required

Total instrument quantity held.

total_buy_tradesinteger required

Number of buy trades contributing to the position.

unsettledstring required

Instrument quantity awaiting settlement.

ytmstring nullable required

Yield to maturity as a percentage.

Example response

{
  "automatic_rollover_cutoff": "2025-09-25",
  "available_for_trading": "1000.00",
  "average_price": "98.75",
  "closed_at": "2025-07-15T10:30:00Z",
  "created_at": "2025-01-15T10:30:00Z",
  "instrument": {
    "about": "Common stock listed on the Nasdaq Global Select Market.",
    "days_to_maturity": 182,
    "decimal_precision": 2,
    "exchange": "XNAS",
    "icon_url": "https://storage.googleapis.com/sophic-assets/instrument-icons/in_x7GqT.png",
    "initial_auction_date": "2024-12-30",
    "initial_issue_date": "2025-01-02",
    "isin": "US5949181045",
    "issuer": "United States Department of the Treasury",
    "issuer_country": "US",
    "issuer_credit_rating": "AA+",
    "latest_auction_date": "2025-01-27",
    "latest_issue_date": "2025-01-30",
    "maturity_date": "2025-07-03",
    "minimum_initial_cash_investment": "1000.00",
    "minimum_trading_quantity": "1.00",
    "name": "Apple Inc.",
    "par_value": "100.00",
    "required_cash_increment": 100,
    "symbol": "US5949181045",
    "ticker": "AAPL",
    "trading_increment": "0.01"
  },
  "modified_at": "2025-07-01T14:32:18Z",
  "most_recent_maturity_period": "3m",
  "opened_at": "2025-01-15T10:30:00Z",
  "reserved": "50.00",
  "settled": "1000.00",
  "total": "1250.00",
  "total_buy_trades": 3,
  "unsettled": "250.00",
  "ytm": "4.25"
}