Combos API Overview

Upcoming - beta access required. The Combos API is not generally available yet. Reach out to institutional@polymarket.us to join the beta test.

Read the Combos guide before integrating. It explains the RFQ Engine workflow, quote rules, and timing requirements.

The Combos API lets participants request and quote multi-leg combo trades. A requester creates an RFQ with two or more legs, makers respond with quotes, the requester accepts one quote, and the quote creator confirms it during last look. For real-time RFQ and quote changes, use the RFQ Events Stream.

Endpoints

Method	Endpoint	Required Scope	Description
`GET`	`/v1/combos/rfq/user-id`	`read:orders`	Get your public RFQ user ID
`GET`	`/v1/combos/rfqs`	`read:orders`	Query RFQs
`POST`	`/v1/combos/rfqs`	`write:orders`	Create an RFQ
`GET`	`/v1/combos/quotes`	`read:orders`	Query quotes
`POST`	`/v1/combos/quotes`	`write:orders`	Create a quote
`DELETE`	`/v1/combos/rfqs/{rfqId}/quotes/{quoteId}`	`write:orders`	Delete a quote
`PUT`	`/v1/combos/rfqs/{rfqId}/quotes/{quoteId}/accept`	`write:orders`	Accept a quote
`PUT`	`/v1/combos/rfqs/{rfqId}/quotes/{quoteId}/confirm`	`write:orders`	Confirm an accepted quote during last look

All Combos API calls require normal bearer-token authentication. Calls must also identify the acting participant either through the x-participant-id header or through a participant_id claim in the bearer token.

RFQ Flow

Call GetRFQUserID to learn the public RFQ user ID for the authenticated participant.
Call CreateRFQ with the combo legs, requested side, quantity or cash order quantity, and expiration time.
Makers call GetRFQs and CreateQuote to respond.
Requesters monitor GetQuotes or subscribe to StreamRFQEvents.
The requester calls AcceptQuote to select one quote.
The quote creator calls ConfirmQuote during last look.
Watch GetQuotes or StreamRFQEvents for the final quote status.

Create RFQ

POST /v1/combos/rfqs

Request Body

Field	Type	Required	Description
`qtyDecimal`	string	Conditional	Share quantity for the RFQ. Provide this or `cashOrderQty`.
`cashOrderQty`	string	Conditional	Cash notional for the RFQ. Provide this or `qtyDecimal`.
`legs`	`ComboLeg[]`	Yes	Combo legs. Each leg has `symbol` and `side`.
`side`	`Side`	Yes	Side the quote creator must use. The requester executes on the opposite side.
`clientRequestId`	string	No	Client idempotency / correlation ID.
`expirationTime`	RFC3339	Yes	Time when the RFQ expires.

Example

{
  "qtyDecimal": "100",
  "side": "SIDE_BUY",
  "clientRequestId": "rfq-20260613-001",
  "expirationTime": "2026-06-13T18:00:00Z",
  "legs": [
    {
      "symbol": "aec-mlb-nyy-bos-2026-06-13-nyy",
      "side": "SIDE_BUY"
    },
    {
      "symbol": "aec-mlb-nyy-bos-2026-06-13-bos",
      "side": "SIDE_SELL"
    }
  ]
}

Response

{
  "clientRequestId": "rfq-20260613-001"
}

Query RFQs

GET /v1/combos/rfqs?symbol=combo-aec-mlb-nyy-bos-2026-06-13&status=QUOTE_STATUS_PENDING&pageSize=100

Query Parameters

Parameter	Type	Description
`pageSize`	integer	Number of RFQs to return. Max 100.
`pageToken`	string	Pagination token from `nextPageToken`.
`rfqId`	string	Filter by RFQ ID.
`rfqCreatorUserId`	string	Filter by requester RFQ user ID.
`symbol`	string	Filter by combo symbol.
`clientRequestId`	string	Filter by client request ID.
`status`	`QuoteStatus`	Filter by RFQ status.

Create Quote

POST /v1/combos/quotes

Request Body

Field	Type	Required	Description
`rfqId`	string	Yes	RFQ being quoted.
`side`	`Side`	Yes	Quote creator’s side. Must equal the RFQ side.
`price`	string	Yes	Quote price as a decimal string.
`symbol`	string	Yes	Combo symbol.
`qtyDecimal`	string	Yes	Quote quantity as a decimal string.
`clientRequestId`	string	No	Client idempotency / correlation ID.
`expirationTime`	RFC3339	Yes	Quote expiration time.

Query Quotes

