Beta access required. The Retail RFQ API is available only to explicitly enabled Retail API users.
https://api.polymarket.us.
The Retail API derives the participant and account from the API key; clients do not send an account.
Endpoints
On the Retail API, Combo and RFQ creation share an additional edge rate limit of 10 requests per 10 seconds, enforced per API key and per IP. RFQ-specific business limits and participant restrictions are enforced separately by the RFQ service.
For
GET /v1/rfqs/quotes, provide an rfqId or exactly one of userFilter=USER_FILTER_SELF and rfqUserFilter=USER_FILTER_SELF. Cursors are opaque and must be reused with the same filters and authenticated participant.
Real-time stream
RFQ and quote lifecycle events are available on the Private WebSocket. Subscribe withSUBSCRIPTION_TYPE_RFQ to receive all seven RFQ and quote event types, from rfqCreated through quoteExecuted.
The stream is live and best effort, with no replay or separate subscription acknowledgment. On startup or reconnect, reconcile state with GET /v1/rfqs and GET /v1/rfqs/quotes.
Execution
QUOTE_STATUS_EXECUTED and quoteExecuted mean the paired exchange orders were submitted and their order IDs were recorded. They do not mean the orders filled.
Use SUBSCRIPTION_TYPE_RFQ for the RFQ lifecycle and SUBSCRIPTION_TYPE_ORDER for fills, rejections, cancellations, and expirations. Correlate the orders using creatorOrderId for the maker and rfqCreatorOrderId for the requester; both IDs are also returned by GET /v1/rfqs/quotes.
RFQ orders enter the normal combo order book and may trade with other resting liquidity. Combo instruments can also be traded directly through the Orders API; using an RFQ is optional. If either restRemainder setting is true, unfilled quantity on that side may remain on the book.
See Also
Combos API
Create and read combo instruments
Private WebSocket
Receive all seven RFQ event variants
Authentication
Sign Retail API requests