Skip to main content
POST
Place Order

Overview

Place a new limit or market order on the Pro platform. 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 symbol. All symbols map to a unified USD balance.Example: USDT-NGN (recommended)Allowed 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
required
Order quantity in base assetExample: 100.00
string
Optional client idempotency key. For a limit order, use the same value that you sent when you requested the quote.Example: order-20260903-001
string
Maximum cumulative taker fee that you authorize for a limit order, in the quote asset. Send the estimated_fee value from the reviewed limit-order quote without changing it. Omission authorizes 0.00. Market orders ignore this field.Example: 30.90

Request Examples

Response

boolean
required
Indicates if the request was successful
string
required
Human-readable response message
object
required
Order placement response
string
ISO 8601 timestamp of the response

Success Response

Error Responses

Order Types

Limit Orders

Limit orders are placed on the orderbook and wait for a matching order:
  • Buy limit: Executes at the specified price or lower
  • Sell limit: Executes at the specified price or higher
  • Remains open until filled or cancelled
  • Can execute immediately as a taker. Request a quote first. Use the same client_order_id, and send the quote’s estimated_fee as max_taker_fee.
  • The server rejects the order if its cumulative taker fee would exceed max_taker_fee. The server charges only the realized fee, not the full cap.

Market Orders

Market orders execute immediately at the best available price:
  • May experience slippage if orderbook depth is low
  • Partially fills if insufficient liquidity

Order Status Flow

Rate Limits

  • 100 requests per minute per API key

Next Steps

List Orders

View your open orders

Cancel Order

Cancel an open order