---
title: "Get an order quote"
method: POST
path: "/accounts/{account_id}/order-quotes"
tags: ["trading"]
---

# Get an order quote

`POST /accounts/{account_id}/order-quotes`

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.

## Path parameters

- `account_id` string, required

## Request body

- OrderQuoteRequest
  - `cash_amount` union — The cash amount for a buy order.
    - number
    - string
  - `instrument_id` string, required — ID of the instrument to quote.
  - `limit_price` union — Optional limit price. When set, the quote is a deterministic bound: `estimated_price` echoes the limit, a cash buy returns affordable quantity and `max_cost`, a sell returns `min_proceeds`.
    - number
    - string
  - `quantity` union — The unit quantity for a sell order.
    - number
    - string
  - `return_only_fees` boolean — Whether to return only applicable fees.
  - `side` 'buy' | 'sell', required

## Response `200`

OK

- OrderQuote — Quote returned by `/order-quotes`. Security quotes are persisted and carry an `id` and `expires_at` so they can be referenced via `quote_id` at order placement; they are non-binding references to the previewed terms. Currency-pair quotes issued through this endpoint are id-less previews.
  - `cash_amount` string, nullable — The gross cash amount (before fees). Set for buys.
  - `estimated_cash` string, nullable — The estimated cash value.
  - `estimated_price` string, required — The estimated price per unit.
  - `estimated_quantity` string, nullable — Estimated unit quantity that would be traded.
  - `expires_at` string, date-time, nullable — When the quote expires. Null only for currency-pair previews.
  - `fees` string, required — The estimated fees.
  - `id` string, nullable — The quote ID, redeemable via `quote_id` at order placement. Null only for currency-pair previews.
  - `instrument` string, required — The ID of the instrument being quoted.
  - `is_binding` boolean, nullable — Whether the quote's price is binding at execution.
  - `limit_price` string, nullable — The worst-case limit price the quote is bounded by. Set on limit quotes; a placement referencing the quote must use the same limit.
  - `max_cost` string, nullable — Maximum cash a limit buy can consume; set on limit buy quotes.
  - `min_proceeds` string, nullable — Minimum proceeds a limit sell yields; set on limit sell quotes.
  - `net_cash_amount` string, nullable — The net cash amount (after fees).
  - `quantity` string, nullable — The unit quantity. Set for sells.
  - `side` 'buy' | 'sell', required

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.net/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/versions/250f4b477cbf/schema)