trading

Get an order quote

Changed on Oct 29, 2026

Issues a quote for a prospective order. The quote captures the fees and estimated price/quantity that would apply, is persisted, and carries an id and expires_at; pass the id as quote_id at order placement to reference the previewed terms. Placement rejects expired quotes.

post/accounts/{account_id}/order-quotes

Request

Base URL
https://api.engine.usesophic.com
Auth
HTTP bearer

Path parameters

account_idstring required

Request body

instrumentstring required

ID of the instrument to quote.

return_only_feesboolean

Whether to return only applicable fees.

side'buy' | 'sell' required

Response

Successful Response

Example response

{
  "blockers": [
    {
      "code": "trading_rule_violated",
      "context": {
        "actual": "99950.00",
        "required_cash_amount": "100053.00",
        "rule": "buy.min_initial_cash_amount"
      },
      "detail": "Instrument AMC001 requires a minimum initial investment of 100000. Invested amount is 99950.00"
    }
  ],
  "cash_amount": "10000.00",
  "estimate": {
    "fee_breakdown": [
      {
        "amount": "1.00",
        "display_name": "Settlement Fee",
        "label": "settlement_fee"
      }
    ],
    "fees": "1.00",
    "net_cash_amount": "9999.00",
    "price": "703.40",
    "quantity": "14"
  },
  "expires_in": 60,
  "instrument": {
    "about": "Common stock listed on the Nasdaq Global Select Market.",
    "asset_class": [
      {
        "weight": "0.48640000"
      }
    ],
    "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",
    "name": "Apple Inc.",
    "symbol": "US5949181045",
    "ticker": "AAPL",
    "trading_configuration": {
      "buy": {
        "min_cash_amount": "20000.00000000",
        "min_initial_cash_amount": "100000.00000000",
        "min_initial_quantity": "100.00000000",
        "min_quantity": "10.00000000",
        "modes": [
          "cash"
        ]
      },
      "sell": {
        "min_cash_amount": "1000.00000000",
        "min_quantity": "10.00000000",
        "modes": [
          "quantity"
        ]
      }
    },
    "trading_increment": "0.00010000"
  },
  "reservation": {
    "amount": "1000.00"
  }
}

Changes

Oct 29, 20266a63920239d8 Revision changes
- breaking
  removed subschema #1 from the request property anyOf list
- breaking
  removed subschema #1 from the request property anyOf list
- breaking
  removed subschema #1 from the request property anyOf list
- breaking
  request property was restricted to a list of enum values
- breaking
  the request property type changed from no type to string
- breaking
  added to the / response property oneOf list for the response status
- breaking
  added to the / response property oneOf list for the response status
- breaking
  added to the / response property oneOf list for the response status
- breaking
  added to the / response property oneOf list for the response status
- breaking
  added to the / response property oneOf list for the response status
- breaking
  added to the / response property oneOf list for the response status
- breaking
  added to the / response property oneOf list for the response status
- breaking
  added to the / response property oneOf list for the response status
- breaking
  added to the / response property oneOf list for the response status
- breaking
  added to the / response property oneOf list for the response status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the / response's property type changed from no type to string for status
- warning
  removed from the request property allOf list
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new buy enum value to the / response property for the response status
- warning
  added the new buy enum value to the / response property for the response status
- warning
  added the new buy enum value to the / response property for the response status
- warning
  added the new buy enum value to the / response property for the response status
- warning
  added the new buy enum value to the / response property for the response status
- warning
  added the new buy enum value to the / response property for the response status
- warning
  added the new buy enum value to the / response property for the response status
- warning
  added the new buy enum value to the / response property for the response status
- warning
  added the new buy enum value to the / response property for the response status
- warning
  added the new buy enum value to the / response property for the response status
- warning
  added the new cash enum value to the // response property for the response status
- warning
  added the new cash enum value to the // response property for the response status
- warning
  added the new cash enum value to the // response property for the response status
- warning
  added the new cash enum value to the // response property for the response status
