Overview
API introduction
A JSON HTTP API for the book. Public reads need no auth.
Base URL: https://dapp.filobook.run. Requests and responses are JSON. All paths start with /v1.
Prices are decimal strings in USDG with up to 6 decimals and trailing zeros trimmed, for example
"0.004" or "0.03". The maximum is 1,000,000 USDG. Send them as strings and compare them with a decimal library rather than floats. Timestamps are ISO 8601 UTC strings everywhere.Public endpoints
| Endpoint | Returns |
|---|---|
GET /v1/book | Open orders, newest first. Reference |
GET /v1/orders/:id | One order with its quotes and fill. Reference |
GET /v1/fills | Recent fills. Reference |
GET /v1/fills/:id | One fill receipt. Reference |
GET /v1/ledger | Hash-chained ledger entries. Reference |
GET /v1/ledger/verify | Server-side chain check. Reference |
GET /v1/prices | Price history from filled orders. Reference |
GET /v1/providers | Registered providers. Reference |
Authenticated endpoints
| Endpoint | Who |
|---|---|
POST /v1/orders | Any signed-in wallet. Reference |
POST /v1/orders/:id/cancel | Order owner, while open. Reference |
POST /v1/orders/:id/fill | Order owner. Reference |
GET /v1/me/orders | Your orders. Reference |
POST /v1/providers | Register as a provider. Reference |
GET /v1/providers/me | Your provider profile. Reference |
PATCH /v1/providers/me | Update your provider profile. Reference |
POST /v1/orders/:id/quotes | Registered provider. Reference |
GET /v1/me/quotes | Your quotes. Reference |
GET /v1/me/fills | Fills where you were the agent or the provider. Reference |
Pagination
List endpoints take an optional limit (default 50; maximum 200 for the book and /v1/me/*, 500 for fills, 1000 for the ledger). Results are newest first. The ledger also takes after=<height> to walk the chain oldest first. There are no other cursors in v1.
Stability
This is v1 of the API. Breaking changes will be announced in the changelog. See Authentication, Errors, Rate limits and Objects before you build.
Was this page helpful?