RFQ Events Streaming

Upcoming - beta access required. The RFQ events stream is part of the upcoming Combos API beta. Reach out to institutional@polymarket.us to join the beta test.

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

Subscribe to combo RFQ and quote lifecycle events using gRPC server-side streaming. Use this stream to avoid polling GetRFQs and GetQuotes while managing RFQ workflows.

Service Definition

Service: polymarket.v1.CombosAPI
RPC: StreamRFQEvents
Type: Server-side streaming
Required scope: read:orders

service CombosAPI {
    rpc StreamRFQEvents(StreamRFQEventsRequest)
        returns (stream StreamRFQEventsResponse);
}

StreamRFQEvents is gRPC-only. The REST Combos endpoints are documented in the Combos API Overview.

Request Parameters

StreamRFQEventsRequest

The request is currently empty.

from polymarket.v1 import combos_pb2

request = combos_pb2.StreamRFQEventsRequest()

Response Messages

The stream returns StreamRFQEventsResponse messages. Each response has one event value.

Event	Payload	Description
`rfq_created`	`RFQCreatedEvent`	A new RFQ was created.
`rfq_expired`	`RFQExpiredEvent`	An RFQ expired.
`rfq_action_rejected`	`RFQActionRejectedEvent`	An RFQ action was rejected.
`quote_created`	`QuoteCreatedEvent`	A quote was created.
`quote_deleted`	`QuoteDeletedEvent`	A quote was deleted.
`quote_accepted`	`QuoteAcceptedEvent`	A quote was accepted.
`quote_expired`	`QuoteExpiredEvent`	A quote expired.
`quote_passed`	`QuotePassedEvent`	A quote was passed.
`quote_done_away`	`QuoteDoneAwayEvent`	A quote was done away.
`quote_pending_risk`	`QuotePendingRiskEvent`	A quote entered pending-risk state.
`quote_pending_end_trade`	`QuotePendingEndTradeEvent`	An accepted quote entered last-look confirmation.
`quote_status_rejected`	`QuoteStatusRejectedEvent`	A quote status transition was rejected.

Event Payloads

RFQ

Field	Type	Description
`id`	string	RFQ ID.
`qtyDecimal`	string	Requested quantity, when RFQ is quantity-based.
`cashOrderQty`	string	Requested cash quantity, when RFQ is cash-based.
`side`	`Side`	Quote creator’s side. The requester executes on the opposite side.
`instrument`	`ComboInstrument`	Combo instrument details.
`rfqCreatorUserId`	string	Public RFQ user ID for the requester.
`clientRequestId`	string	Client request ID supplied at creation time.
`expirationTime`	`Timestamp`	RFQ expiration time.
`createdTime`	`Timestamp`	RFQ creation time.

Quote

Field	Type	Description
`id`	string	Quote ID.
`rfqId`	string	RFQ being quoted.
`creatorRfqUserId`	string	Public RFQ user ID for the quote creator.
`symbol`	string	Combo symbol.
`qtyDecimal`	string	Quote quantity.
`side`	`Side`	Quote side.
`price`	string	Quote price.
`status`	`QuoteStatus`	Current quote status.
`createdTime`	`Timestamp`	Quote creation time.
`expirationTime`	`Timestamp`	Quote expiration time.
`clientRequestId`	string	Client request ID supplied at creation time.

RFQActionReject

Field	Type	Description
`action`	`RFQActionRejectAction`	Action that was rejected.
`reason`	`RFQActionRejectReason`	Rejection reason.
`symbol`	string	Related symbol, when available.
`text`	string	Human-readable rejection text.
`rfqId`	string	Related RFQ ID, when available.
`quoteId`	string	Related quote ID, when available.
`clientRequestId`	string	Related client request ID, when available.

RFQActionRejectAction