- warning
  added the new cash enum value to the // response property for the response status
- warning
  added the new cash enum value to the // response property for the response status
- warning
  added the new cash enum value to the // response property for the response status
- warning
  added the new cash enum value to the // response property for the response status
- warning
  added the new cash enum value to the // response property for the response status
- warning
  added the new cash enum value to the // response property for the response status
- warning
  added the new limit enum value to the / response property for the response status
- warning
  added the new limit enum value to the / response property for the response status
- warning
  added the new limit enum value to the / response property for the response status
- warning
  added the new limit enum value to the / response property for the response status
- warning
  added the new limit enum value to the / response property for the response status
- warning
  added the new limit enum value to the / response property for the response status
- warning
  added the new limit enum value to the / response property for the response status
- warning
  added the new limit enum value to the / response property for the response status
- warning
  added the new limit enum value to the / response property for the response status
- warning
  added the new limit enum value to the / response property for the response status
- warning
  added the new market enum value to the / response property for the response status
- warning
  added the new market enum value to the / response property for the response status
- warning
  added the new market enum value to the / response property for the response status
- warning
  added the new market enum value to the / response property for the response status
- warning
  added the new market enum value to the / response property for the response status
- warning
  added the new market enum value to the / response property for the response status
- warning
  added the new market enum value to the / response property for the response status
- warning
  added the new market enum value to the / response property for the response status
- warning
  added the new market enum value to the / response property for the response status
- warning
  added the new market enum value to the / response property for the response status
- warning
  added the new sell enum value to the / response property for the response status
- warning
  added the new sell enum value to the / response property for the response status
- warning
  added the new sell enum value to the / response property for the response status
- warning
  added the new sell enum value to the / response property for the response status
- warning
  added the new sell enum value to the / response property for the response status
- warning
  added the new sell enum value to the / response property for the response status
- warning
  added the new sell enum value to the / response property for the response status
- warning
  added the new sell enum value to the / response property for the response status
- warning
  added the new sell enum value to the / response property for the response status
- warning
  added the new sell enum value to the / response property for the response status
- warning
  added the new units enum value to the // response property for the response status
- warning
  added the new units enum value to the // response property for the response status
- warning
  added the new units enum value to the // response property for the response status
- warning
  added the new units enum value to the // response property for the response status
- warning
  added the new units enum value to the // response property for the response status
- warning
  added the new units enum value to the // response property for the response status
- warning
  added the new units enum value to the // response property for the response status
- warning
  added the new units enum value to the // response property for the response status
- warning
  added the new units enum value to the // response property for the response status
- warning
  added the new units enum value to the // response property for the response status
- info
  added subschema #1 subschema #2 to the request property anyOf list
- info
  added subschema #1 subschema #2 to the request property anyOf list
- info
  added subschema #1 subschema #2 to the request property anyOf list
- info
  added the new buy enum value to the request property
- info
  added the new sell enum value to the request property
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property anyOf list for the response status
- info
  removed from the / response property anyOf list for the response status
- info
  removed from the / response property anyOf list for the response status
- info
  removed from the / response property anyOf list for the response status
- info
  removed from the / response property anyOf list for the response status
- info
  removed from the / response property anyOf list for the response status
- info
  removed from the / response property anyOf list for the response status
- info
  removed from the / response property anyOf list for the response status
- info
  removed from the / response property anyOf list for the response status
- info
  removed from the / response property anyOf list for the response status
- info
  added discriminator to / response property for the response status
- info
  added discriminator to / response property for the response status
- info
  added discriminator to / response property for the response status
- info
  added discriminator to / response property for the response status
- info
  added discriminator to / response property for the response status
- info
  added discriminator to / response property for the response status
- info
  added discriminator to / response property for the response status
- info
  added discriminator to / response property for the response status
- info
  added discriminator to / response property for the response status
- info
  added discriminator to / response property for the response status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
Oct 27, 2026b4b87fc2006c Revision changes
- breaking
  added the new required request property
- warning
  removed the request property
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status

Operation history (12 revisions)