Authenticated REST endpoints for placing and managing orders. Treat REST order placement as payload reference or a one-off server workflow; for active trading and market making, prefer WebSocket order.place.
Place order
Place a new prediction market order. Supports limit and stop-limit order types. Requires authentication and NewOrder permission.
Before sending orders, check GET /v1/prediction-markets/terms/status. If hasAcceptedLatest is false, display GET /v1/prediction-markets/terms and call POST /v1/prediction-markets/terms/accept, then retry the order.
Stop-Limit Orders
A stop-limit order is an order type that allows for order placement when a price reaches a specified level. Stop-limit orders take in both a price and a stopPrice as parameters. The stopPrice is the price that triggers the order to be placed on the continuous live order book at the price. For buy orders, the stopPrice must be greater than or equal to the last trade price and less than or equal to the price; for sell orders, the stopPrice must be less than or equal to the last trade price and greater than or equal to the price. Both price and stopPrice must be in the 0-1 range.
Place order › Request Body
symbolContract instrument symbol
orderTypeOrder type. stop-limit orders require a stopPrice that triggers a limit order at price when the market reaches the trigger.
sidequantityNumber of contracts
priceLimit price (0-1 range)
outcomeThe outcome being traded (Yes or No)
stopPriceThe price to trigger a stop-limit order (0-1 range). Only available for stop-limit orders. See Stop-Limit Orders above for stopPrice/price constraints.
timeInForceOrder execution behavior:
good-til-cancel- Order remains active until filled or cancelled (default)immediate-or-cancel- Fill immediately or cancel remainingfill-or-kill- Fill entire order immediately or cancel
makerOrCancelSet to true to require maker-only behavior. If the order would immediately take liquidity, the order is cancelled instead of filling.
Place order › Responses
Order created successfully
orderIdhashOrderIdclientOrderIdglobalOrderIdstatussymbolsideoutcomeThe outcome being traded (Yes or No)
orderTypeOrder type. stop-limit orders require a stopPrice that triggers a limit order at price when the market reaches the trigger.
quantityOriginal order quantity
filledQuantityAmount filled so far
remainingQuantityAmount remaining to fill
priceLimit price
stopPriceStop trigger price (populated for stop-limit orders)
avgExecutionPriceAverage price of fills
createdAtupdatedAtcancelledAt