Sign in

v7

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0462198511.0 KB
trading

Get an order quote

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

Path parameters

account_idstring required

Request body

instrument_idstring required

ID of the instrument to quote.

return_only_feesboolean

Whether to return only applicable fees.

side'buy' | 'sell' required

Response

OK

cash_amountstring nullable

The gross cash amount (before fees). Set for buys.

estimated_cashstring nullable

The estimated cash value.

estimated_pricestring required

The estimated price per unit.

estimated_quantitystring nullable

Estimated unit quantity that would be traded.

expires_atstring date-time nullable

When the quote expires. Null only for currency-pair previews.

feesstring required

The estimated fees.

idstring nullable

The quote ID, redeemable via quote_id at order placement. Null only for currency-pair previews.

instrumentstring required

The ID of the instrument being quoted.

is_bindingboolean nullable

Whether the quote's price is binding at execution.

limit_pricestring 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_coststring nullable

Maximum cash a limit buy can consume; set on limit buy quotes.

min_proceedsstring nullable

Minimum proceeds a limit sell yields; set on limit sell quotes.

net_cash_amountstring nullable

The net cash amount (after fees).

quantitystring nullable

The unit quantity. Set for sells.

side'buy' | 'sell' required

Example response

{
  "cash_amount": "1000.00",
  "estimated_cash": "998.55",
  "estimated_price": "95.10",
  "estimated_quantity": "10.5",
  "expires_at": "2026-07-14T09:35:00Z",
  "fees": "1.50",
  "limit_price": "95.1000",
  "max_cost": "1000.00",
  "min_proceeds": "950.00",
  "net_cash_amount": "998.50",
  "quantity": "10.5"
}