Sign in
Trading

Place market order

Creates a new market order.

Sell orders - send quantity (base asset amount to sell). Do not send amount.

Buy orders - send amount (maximum quote asset to spend). The base quantity is derived automatically from the live orderbook, using the same logic as the easy buy feature. Do not send quantity. Minimum spend is 5 quote units.

post/orders/market

Request body

marketstring required
side'buy' | 'sell' required
quantitystring

Sell orders only. Base asset quantity to sell. Must not be sent on a buy order.

amountstring

Buy orders only. Maximum quote asset to spend. The base quantity is derived automatically from the live orderbook. Must not be sent on a sell order. Minimum 5 quote units.

client_order_idstring

Optional idempotency key.

Example request

{
  "market": "BTCZAR",
  "side": "buy",
  "quantity": "0.01",
  "amount": "10000",
  "client_order_id": "my-order-2"
}

Response

Order created successfully.

order_idstring
client_order_idstring
marketstring
side'buy' | 'sell'
type'limit' | 'market' | 'stop_limit' | 'stop_market'
pricestring nullable

Null for market orders.

quantitystring
filledstring
remainingstring
status'open' | 'partially_filled' | 'filled' | 'cancelled' | 'rejected'
time_in_force'GTC' | 'IOC' | 'FOK'
created_atinteger
updated_atinteger
cancelled_atinteger nullable

Present when the order has been cancelled.

Example response

{
  "order_id": "order-001",
  "client_order_id": "my-order-1",
  "market": "BTCZAR",
  "side": "buy",
  "type": "limit",
  "price": "1020000",
  "quantity": "10000000",
  "filled": "0",
  "remaining": "10000000",
  "status": "open",
  "time_in_force": "GTC",
  "created_at": 1710000000,
  "updated_at": 1710000001,
  "cancelled_at": 1710000100
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.