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

X-Api-Key
string
required
Your API key with Trade scope

Request Body

symbol
string
required
Trading pair symbolExample: USDT-NGNAllowed values: USDT-NGN, USDC-NGN, USD-NGN
side
string
required
Order sideAllowed values: buy, sell
type
string
required
Order typeAllowed values: limit, market
price
string
Order price (required for limit orders)Example: 1545.00
Required when type is limit. Not allowed for market orders.
quantity
string
required
Order quantity in base assetExample: 100.00

Request Examples

Response

success
boolean
required
Indicates if the request was successful
message
string
required
Human-readable response message
data
object
required
Order quote details
timestamp
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.

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