> ## Documentation Index
> Fetch the complete documentation index at: https://pond.dflow.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Maker Integration

> How a maker connects to the tokenized equities RFQ

A maker quotes tokenized equity trades and settles the quotes DFlow selects. DFlow calls the maker's HTTP endpoints. The maker never calls DFlow to quote or fill.

## Maker Endpoints

The maker serves these endpoints under one base URL. Every request carries `X-API-KEY` (the key the maker gave DFlow), `x-request-start` (unix milliseconds) and `x-request-timeout` (the budget in milliseconds).

| Endpoint | Purpose | Budget |
| - | - | - |
| `GET /tokens` | Mints the maker quotes. | 2 seconds |
| `GET /health` | Whether the maker can honor quotes. | 2 seconds |
| `POST /quote` | A firm or indicative quote. | 250 ms |
| `POST /selected` | Notice that DFlow selected a quote. | 0.9 seconds, retry included |
| `POST /swap` | Last look on a direct fill. | 8 seconds |

[Maker Quotes](https://pond.dflow.net/equities/makers/quotes.md) covers `/tokens`, `/health` and `/quote`. [Maker Direct Fills](https://pond.dflow.net/equities/makers/direct-fills.md) and [Maker Escrow Fills](https://pond.dflow.net/equities/makers/escrow-fills.md) cover `/selected` and settlement for each fill type.

## Fill Types

The maker sets `actionType` in each quote response. The quote request lists the types DFlow can build in `acceptedActionTypes`.

| `actionType` | Fill | Settlement |
| - | - | - |
| `rfqFill` | Direct fill | One transaction with two orchestrator instructions: one opens an order that escrows the user's input and one fills it. The user signs, then the maker co-signs the fill at last look and submits. |
| `rfqOrder` | Escrow fill | The user's transaction escrows their input onchain. The maker fills the order in a later transaction. |

A maker that holds the equity quotes `rfqFill`. A maker that has to acquire the equity quotes `rfqOrder`. A sell of an equity is always a direct fill, so DFlow accepts only `rfqFill` for it and the maker needs the settlement mint (USDC) in inventory.

## Registration

The maker gives DFlow:

* **Base URL:** where the endpoints above are served.
* **Wallet:** the public key that signs for the maker. The `maker` field of every quote must equal it. DFlow drops a quote that names another wallet.
* **API key:** the key DFlow sends in `X-API-KEY` on every call.

## Health and Coverage

DFlow polls `/tokens` and `/health` every 10 seconds. DFlow asks a maker for a quote only while the maker is healthy and lists both mints of the pair. A maker becomes unhealthy after three failed rounds in a row (a non-2xx status, a timeout or an unreadable `/tokens` body) and healthy again after one good round, with at least 30 seconds between changes.