Place an order
Submits an order for the authenticated client. Supported types are
LIMIT, MARKET and STOP_LIMIT; the required fields vary by type
(a MARKET BUY is sized by quote_value, STOP_LIMIT adds stop_price).
Idempotency
Replays of the same client_order_id return the original order with
type=DUPLICATE_REPLAY instead of creating a new one.
Authorizations
HMAC-SHA256 authentication. Sign every request and send X-API-KEY, X-API-SIGNATURE, X-API-TIMESTAMP and X-API-NONCE (see the Authentication guide). Each route also requires a specific claim on your API key (e.g. read:orders, write:orders, read:account, read:market-data).
Body
Order payload. Required fields depend on type (LIMIT, MARKET, STOP_LIMIT).
Order side.
BUY, SELL "BUY"
Order type. LIMIT, MARKET and STOP_LIMIT are accepted.
LIMIT, MARKET, STOP_LIMIT "LIMIT"
Base asset quantity (string-encoded decimal). Required for all orders except a MARKET BUY, which is sized by quote_value instead.
"0.50"
Client-generated idempotency key (UUID v4). Replays of the same value return the original order.
"a1b2c3d4-e5f6-7890-abcd-ef0123456789"
Trading pair id (e.g. BTC-USD, ETH-USDC).
"ETH-USDC"
Quote spend (string-encoded decimal). Required for a MARKET BUY (the amount of quote currency to spend); ignored otherwise.
"100.00"
Limit price (string-encoded decimal). Required for LIMIT and STOP_LIMIT orders; omitted for MARKET (executes at the prevailing price).
"3000.00"
Stop (trigger) price (string-encoded decimal). Required for STOP_LIMIT orders; ignored otherwise.
"2900.00"
Response
Order creation outcome. Inspect data.type to distinguish NEW_ORDER, DUPLICATE_REPLAY, and the *_EXECUTION_FAILED variants.