RFQ API Overview

Beta access required. The RFQ API is not generally available yet. Reach out to institutional@polymarket.us to join the beta.

Market makers should read the Combos guide before integrating. It explains quote construction, visibility, last look, and recovery.

The public polymarket.v1.RFQAPI gRPC service creates, reads, and manages combo RFQs and quotes. An RFQ references the exact symbol of a combo instrument. The service also exposes the gRPC-only RFQ event stream. Every REST endpoint below has an equivalent unary gRPC RPC. REST JSON uses lower camel case; protobuf fields use snake case.

Endpoints

Method	Endpoint	Scope	Description
`GET`	`/v1/rfqs/user-id`	`read:orders`	Get your pseudonymous RFQ user ID
`GET`	`/v1/rfqs`	`read:orders`	Query RFQs
`POST`	`/v1/rfqs`	`write:orders`	Create an RFQ
`DELETE`	`/v1/rfqs/{rfqId}`	`write:orders`	Close an open RFQ
`GET`	`/v1/rfqs/quotes`	`read:orders`	Query visible quotes
`POST`	`/v1/rfqs/quotes`	`write:orders`	Create or replace your quote for an RFQ
`DELETE`	`/v1/rfqs/{rfqId}/quotes/{quoteId}`	`write:orders`	Delete your quote
`PUT`	`/v1/rfqs/{rfqId}/quotes/{quoteId}/accept`	`write:orders`	Accept one side of a quote
`PUT`	`/v1/rfqs/{rfqId}/quotes/{quoteId}/confirm`	`write:orders`	Confirm an accepted quote during last look

All calls require bearer-token authentication and an acting participant, supplied through x-participant-id or the token’s participant_id claim.

RFQ Lifecycle

Create an RFQ

POST /v1/rfqs

{
  "cashOrderQty": "10.0000",
  "symbol": "caoc-...",
  "restRemainder": false,
  "account": "firm/account"
}

Field	Required	Description
`qtyDecimal`	One sizing field	Exact contract quantity. Mutually exclusive with `cashOrderQty`.
`cashOrderQty`	One sizing field	Positive cash notional with at most four decimal places. Mutually exclusive with `qtyDecimal`.
`symbol`	Yes	Existing open and tradable combo symbol.
`restRemainder`	Yes	Whether an unfilled requester remainder may rest after paired order submission.
`account`	Yes	Requester’s fully qualified trading account.

The response contains the new rfqId. A created RFQ starts in RFQ_STATUS_OPEN.

Query RFQs

GET /v1/rfqs?limit=10&status=RFQ_STATUS_OPEN

Parameter	Description
`limit`	Results per page. Default 100; valid range 1–100.
`cursor`	Opaque cursor returned by the preceding page.
`rfqId`	Exact RFQ ID. Do not combine an exact-ID read with `cursor`.
`symbol`	Exact combo symbol.
`status`	`RFQ_STATUS_OPEN` or `RFQ_STATUS_CLOSED`.
`userFilter`	`USER_FILTER_SELF` returns RFQs created by the caller.

The response has rfqs and an opaque cursor. An exact RFQ ID that is absent or not visible returns an empty rfqs array.

Close an RFQ

DELETE /v1/rfqs/{rfqId} closes an open RFQ. Only its requester can close it. The response is {}.

Quotes

A quote can offer both requester sides:

buyPrice is the price for a requester buy; the maker sells.
sellPrice is the price for a requester sell; the maker buys.

Set an unavailable side to "0". At least one side must be positive. Nonzero prices must be within the instrument’s price limits and land on its tick size.

Create or Replace a Quote

POST /v1/rfqs/quotes

{
  "rfqId": "rfq_...",
  "buyPrice": "0.615",
  "sellPrice": "0.585",
  "restRemainder": false,
  "postOnly": true,
  "account": "firm/account"
}

Field	Required	Description
`rfqId`	Yes	Open RFQ to quote.
`buyPrice`	Yes	Requester-buy price, or `"0"` if unavailable.
`sellPrice`	Yes	Requester-sell price, or `"0"` if unavailable.
`restRemainder`	Yes	Whether the maker order may rest after paired order submission.
`postOnly`	No	If true, submit the maker order as participate-don’t-initiate. Defaults to false.
`account`	Yes	Maker’s fully qualified trading account.

The service derives buyQtyDecimal and sellQtyDecimal from the RFQ:

A quantity RFQ uses its qtyDecimal for every offered side.
A cash RFQ derives each side independently from cashOrderQty / price, rounded down to the instrument’s fractional quantity scale.

