v6

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

trading

Place an order

Places a buy-side or sell-side market or limit order. Buys are cash-based; sells require a unit quantity.

post/accounts/{account_id}/orders

Path parameters

account_idstring required

Request body

automatic_rolloverboolean nullable

Whether the resulting position rolls into a similar instrument at maturity; valid only for eligible buy orders.

instrumentstring required

The ID of the instrument to buy or sell.

order_type'market' | 'limit' required

quotestring nullable

ID of a previously issued order quote. FX orders replay the locked rate; security cash buys may reference a prior quote for a deviation check against the quoted amount.

side'buy' | 'sell' required

Response

Created

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"
    }
  ]
}