Batches

Get a batch

A batch with its orders and summary.

GET/v1/batches/:id

Public, like single orders. Private quote prices stay hidden from anyone but the agent while orders are open.

#Path

idstringrequired

Batch id.

Request

curl https://dapp.filobook.run/v1/batches/bat_2f9c41d07e6a83b5

Response · 200

{
  "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?

PreviousCreate a batch Next Fill a batch

Request

curl https://dapp.filobook.run/v1/batches/bat_2f9c41d07e6a83b5

Response · 200

{
  "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", "...": "..." }
  ]
}