Each maker has one deterministic quote ID per RFQ. Calling CreateQuote again replaces that maker’s quote in place, resets it to QUOTE_STATUS_ACTIVE, and returns the same quoteId.

Query Quotes

GET /v1/rfqs/quotes?rfqId=rfq_...

Parameter	Description
`limit`	Results per page. Default 100; valid range 1–100.
`cursor`	Opaque cursor returned by the preceding page.
`quoteId`	Exact quote ID. Requires `rfqId`; do not combine with `cursor`.
`rfqId`	Exact RFQ ID. The requester sees all quotes; another participant sees only its quote.
`status`	One current `QuoteStatus` value.
`userFilter`	`USER_FILTER_SELF` returns quotes created by the caller.
`rfqUserFilter`	`USER_FILTER_SELF` returns quotes on RFQs created by the caller.

Without rfqId, provide exactly one of userFilter=USER_FILTER_SELF or rfqUserFilter=USER_FILTER_SELF. The response has quotes and an opaque cursor.

Cursors are query-, participant-, and path-bound. Treat them as opaque and reuse them only with the same filters and authenticated participant.

Accept a Quote

PUT /v1/rfqs/{rfqId}/quotes/{quoteId}/accept

{
  "acceptedSide": "SIDE_BUY"
}

Only the requester can accept an active quote. SIDE_BUY selects buyPrice; SIDE_SELL selects sellPrice. The selected price must be positive. Acceptance closes the RFQ, changes the quote to QUOTE_STATUS_ACCEPTED, and starts last look.

Delete a Quote

DELETE /v1/rfqs/{rfqId}/quotes/{quoteId} deletes the caller’s active quote while the RFQ is open. The selected maker can also delete its accepted quote before the confirmation deadline to decline during last look. The response is {}.

Confirm a Quote

PUT /v1/rfqs/{rfqId}/quotes/{quoteId}/confirm The selected maker must confirm before confirmationDeadline. Confirmation changes the quote to QUOTE_STATUS_CONFIRMED and schedules paired order submission. The response is {}.

Statuses

Type	Status	Meaning
RFQ	`RFQ_STATUS_OPEN`	Can receive and accept quotes.
RFQ	`RFQ_STATUS_CLOSED`	Closed by the requester or by quote acceptance.
Quote	`QUOTE_STATUS_ACTIVE`	Can be accepted while its RFQ is open.
Quote	`QUOTE_STATUS_ACCEPTED`	Selected; maker last look is active.
Quote	`QUOTE_STATUS_CONFIRMED`	Maker confirmed; paired order submission is scheduled or needs reconciliation.
Quote	`QUOTE_STATUS_DELETED`	Maker deleted or declined the quote.
Quote	`QUOTE_STATUS_EXECUTED`	Both exchange orders were accepted for submission. Reconcile fills through Drop Copy.

Events and Recovery

RFQAPI.StreamRFQEvents is a live, best-effort gRPC stream. Public RFQ events are visible to participants; quote events are private to the requester and relevant maker. The stream has no replay, gap-free handoff, ordering, or deduplication guarantee. Open the stream for low-latency changes. On startup or reconnect, reconcile durable state with GetRFQs and GetQuotes. See RFQ Events Stream.

Combos API

Create and read combo instruments

Combos Guide

Maker workflow and quote rules

RFQ Events Stream

Current event payloads and recovery behavior

Authentication

OAuth metadata and required scopes

Overview

Health

Trading

Combos

RFQs

Report

Positions

Funding

Order Book

Reference Data

Accounts

Payments

Incentives

Endpoints

RFQ Lifecycle

Create an RFQ

Query RFQs

Close an RFQ

Quotes

Create or Replace a Quote

Query Quotes

Accept a Quote

Delete a Quote

Confirm a Quote

Statuses

Events and Recovery

See Also

Combos API

Combos Guide

RFQ Events Stream

Authentication

​Endpoints

​RFQ Lifecycle

​Create an RFQ

​Query RFQs

​Close an RFQ

​Quotes

​Create or Replace a Quote

​Query Quotes

​Accept a Quote

​Delete a Quote

​Confirm a Quote

​Statuses

​Events and Recovery

​See Also

Combos API

Combos Guide

RFQ Events Stream

Authentication

Endpoints

RFQ Lifecycle

Create an RFQ

Query RFQs

Close an RFQ

Quotes

Create or Replace a Quote

Query Quotes

Accept a Quote

Delete a Quote

Confirm a Quote

Statuses

Events and Recovery

See Also