$FILOBuy on Pons

Batches

Create a batch

Post up to 20 orders at once.

POST/v1/orders/batch

Creates every order in one call with a shared batch_id. All orders are validated first: either all are created or none. Each order then lives on its own and fills on its own cheapest verified quote. See Batch orders.

Headers

Authorizationstringrequired

Bearer fb_live_…. An API key created in the app. A browser session cookie also works. See Authentication.

Optional headers

Idempotency-Keystring

8 to 100 characters (A-Z a-z 0-9 - _ : .). Send the same key when you retry and you get the first response back instead of a second order. See Idempotency.

Body

ordersobject[]required

1 to 20 orders. Each takes request, type, max_price, and optionally rule and conditions, as in Create an order.

quote_window_sinteger

10 to 600, default 60. Shared by all orders.

Response

BatchBatch

201 Created. See Batch.

Errors

400invalid_*

invalid_batch (empty or more than 20), or the first invalid order's error with its index, e.g. orders[1]: request is required….

429rate_limited

More than 10 batches in a minute.

403key_*

The API key's policy refused it: key_read_only, key_type_not_allowed, key_max_order or key_daily_budget. See API keys and controls.

409idempotency_in_progress

The first request with this Idempotency-Key is still running. Retry in a moment.

422idempotency_mismatch

This Idempotency-Key was already used with a different body.

Request
curl -X POST https://dapp.filobook.run/v1/orders/batch \
  -H "Authorization: Bearer $FILOBOOK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_window_s": 60,
    "orders": [
      { "request": "BTC-USD last trade, JSON", "type": "market_data", "max_price": "0.01" },
      { "request": "ETH-USD last trade, JSON", "type": "market_data", "max_price": "0.01" }
    ]
  }'
Response · 201
{
  "id": "bat_2f9c41d07e6a83b5",
  "agent": "0x7fcfe1806936b8fe3a04f6d9c0dffb0d455bb514",
  "created_at": "2026-11-14T06:17:02.000Z",
  "summary": { "orders": 2, "open": 2, "filled": 0, "expired": 0, "cancelled": 0, "spent": "0", "saved": "0" },
  "orders": [
    { "id": "ord_5b8e02c4f1a97d36", "request": "BTC-USD last trade, JSON", "batch_id": "bat_2f9c41d07e6a83b5", "status": "open", "...": "..." },
    { "id": "ord_c13a9f60e72b4d58", "request": "ETH-USD last trade, JSON", "batch_id": "bat_2f9c41d07e6a83b5", "status": "open", "...": "..." }
  ]
}
Was this page helpful?
PreviousStatementNext Get a batch