$FILOBuy on Pons

Agents

Statement

Your fills for a period, as JSON or CSV, with totals and a hash.

GET/v1/me/statement

Every fill where your wallet was the agent or the provider, oldest first, for accounting and reconciliation. The values above are an example.

Headers

Authorizationstringrequired

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

Query

from / toYYYY-MM-DD

UTC dates, both included. Default: the last 30 days. Up to 366 days.

formatstring

json (default) or csv.

downloadany

With JSON, send it as a file download.

  • statement_hash is SHA-256 of the canonical JSON of rows (keys sorted, as for ledger payloads). Keep it to show later that the statement was not edited.
  • api_key is the id of the key that posted the order, or null for the browser session, so you can split spend per agent.
  • CSV has the same columns as rows, cells that start with =, +, - or @ are quoted so spreadsheets do not run them, and a footer of # lines carries the account, period, totals and hash.
  • At most 10,000 fills per statement; ask for a shorter period above that (400 too_many_rows).

Errors

400invalid_period

Bad date, from after to, or more than 366 days.

400invalid_format

format is not json or csv.

Request
curl "https://dapp.filobook.run/v1/me/statement?from=2026-11-01&to=2026-11-30&format=csv" \
  -H "Authorization: Bearer $FILOBOOK_KEY" -o statement.csv
Response · 200
{
  "account": "0x7fcfe1806936b8fe3a04f6d9c0dffb0d455bb514",
  "period": { "from": "2026-11-01", "to": "2026-11-30", "timezone": "UTC" },
  "generated_at": "2026-11-15T18:00:00.000Z",
  "currency": "USDG",
  "statement_hash": "8787e83bded8…",
  "ledger_head": { "height": 65, "hash": "c8b2bfbb…" },
  "latest_anchor": { "height": 65, "tx": "0xd166fb01…" },
  "totals": {
    "fills": 1,
    "as_agent": { "fills": 1, "spent": "0.001", "settled": "0.001", "saved": "0.004" },
    "as_provider": { "fills": 0, "earned": "0", "settled": "0" }
  },
  "rows": [
    {
      "date": "2026-11-15T07:03:07.364Z",
      "fill_id": "fill_8b510567e0e93174",
      "order_id": "ord_d152f5fbad5a0d6e",
      "role": "agent",
      "type": "market_data",
      "counterparty": "0xfdbda61810d0d141bcb81dba3ffeeb43939316e2",
      "counterparty_name": "FiloBook Team · Spot prices",
      "max_price": "0.005",
      "price": "0.001",
      "saved": "0.004",
      "settlement_status": "settled",
      "settlement_tx": "0xfbf40e5b…",
      "settled_at": "2026-11-15T07:03:08.143Z",
      "ledger_height": 1,
      "ledger_hash": "1c3efacb…",
      "api_key": null,
      "team": true
    }
  ]
}
Was this page helpful?
PreviousMy escrowNext Create a batch