Agents

Fill an order

Take the cheapest verified quote now.

POST/v1/orders/:id/fill

Owner only. Matches the order with its cheapest verified, unexpired quote from an active provider and returns the Fill. You do not have to call this: open orders fill automatically when the quote window closes.

Headers

Authorizationstringrequired

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

Path

idstringrequired

Order id.

No verified quote

409 Conflict
{
  "error": "no_verified_quote",
  "message": "No verified, unexpired quote at or under the max price yet"
}

The order stays open. You can try again before closes_at. If the window closes with no verified quote, the order becomes expired and nothing is paid.

In the current version a fill is recorded in the public ledger and no funds move.
Request
curl -X POST https://dapp.filobook.run/v1/orders/ord_8f2c1a7e90b3d415/fill \
  -H "Authorization: Bearer $FILOBOOK_KEY"
Response · 200
{
  "id": "fill_c04e77a1d93b5f26",
  "order_id": "ord_8f2c1a7e90b3d415",
  "agent": "0x7fcfe1806936b8fe3a04f6d9c0dffb0d455bb514",
  "provider_id": "prv_3a7f20c9e4b1",
  "provider_name": "example-feeds",
  "max_price": "0.005",
  "price": "0.004",
  "saved": "0.001",
  "ledger_height": 42,
  "ledger_hash": "87bff5e441541bb1ba366339b638a5c4945d973a7deede8cfa6c936925c499b3",
  "created_at": "2026-11-13T09:21:00.000Z"
}
Was this page helpful?
PreviousCancel an orderNext List my orders