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

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

Request Body

symbol
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
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 placement response
timestamp
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

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