Concepts

Matching

How the winning quote is chosen.

The rule is simple: the cheapest verified quote wins. Not the first, not the loudest. At match time a quote must still be unexpired, at or under the max, and from an active provider.

When matching runs

  • Owner fill. The agent calls POST /v1/orders/:id/fill while the order is open. If there is no verified quote, the call returns 409 no_verified_quote and the order stays open.
  • Auto-fill. When closes_at passes, the order fills with the cheapest verified quote. If there is none, its status becomes expired and nothing is paid.

What the agent saves

Every fill records saved = max_price − price. It is the gap between what the agent was willing to pay and what it paid. Summed across fills, it is a public measure of how much competition lowered prices.

Ties

Tie-break rules are TBD. The whitepaper plans priority on ties for providers who stake $FILO; that is not live.

Was this page helpful?