v6

OpenAPI 3.1.0raw.githubusercontent.com2026-08-0161197504.7 KB

trading

List orders

Retrieve all orders associated with the given account.

get/accounts/{account_id}/orders

Path parameters

account_idstring required

Response

accountstring nullable

ID of the parent account. Present on customer orders; null for system-placed orders.

automatic_rolloverboolean nullable

Customer's automatic rollover preference; set only on eligible buy orders.

cancelled_atstring date-time nullable

The time the order was cancelled.

cancelled_reasonstring nullable

The reason for cancelling the order, if cancelled.

cash_amountstring nullable

The amount to invest (before fees). Buy orders are cash-based (you specify how much to invest, not how many units to buy).

created_atstring date-time required

The timestamp (in ISO-8601 format) of when the resource was created.

currency'EUR' | 'USD' | 'GBP'

feesstring required

The total fees for this order.

filled_atstring date-time nullable

The time the order was filled.

idstring required

Unique resource identifier.

is_cancellableboolean required

Whether the order can be cancelled now; true only for limit orders in a cancellable phase with no fills.

limit_pricestring nullable

Limit price per unit; null for market orders.

modified_atstring date-time required

The timestamp (in ISO-8601 format) of when the resource was last modified.

net_cash_amountstring nullable

The amount to invest after fees. This is what gets traded.

order_type'market' | 'limit' required

positionstring nullable

ID of the position this order belongs to; null until the order executes.

purpose'user_request' | 'rollover' | 'square_off' | 'backfill' required

quantitystring nullable

Requested unit quantity for sell orders.

quotestring nullable

ID of the quote used to place this order. On FX orders, locks the executing rate; when omitted, the order trades at the live rate.

settled_atstring date-time nullable

The time the order was settled.

side'buy' | 'sell' required

traded_notionalstring required

The total notional value executed.

traded_quantitystring required

The total quantity executed.

Example response

[
  {
    "cancelled_at": "2026-07-14T09:34:12Z",
    "cash_amount": "1000.00",
    "fees": "1.50",
    "filled_at": "2026-07-14T09:34:12Z",
    "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"
    },
    "limit_price": "95.1000",
    "net_cash_amount": "998.50",
    "quantity": "10.5",
    "settled_at": "2026-07-16T09:34:12Z",
    "traded_notional": "998.50",
    "traded_quantity": "10.5",
    "trades": [
      {
        "accrued_interest": "871.23",
        "executed_at": "2026-07-14T09:34:12Z",
        "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"
        },
        "notional": "99250.00",
        "price": "99.25",
        "quantity": "1000",
        "settled_at": "2026-07-16T10:15:00Z",
        "settlement_date": "2026-07-16",
        "ytm": "4.25"
      }
    ]
  }
]