Skip to main content
POST
Get Order Quote

Overview

Get an estimated price quote for an order without actually placing it. This is useful for previewing the expected execution price and fees before committing to a trade. This endpoint requires authentication with an API key that has Trade scope.

Authentication

string
required
Your API key with Trade scope

Request Body

string
required
Trading pair symbolExample: USDT-NGNAllowed values: USDT-NGN, USDC-NGN, USD-NGN
string
required
Order sideAllowed values: buy, sell
string
required
Order typeAllowed values: limit, market
string
Order price (required for limit orders)Example: 1545.00
Required when type is limit. Not allowed for market orders.
string
Order quantity in the base asset. This field is required when use_max is false or omitted.Example: 100.00
boolean
Set this field to true to let the server resolve all usable cash and active trading credit to an order quantity. use_max takes precedence when the request also contains quantity.The server does not reduce the quantity to fit the orderbook or a trading limit. It returns the normal liquidity or guardrail error if the full quantity is not valid.
string
Optional client idempotency key. For a limit order, use the same value when you place the quoted order. The server uses this value when it simulates self-trade prevention and calculates the limit-order fee authorization.Example: order-20260903-001

Request Examples

Use all available funding

The following request keeps quantity as a compatibility fallback for an older server. A server that supports use_max ignores the fallback and calculates the quantity from the API-key owner’s current usable funding.

Quote and place a limit order

Use one client_order_id for the quote and the placement. Send the quote’s estimated_fee, including 0.00, unchanged as max_taker_fee when you place the limit order. This value is a fee authorization cap. The server charges only the realized fee.

Response

boolean
required
Indicates if the request was successful
string
required
Human-readable response message
object
required
Order quote detailsquantity, total_value, estimated_fee, estimated_hold_buffer, estimated_total, and the cash and credit fields are decimal strings with two fractional digits. price and estimated_price can contain additional execution-price precision.
Use estimated_total for buy affordability and percentage sizing. Earlier server versions can omit estimated_hold_buffer; in those responses, estimated_fee can include both the simulated fee and the temporary hold buffer. When estimated_hold_buffer is present, estimated_fee contains the simulated trading fee only.
string
ISO 8601 timestamp of the response

Success Response

Error Responses

Notes

  • Quotes are estimates based on the current state of the orderbook and may differ from the actual execution price.
  • The quote does not reserve liquidity or lock funds.
  • For market orders, the estimated price is the volume-weighted average price across the available orderbook depth.
  • A successful use_max quote still does not reserve funds. Submit the returned explicit quantity. The placement can fail if funding, liquidity, or a trading limit changes after the quote.
  • For a limit order, keep the same client_order_id from quote to placement. Send the quote’s estimated_fee as max_taker_fee. If the realized taker fee would exceed this cap, the server rejects the order with TAKER_FEE_CAP_EXCEEDED.

Rate Limits

  • 100 requests per minute per API key

Next Steps

Place Order

Place the order after reviewing the quote

Get Orderbook

View the full orderbook depth