GET /v1/combos/quotes?rfqId=rfq_123&status=QUOTE_STATUS_PENDING

Query Parameters

Parameter	Type	Description
`pageSize`	integer	Number of quotes to return. Max 100.
`pageToken`	string	Pagination token from `nextPageToken`.
`quoteId`	string	Filter by quote ID.
`rfqId`	string	Filter by RFQ ID.
`creatorRfqUserId`	string	Filter by quote creator RFQ user ID.
`symbol`	string	Filter by combo symbol.
`status`	`QuoteStatus`	Filter by quote status.
`clientRequestId`	string	Filter by client request ID.

Accept Quote

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

Accepting a quote selects it for last-look confirmation. The body repeats the economic terms being accepted.

Field	Type	Required	Description
`side`	`Side`	Yes	Side being accepted.
`price`	string	Yes	Accepted price.
`symbol`	string	Yes	Combo symbol.
`qtyDecimal`	string	Yes	Accepted quantity.

Confirm Quote

PUT /v1/combos/rfqs/{rfqId}/quotes/{quoteId}/confirm

Confirming a quote completes the last-look step for an accepted quote. The request has no body and returns an empty JSON object.

{}

Quote Statuses

Status	Description
`QUOTE_STATUS_PENDING`	Quote is active and can be accepted.
`QUOTE_STATUS_ACCEPTED`	Quote was accepted.
`QUOTE_STATUS_DELETED`	Quote was deleted by its creator.
`QUOTE_STATUS_EXPIRED`	Quote expired.
`QUOTE_STATUS_PASSED`	Quote was passed.
`QUOTE_STATUS_DONE_AWAY`	Quote was done away.
`QUOTE_STATUS_PENDING_RISK`	Quote is waiting on risk checks.
`QUOTE_STATUS_PENDING_END_TRADE`	Accepted quote is waiting for last-look confirmation.
`QUOTE_STATUS_REJECTED`	Quote was rejected.

Rate Limits

Endpoint	Rate	Burst
`GET /v1/combos/rfq/user-id`	Firm-wide REST cap	-
`GET /v1/combos/rfqs`	1 req/sec	1
`GET /v1/combos/quotes`	1 req/sec	1
`POST /v1/combos/rfqs`	10 req/sec	10
`POST /v1/combos/quotes`	100 req/sec	100
`DELETE /v1/combos/rfqs/{rfqId}/quotes/{quoteId}`	100 req/sec	100
`PUT /v1/combos/rfqs/{rfqId}/quotes/{quoteId}/accept`	100 req/sec	100
`PUT /v1/combos/rfqs/{rfqId}/quotes/{quoteId}/confirm`	100 req/sec	100

Exceeding these limits returns ResourceExhausted (429 Too Many Requests).

Error Codes

Error	Cause
`InvalidArgument`	Missing participant ID, invalid RFQ, quote, symbol, side, price, quantity, or pagination input.
`Unauthenticated`	Missing or invalid bearer token.
`PermissionDenied`	Token lacks the required scope or participant access.
`FailedPrecondition`	Participant token setup is not ready or token state is invalid.
`Unavailable`	Upstream Combos service is unavailable.
`ResourceExhausted`	Per-firm rate limit exceeded.

RFQ Events Stream

Real-time RFQ and quote events

Trading API

Order entry and lifecycle APIs

Authentication

Required scopes and OAuth flow

Rate Limits

Endpoint-level request limits

Overview

Health

Trading

Combos

Report

Positions

Funding

Order Book

Reference Data

Accounts

Payments

Incentives

Endpoints

RFQ Flow

Create RFQ

Request Body

Example

Response

Query RFQs

Query Parameters

Create Quote

Request Body

Query Quotes

Query Parameters

Accept Quote

Confirm Quote

Quote Statuses

Rate Limits

Error Codes

See Also

RFQ Events Stream

Trading API

Authentication

Rate Limits

​Endpoints

​RFQ Flow

​Create RFQ

​Request Body

​Example

​Response

​Query RFQs

​Query Parameters

​Create Quote

​Request Body

​Query Quotes

​Query Parameters

​Accept Quote

​Confirm Quote

​Quote Statuses

​Rate Limits

​Error Codes

​See Also

RFQ Events Stream

Trading API

Authentication

Rate Limits

Endpoints

RFQ Flow

Create RFQ

Request Body

Example

Response

Query RFQs

Query Parameters

Create Quote

Request Body

Query Quotes

Query Parameters

Accept Quote

Confirm Quote

Quote Statuses

Rate Limits

Error Codes

See Also