Batch place

POST/v1/px/orders/batchplace scope

Market Maker APIE6 decimal strings throughoutA | B

Submit several orders in one request.

Send X-PX-Key: pxk_…. This endpoint requires the place scope — an insufficient scope returns 403, not 401, and this line does not use Bearer sessions. To request a key and see the limits, visit the onboarding page.

Behaviour

1–15 orders per batch; each order has the same body as a single place.
Each order is validated and succeeds or fails on its own. results follows request order; failed entries carry code and message.
No batch-level atomicity.
Rate limiting charges one token per order. If the bucket cannot cover the whole batch, the whole request returns 429; nothing is partially admitted.

Request

curl -X POST "{BASE_URL}/v1/px/orders/batch" \
  -H "X-PX-Key: $PX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "orders": [
    { "marketId": "px-btc-120k", "outcome": "A", "side": "BUY",  "orderType": "LIMIT",
      "limitPriceE6": "520000", "quantityE6": "100000000", "tif": "GTC",
      "clientOrderId": "mm-btc-bid-01" },
    { "marketId": "px-btc-120k", "outcome": "A", "side": "SELL", "orderType": "LIMIT",
      "limitPriceE6": "540000", "quantityE6": "100000000", "tif": "GTC",
      "clientOrderId": "mm-btc-ask-01" }
  ]
}'

Response

The request was accepted

{
  "results": [
    { "index": 0, "ok": true,  "order": {
        "orderId": "ord_01K5H2M3N7Q8R9S0",
        "marketId": "px-btc-120k",
        "outcome": "A",
        "side": "BUY",
        "orderType": "LIMIT",
        "tif": "GTC",
        "limitPriceE6": "520000",
        "quantityE6": "100000000",
        "filledQuantityE6": "0",
        "status": "LIVE",
        "fills": [],
        "idempotentReplay": false
      } },
    { "index": 1, "ok": false, "code": "INVALID_PRICE", "message": "limitPriceE6 must be a multiple of the market tick" }
  ],
  "placed": 1,
  "rejected": 1
}