Skip to main content
POST
Place order

Authentication

Write authentication required — X-Public-Key, X-Timestamp, and X-Signature headers. See the Authentication guide.

Path parameters

string
required
UUID of the event.
string
required
UUID of the market.

Request body

string
required
BUY or SELL.
string
required
UUID of the outcome. Use the Get Event endpoint to find outcome IDs.
number
required
Amount to spend (buy) or receive (sell), in the specified currency. Minimum: $1.00 USD / ₦100.00 NGN.
string
required
LIMIT or MARKET.
string
USD (default) or NGN.
number
Limit price per share (0.01–0.99). Required for LIMIT orders.
string
GTC (good-til-cancelled, default for limit), GTD (good-til-date), FAK (fill-and-kill, default for market), or FOK (fill-or-kill).
boolean
If true, the order is rejected instead of crossing the spread. Limit orders only. Default: false.
string
Self-trade prevention mode. Controls how the engine resolves a match against another resting order from the same user. CLOB only. Default: SKIP. Unknown values fall back to SKIP.
  • SKIP — the match is silently skipped and both orders remain on the book.
  • CANCEL_OLDEST — the resting same-user maker is cancelled and refunded; the taker continues matching against other counterparties.
  • CANCEL_NEWEST — the incoming taker stops at the same-user match. If it had already filled against other users, those fills stand and the taker comes back as cancelled; otherwise it is rejected.
  • CANCEL_BOTH — the resting maker is cancelled and the taker is cancelled or rejected under the same rule as CANCEL_NEWEST.
number
Maximum acceptable slippage for market orders (0.00–1.00).
string
ISO 8601 expiration timestamp. Required for GTD orders.

Example request

Response

The response contains an engine field indicating the market type, and an order object with the order details.
string
AMM or CLOB.
object
The placed order. Fields vary by engine type.

Replacing market-maker quotes with stpMode

A market maker re-quoting on both sides of a CLOB book risks crossing its own resting orders mid-update. Setting stpMode to CANCEL_OLDEST cancels the stale same-user maker server-side as the new quote arrives, so the new order can continue matching against external counterparties without sitting next to a duplicate of itself.
cURL