Public
Settlements
Every fill that settled on-chain, with its tx, so you can add the payments up yourself.
Public, cached for 30 seconds. Oldest first, up to 2,000 rows. The values above are an example.
To check a row on-chain, fetch the receipt of tx from any Robinhood Chain RPC. It must have succeeded, contain a log from contract with topic0 event_topic, topic1 = fill_id_hash and topic3 = the provider address, data price (in base units, = price_raw) and fee, and a USDG Transfer from the escrow to the provider of price − fee. The dapp's Settlements page does exactly this in your browser and adds the results up.
Deposits into the escrow are not payments. An agent deposits once; each settle then pays a provider out of that balance, so counting USDG transfers *into* the escrow does not give the settled total.
Response
count / totalnumber / stringSettled fills and the USDG they paid.
team / outsideobject{ count, total } split by whether either side is the FiloBook team.
settlements[]object[]One row per settled fill: ids, agent, provider and its address, price and price_raw (6 decimals), tx, explorer, settled_at, team.
curl https://dapp.filobook.run/v1/settlements{
"enabled": true,
"contract": "0x5689Cd95D9106C7498D1760058d6b85D8A9F2288",
"chain_id": 4663,
"usdg": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
"event": "Settled(bytes32 indexed fillId, address indexed agent, address indexed provider, uint256 price, uint256 fee)",
"event_topic": "0x2b48913bcaac5ca8fccdc740976517c444980bc382c153617621804fc277a184",
"fill_id_hash": "keccak256(utf8(fill id))",
"count": 2,
"total": "0.002000",
"team": { "count": 1, "total": "0.001000" },
"outside": { "count": 1, "total": "0.001000" },
"settlements": [
{
"fill_id": "fill_8b510567e0e93174",
"fill_id_hash": "0xcd5362d3abbe4cf8572352fd94d3af9cf540b9c6de6c348002a97959756a5f91",
"order_id": "ord_d152f5fbad5a0d6e",
"agent": "0xe463d83bbd85503f57e50476b4ab64471a466ddd",
"provider_id": "prv_7ad548f5dc44",
"provider_name": "FiloBook Team · Spot prices",
"provider_address": "0xfdbda61810d0d141bcb81dba3ffeeb43939316e2",
"price": "0.001000",
"price_raw": "1000",
"tx": "0xfbf40e5bce6e202b8c52f6711dc74161d5ddf59007d57612013b686f2c3e4eab",
"explorer": "https://robinhoodchain.blockscout.com/tx/0xfbf40e5bce6e202b8c52f6711dc74161d5ddf59007d57612013b686f2c3e4eab",
"settled_at": "2026-11-15T07:03:08.143Z",
"team": true
}
]
}