Skip to main content
A maker serves three endpoints for quoting. GET /tokens lists the mints it quotes, GET /health reports whether it can honor quotes, and POST /quote returns a firm or indicative price for a pair.

​
Tokens Endpoint

GET /tokens returns a JSON array of the base58 mints the maker quotes. The array lists USDC, the settlement mint, and every equity mint. DFlow asks a maker to quote a pair only when both mints are listed.

​
Health Endpoint

GET /health returns any 2xx when the maker can honor quotes. Return a non-2xx when it cannot, for example when its pricing or inventory feed is down. The endpoint has no side effects and answers quickly.

​
Quote Request

POST /quote carries the request below. Amounts are raw base unit strings.

​
Quote Response

A firm quote returns 200 with the fields below. DFlow excludes a quote that breaks any rule in the table. An rfqOrder quote carries no token accounts. DFlow drops them if present. Other responses:
  • 404: the maker has no quote. The body is optional.
  • 429: the maker is rate limited. DFlow skips it for 5 seconds.
  • Anything else, a timeout or a malformed body: DFlow leaves the maker out of this round.

​
Partial Fills

By quoting rfqFill, the maker accepts any input up to the request’s maxAmountIn (its amount when the request has none) at the quoted price. The output owed for an input is input × amountOut ÷ amountIn, rounded down. Maker Escrow Fills covers partial fills of an rfqOrder.