Place and Cancel Orders via the Bravado Trade API v2

Place single and batch Polymarket orders: LIMIT, MARKET, TWAP, ICEBERG, PEGGED, and stop variants, and cancel them via the Bravado API.

The order endpoints let you place, inspect, and cancel orders on the Polymarket CLOB. A single 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. The type field selects the execution strategy; some fields are required or ignored depending on the chosen type (see notes below each parameter).

Required headers

Header	Value
Authorization	Bearer <token>
Idempotency-Key	Unique string (UUID recommended)
Content-Type	application/json

Request body

symbol · string · required

Polymarket outcome token ID (hex address). Identifies the specific outcome (e.g. the YES token of a market).

side · string · required

"buy" or "sell".

type · string · required

Execution strategy. One of: LIMIT | MARKET | PEGGED | TWAP | ICEBERG | TAKE_PROFIT | STOP_LOSS | TRAILING_STOP.

price · string

Decimal probability in the range 0.001–0.999 (e.g. "0.72"). Required for LIMIT, ICEBERG, TAKE_PROFIT, and STOP_LOSS orders.

size · string

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.

quote_amount · string

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.

time_in_force · string

GTC (Good Till Cancelled, default) | IOC (Immediate or Cancel) | FOK (Fill or Kill). Applies to LIMIT and MARKET types.

budget_usdc · string

Dollar budget for a PEGGED buy order. Equivalent to passing quote_amount for this order type.

offset_ticks · number

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.

price_floor · number

PEGGED only. Minimum price (decimal probability) the pegged order will chase. The order will not follow the touch below this level.

price_ceiling · number

PEGGED only. Maximum price (decimal probability) the pegged order will chase.

condition_id · string

Polymarket condition ID (0x + 64 hex characters). Required for PEGGED orders.

outcome · string

"yes" or "no". Required for PEGGED orders to determine which side of the condition the order tracks.

execution · object

Advanced execution parameters for TWAP, ICEBERG, and TRAILING_STOP orders.

Show execution fields

duration_sec · number

Total strategy duration in seconds (TWAP).

interval_sec · number

Time between child order placements in seconds (TWAP).

clip_size · string

Maximum share size of each child order (ICEBERG).

randomize_pct · number

Random jitter applied to clip_size as a percentage, e.g. 10 means ±10% (ICEBERG, TWAP).

price_tolerance_pct · number

Maximum acceptable price slippage as a percentage before a child order is skipped (TWAP).

trailing_offset_pct · number

Trail distance expressed as a percentage of the reference price (TRAILING_STOP).

trailing_offset · string

Trail distance expressed as an absolute decimal probability offset (TRAILING_STOP). Use either this or trailing_offset_pct, not both.

high_water_mark · string

Initial reference price for a TRAILING_STOP. The stop activates once the price moves this far in your favor.

take_profit · object

Bracket take-profit to attach to a LIMIT or MARKET buy. Placed as a resting limit sell once the parent order fills.

Show take_profit fields

price · string · required

Exit price as a decimal probability.

size · string

Shares to sell. Defaults to full fill size if omitted.

stop_loss · object

Bracket stop-loss to attach to a LIMIT or MARKET buy. Activates as a market sell when the price touches the trigger.

Show stop_loss fields

price · string · required

Trigger price as a decimal probability.

size · string

Shares to sell. Defaults to full fill size if omitted.

client_order_id · string

Your own reference string (max 64 characters). Stored and echoed back; not used for idempotency (use Idempotency-Key for that).

Response

type · string

The order type submitted, e.g. "LIMIT".

order_id · string

CLOB order ID. Present for LIMIT, MARKET, TAKE_PROFIT, and triggered stops. Absent for managed strategies, use record_id instead.

record_id · string

Strategy record ID. Present for PEGGED, TWAP, ICEBERG, STOP_LOSS, and TRAILING_STOP orders.

status · string

OPEN | FILLED | PARTIALLY_FILLED | CANCELED | ACTIVE (strategies).

side · string

"buy" or "sell".

price · string

Limit price as submitted.

size · string

Total order size in shares.

filled_size · string

Shares filled at time of response.

remaining_size · string

Shares still resting on the book.

matched_amount · string

Dollar value of fills matched so far.

builder_code_used · string

Builder code credited for this order (may differ from submission if overridden by partner config).

created_at · string

ISO 8601 timestamp of order creation.

brackets · object

Present when bracket orders were attached. Contains take_profit and/or stop_loss sub-objects each with order_id and record_id.

warnings · array

Non-fatal advisory messages, e.g. ["bracket size capped to fill size"].

message · string

Human-readable status message.

Examples

LIMIT buy

