Skip to main content
Create multiple limit orders in a single API call. Each item in the orders array is validated and matched independently — partial failures do not block successful orders in the same batch.
On-chain currencies (OOM, USDC) on the phase-one preview host. An on-chain order is only accepted with its own signed LimitOrderIntent, and the per-Safe nonce allows one order per signature. An item without a valid intent fails. Hosts that do not read the intent fields on batch items reject every on-chain item. The supported way to quote is a loop over POST /orders/: signing context → sign → create, one order at a time. See Quote with a per-order loop.
This endpoint replaces your quotes. Before the first item on a market is created, every open order you have on that event, market, and currency is canceled, whatever the value of cancel_conflicting_orders. Their IDs come back in cancelled_existing_order_ids. If that item then fails, its cancellations are rolled back. Later items on the same market in the same batch do not cancel again.

Endpoint

Authentication

This endpoint requires HMAC authentication. Include the Key, Timestamp, and HMAC headers on every request. See the authentication guide for signing instructions.

Headers

string
Optional. A unique value chosen by the client for a logical operation. Replaying the same POST with the same key and the same JSON body returns the stored response without creating duplicate orders. A different body produces a new fingerprint, so requoting is not blocked.

Request

object[]
required
An array of 1 to 20 order objects. Each entry follows the same shape as Create order.

Response

Returns 200 OK with one result per submitted order, plus the IDs of your existing orders that were canceled and replaced. A batch returns 200 even when every item failed, so check each success.
object[]
required
Per-order result, returned in the same order as the request.
integer[]
required
IDs of your existing open orders on the touched markets that were canceled and replaced by this batch.

Example

Sample response (200 OK), nested objects trimmed

Quote with a per-order loop

For OOM and USDC on the preview host, place each quote with its own signed create. The nonce is sequential per Safe, so do not run these in parallel for one Safe.
python
Create requests are limited to 30 per minute per account. See Rate limits and the end-to-end example.