Skip to main content
POST
Create order draft

Body Parameters

string
required
Market condition id.
boolean
required
Outcome side selection for the order.
string
required
Order side: buy or sell (case-insensitive). Must be a JSON string, not a numeric code.
string
required
Order type: limit or market (case-insensitive). Must be a JSON string, not a numeric code.
string
Required for limit orders. Must be between 0 and 1.
string
Required for limit orders and market sells.
string
Required for market buys.
Spot CLOB only. This endpoint places orders on the spot orderbook (config.kind = orderbook). Markets with margin_enabled=true or a Polymarket/Hyperliquid margin backend are rejected. Use margin position requests for leveraged positions.
Sign the returned message, then call Submit order with the hex signature (see that page).

Response

On success the API returns 201 Created. When the draft order pubkey is available, the response includes a Location header pointing to GET /orders/{pubkey}/.
object
Created order draft payload.
object
Empty object on success for this endpoint.
object | null
null on success. Error object on failed requests.