// POST /v2/trade/order
// Idempotency-Key: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "symbol": "0x1234...abcd",
  "side": "buy",
  "type": "LIMIT",
  "price": "0.65",
  "size": "200",
  "time_in_force": "GTC"
}

Example response (LIMIT buy)

{
  "type": "LIMIT",
  "order_id": "0xorder123...abc",
  "record_id": null,
  "status": "OPEN",
  "side": "buy",
  "price": "0.65",
  "size": "200",
  "filled_size": "0",
  "remaining_size": "200",
  "matched_amount": "0",
  "builder_code_used": "bravado",
  "created_at": "2025-01-15T12:34:56Z",
  "brackets": null,
  "warnings": [],
  "message": "Order placed successfully"
}

---

POST /v2/trade/order/batch

Places up to 20 limit orders atomically at distinct price levels. All orders share the same symbol 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

Header	Value
Authorization	Bearer <token>
Idempotency-Key	Unique string (UUID recommended)
Content-Type	application/json

Request body

symbol · string · required

Polymarket outcome token ID for all orders in the batch.

side · string · required

"buy" or "sell", applies to every rung.

rungs · array · required

Array of up to 20 price/size pairs. Each element must have a unique price.

Show rung fields

price · string · required

Limit price as a decimal probability.

size · string · required

Number of shares for this rung.

Response

orders · array

One entry per submitted rung, in the same order as the request.

Show order fields

order_id · string

CLOB order ID for this rung.

price · string

Confirmed limit price.

size · string

Total size for this rung.

status · string

OPEN | FILLED | PARTIALLY_FILLED.

filled_size · string

Shares immediately filled (if any resting liquidity was crossed).

Example

Request: 3-rung bid ladder

// POST /v2/trade/order/batch
// Idempotency-Key: d4e5f6a7-b8c9-0123-defa-123456789003

{
  "symbol": "0x1234...abcd",
  "side": "buy",
  "rungs": [
    { "price": "0.60", "size": "150" },
    { "price": "0.55", "size": "200" },
    { "price": "0.50", "size": "300" }
  ]
}

---

GET /v2/trade/orders/open

Returns all currently open CLOB orders on the account. Optionally filter to a single outcome token.

Query parameters

token_id · string

Filter results to orders on a specific outcome token ID.

Response

orders · array

Array of open order objects.

Show order fields

order_id · string

CLOB order ID.

asset_id · string

Outcome token address this order is on.

side · string

"buy" or "sell".

status · string

OPEN or PARTIALLY_FILLED.

price · string

Limit price as a decimal probability.

original_size · string

Total shares when the order was placed.

size_matched · string

Shares filled so far.

remaining_size · string

Shares still resting on the book.

order_type · string

LIMIT | TAKE_PROFIT | STOP_LOSS | ICEBERG_SLICE.

expiration · string

Unix timestamp after which the order auto-cancels, or null for GTC.

created_at · string

ISO 8601 creation timestamp.

is_take_profit · boolean

true when this order was placed as a bracket take-profit.

is_stop_loss · boolean

true when this order was placed by a triggered stop-loss strategy.

is_pegged · boolean

true when this order is being managed by a pegged strategy.

---

DELETE /v2/trade/orders/

Cancels a single open order by its CLOB order ID.

Path parameters

order_id · string · required

The CLOB order ID to cancel.

Response

cancelled · array

List of order IDs successfully cancelled.

not_cancelled · array

List of order IDs that could not be cancelled (e.g. already filled).

count · number

Total number of successfully cancelled orders.

---

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 headers

Header	Value
Authorization	Bearer <token>
Idempotency-Key	Unique string (UUID recommended)
Content-Type	application/json

Request body

order_ids · string[] · required

Array of up to 50 CLOB order IDs to cancel.

Response

cancelled · array

Order IDs that were successfully cancelled.

not_cancelled · array

Order IDs that could not be cancelled (already filled, invalid ID, etc.).

count · number

Number of successfully cancelled orders.

Example

Request

// POST /v2/trade/orders/cancel-batch
// Idempotency-Key: e5f6a7b8-c9d0-1234-efab-234567890104

{
  "order_ids": [
    "0xorderA...001",
    "0xorderB...002",
    "0xorderC...003"
  ]
}

---

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), use DELETE /v2/trade/strategies/{id} for those.

Required headers

Header	Value
Authorization	Bearer <token>
Idempotency-Key	Unique string (UUID recommended)

Response

cancelled · array

All order IDs that were cancelled.

not_cancelled · array

Any order IDs that could not be cancelled.

count · number

Total orders cancelled.

cancel-all removes resting bracket orders (take-profits and stop-loss CLOB orders) as well as plain limit orders. If you only want to remove non-bracket orders, use cancel-batch with a filtered list.