Value	Description
`RFQ_ACTION_REJECT_ACTION_CREATE_RFQ`	Create RFQ was rejected.
`RFQ_ACTION_REJECT_ACTION_CREATE_QUOTE`	Create quote was rejected.
`RFQ_ACTION_REJECT_ACTION_DELETE_QUOTE`	Delete quote was rejected.
`RFQ_ACTION_REJECT_ACTION_ACCEPT_QUOTE`	Accept quote was rejected.
`RFQ_ACTION_REJECT_ACTION_PASS_QUOTE`	Pass quote was rejected.
`RFQ_ACTION_REJECT_ACTION_CONFIRM_QUOTE`	Confirm quote was rejected.

Complete Example

import grpc
from polymarket.v1 import combos_pb2, combos_pb2_grpc


class RFQEventsStreamer:
    def __init__(self, grpc_server: str = "grpc-api.preprod.polymarketexchange.com:443"):
        self.grpc_server = grpc_server

    def stream_rfq_events(self, access_token: str, participant_id: str):
        channel = grpc.secure_channel(
            self.grpc_server,
            grpc.ssl_channel_credentials()
        )
        stub = combos_pb2_grpc.CombosAPIStub(channel)
        metadata = [
            ("authorization", f"Bearer {access_token}"),
            ("x-participant-id", participant_id),
        ]
        request = combos_pb2.StreamRFQEventsRequest()

        for response in stub.StreamRFQEvents(request, metadata=metadata):
            event_type = response.WhichOneof("event")

            if event_type == "rfq_created":
                rfq = response.rfq_created.rfq
                print(f"RFQ created: {rfq.id} {rfq.side}")

            elif event_type == "quote_created":
                quote = response.quote_created.quote
                print(f"Quote created: {quote.id} for RFQ {quote.rfq_id}")

            elif event_type == "quote_accepted":
                quote = response.quote_accepted.quote
                print(f"Quote accepted: {quote.id}")

            elif event_type == "rfq_action_rejected":
                reject = response.rfq_action_rejected.reject
                print(f"RFQ action rejected: {reject.action} {reject.reason} {reject.text}")

Stream Behavior

Behavior	Description
Delivery	Server pushes events as RFQs and quotes change.
Filtering	The request is currently empty; filtering is not currently exposed.
Reconnects	Reconnect with backoff after transient `UNAVAILABLE` or network errors.
Ordering	Process events in receive order for a single stream.

Error Codes

gRPC Code	Cause
`INVALID_ARGUMENT`	Missing participant ID. Pass `x-participant-id` metadata or use a token with a `participant_id` claim.
`UNAUTHENTICATED`	Missing or invalid bearer token.
`PERMISSION_DENIED`	Token lacks `read:orders` or participant access.
`FAILED_PRECONDITION`	Participant token setup is not ready or token state is invalid.
`UNAVAILABLE`	Upstream Combos service or stream is unavailable.

Combos API

REST and unary gRPC RFQ operations

gRPC Streaming Overview

Endpoints, auth, and connection setup

Authentication

gRPC metadata and scopes

Error Handling

Reconnection and retry guidance

Overview

Streaming

Streaming Services

Reference

Service Definition

Request Parameters

StreamRFQEventsRequest

Response Messages

Event Payloads

RFQ

Quote

RFQActionReject

RFQActionRejectAction

Complete Example

Stream Behavior

Error Codes

See Also

Combos API

gRPC Streaming Overview

Authentication

Error Handling

​Service Definition

​Request Parameters

​StreamRFQEventsRequest

​Response Messages

​Event Payloads

​RFQ

​Quote

​RFQActionReject

​RFQActionRejectAction

​Complete Example

​Stream Behavior

​Error Codes

​See Also

Combos API

gRPC Streaming Overview

Authentication

Error Handling

Service Definition

Request Parameters

StreamRFQEventsRequest

Response Messages

Event Payloads

RFQ

Quote

RFQActionReject

RFQActionRejectAction

Complete Example

Stream Behavior

Error Codes

See Also