Authenticate with HMAC. Signature values in request examples are placeholders; compute a fresh signature over the exact method, path and body. See authentication and the runnable quickstart.
POST /v2/trade/order call handles every order type, from a simple limit order to a multi-hour TWAP execution, using a unified request shape. Cancellation endpoints give you granular control to remove one order, a targeted batch, or every open order at once.
POST /v2/trade/order
Places a single order. Thetype field selects the execution strategy; some fields are required or ignored depending on the chosen type (see notes below each parameter).
Required headers
Request body
Polymarket outcome token ID (hex address). Identifies the specific outcome (e.g. the YES token of a market).
Execution strategy. One of:
LIMIT | MARKET | PEGGED | TWAP | ICEBERG | TAKE_PROFIT | STOP_LOSS | TRAILING_STOP.Decimal probability in the range
0.001–0.999 (e.g. "0.72"). Required for LIMIT, ICEBERG, TAKE_PROFIT, and STOP_LOSS orders.Number of shares as a decimal string (e.g.
"100"). Required for LIMIT, ICEBERG, TAKE_PROFIT, STOP_LOSS, and TRAILING_STOP orders, and for MARKET sell orders.US dollar notional as a decimal string. Used as:
- MARKET buy, total spend in dollars.
- TWAP, total dollar amount to execute over the strategy duration.
- PEGGED, alias for
budget_usdc.
GTC (Good Till Cancelled, default) | IOC (Immediate or Cancel) | FOK (Fill or Kill). Applies to LIMIT and MARKET types.PEGGED only. Number of CLOB ticks away from the best touch price at which the order rests. Positive values rest behind the touch; 0 rests at the touch.PEGGED only. Minimum price (decimal probability) the pegged order will chase. The order will not follow the touch below this level."yes" or "no". Required for PEGGED orders to determine which side of the condition the order tracks.Bracket take-profit to attach to a
LIMIT or MARKET buy. Placed as a resting limit sell once the parent order fills.Bracket stop-loss to attach to a
LIMIT or MARKET buy. Activates as a market sell when the price touches the trigger.Your own reference string (max 64 characters). Stored and echoed back; not used for idempotency (use
Idempotency-Key for that).Response
CLOB order ID. Present for
LIMIT, MARKET, TAKE_PROFIT, and triggered stops. Absent for managed strategies, use record_id instead.Builder code credited for this order (may differ from submission if overridden by partner config).
Present when bracket orders were attached. Contains
take_profit and/or stop_loss sub-objects each with order_id and record_id.Examples
POST /v2/trade/order/batch
Places up to 20 limit orders atomically at distinct price levels. All orders share the samesymbol and side, making this ideal for constructing bid or ask ladders in a single request. If any rung fails validation the entire batch is rejected.
Required headers
Request body
Response
Example
GET /v2/trade/orders/open
Returns all currently open CLOB orders on the account. Optionally filter to a single outcome token.Query parameters
Response
DELETE /v2/trade/orders/
Cancels a single open order by its CLOB order ID.Path parameters
Response
POST /v2/trade/orders/cancel-batch
Cancels up to 50 orders in a single request. Useful for clearing a subset of a ladder or removing specific bracket orders. Required headersRequest body
Response
Example
POST /v2/trade/orders/cancel-all
Cancels every open CLOB order on the account. No request body is required. This does not cancel managed strategy records (TWAP, Iceberg, Pegged, Stops), useDELETE /v2/trade/strategies/{id} for those.
Required headers