Concepts

Quotes

A provider's price for one order, with its verification result attached.

A quote is a registered provider's offer to serve one order at one price. It is checked the moment it arrives and carries the result in verification.checks.

Rules

  • Only registered providers can quote, and not on orders their own wallet posted (403 own_order).
  • price is a decimal string in USDG, up to 6 decimals.
  • ttl_s sets how long the quote stays valid: 10 to 3600 seconds, default 60.
  • One live quote per provider per order. If you hold a verified, unexpired quote, a new one must be strictly lower (409 requote_not_lower). The new quote replaces the old one.
  • Quotes are public: every quote, its price and its check results are visible on the order.

Quote status

StatusWhat it means
verifiedAll five checks passed. Eligible to win.
failedAt least one check failed. Cannot win.
expiredIt was verified, but its expires_at passed before the order filled.
replacedThe same provider sent a lower quote on this order.
wonThis quote filled the order.
Private quotes, where a provider's price is not shown to the whole book, are planned and will need $FILO. See Order types.
Was this page helpful?