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

Headers

Idempotency-Keystring nullable

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

Changes

Changed in 6 of the 12 revisions of this API.541

Aug 31, 20260def92bc65f57See the full diff
- ○
  added the new optional header request parameter Idempotency-Key
  new-optional-request-parameter
- ○
  added to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  added to the // response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed discriminator from response property for the response status
  response-property-discriminator-removed
- ○
  removed discriminator from // response property for the response status
  response-property-discriminator-removed
- ○
  removed from the response property oneOf list for the response status
  response-property-one-of-removed
- ○
  removed from the // response property oneOf list for the response status
  response-property-one-of-removed
Aug 7, 20262b28ad4528812See the full diff
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property //// from the response with the status
  response-required-property-removed
Aug 3, 2026250f4b477cbf10See the full diff
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
Jul 27, 2026b95b7ffdc1eb12See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
Jul 17, 20268e8a8242f1f2311See the full diff
- ▲
  the // response's property type changed from string to no type for status
  response-property-type-changed
- ▲
  the // response's property type changed from string to no type for status
  response-property-type-changed
- ▲
  the // response's property type changed from string to no type for status
  response-property-type-changed
- ○
  added to the // response property allOf list for the response status
  response-property-all-of-added
- ○
  added to the // response property allOf list for the response status
  response-property-all-of-added
- ○
  added to the // response property allOf list for the response status
  response-property-all-of-added
- ○
  removed the EUR enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  removed the GBP enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  removed the USD enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  removed the buy enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  removed the executed enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  removed the pending enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the sell enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  removed the settled enum value from the // response property for the response status
  response-property-enum-value-removed
Jul 13, 202603da9bc8e86b1See the full diff
- ○
  api tag trading added
  api-tag-added
This revision also has 53 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history