Interfaces
RFQs are accessible over REST, FIX, and WebSocket. Quote notifications arrive on thecommunications WebSocket channel, not the orderbook channel.
Flow
- Requester creates an RFQ specifying a market ticker, size, and whether to rest any remainder.
- The RFQ is broadcast to all makers.
- Makers respond with quotes containing a
yes_bidandno_bid. Quotes are for the full RFQ size. Each quote is private between the requester and the individual maker — makers cannot see each other’s quotes. - Requester accepts one side of the best-priced quote.
- Maker confirms within the confirmation window. Once confirmed, neither party can withdraw.
- After the execution timeout, orders are placed on the public book.
Sizing
When creating an RFQ, the requester specifies size in exactly one of:contracts_fp— number of contracts (whole only).target_cost_dollars— dollar amount to spend. The exchange derives a contract count from the quote price, returned asyes_contracts_fp/no_contracts_fpon the quote.
Quotes
Each quote has two prices:yes_bid (price per YES contract) and no_bid (price per NO contract). These are typically different. Either can be "0" to decline that side, but not both.
Prices must land on the market’s price grid. Check price_ranges on GET /markets/{ticker} for the valid step size.
A new quote on the same RFQ replaces the maker’s previous quote.
Timing
The exchange designates certain markets as High Volatility Markets (HVM). All combo markets are HVMs. HVMs use shorter confirmation and execution windows.| Standard | HVM | |
|---|---|---|
| Confirmation window | 30 s | 1 s |
| Execution timer | 15 s | 1 s |
GET /portfolio/fills — match on creator_order_id (maker) or rfq_creator_order_id (requester).
WebSocket
Subscribe to thecommunications channel (requires auth). rfq_created and rfq_deleted go to all subscribers. quote_created, quote_accepted, and quote_executed go only to the involved requester and maker.
Combos (MVE)
Combo RFQs includemve_collection_ticker and mve_selected_legs. Use Multivariate Event Collections to discover eligible combinations.
Common errors
| Error | What’s going on |
|---|---|
invalid_parameters | Price not on a valid step, or RFQ already closed |
RFQ_CLOSED | RFQ was deleted, expired, or already executed |
INSUFFICIENT_BALANCE | Not enough funds for the trade |
409 Conflict | Open RFQ already exists on this market ticker |