Skip to main content
POST
Buy a Polymarket combo (parlay) via the RFQ gateway

Authorizations

X-Client-Id
string
header
required

Credential client id (kairos_ck_...). Must be sent together with X-Api-Key and X-Api-Secret.

X-Api-Key
string
header
required

64-char hex API key.

X-Api-Secret
string
header
required

64-char hex API secret.

Body

application/json

Body for POST /combo/execute. NOTE: the whole /combo/* family uses camelCase field names, where the Orders endpoints are snake_case. Do not assume one convention across this API.

legPositionIds
string[]
required

The YES-outcome position id of each leg market. Minimum 2, maximum 10 legs.

Required array length: 2 - 10 elements
notionalUsd
number<double>
required

USD notional to spend on the combo (e.g. 10.0 = $10). Must be finite and > 0, and large enough to round to a non-zero six-decimal amount.

Example:

10

maxPriceCents
integer | null

Reject the quote if the blended price exceeds this, in cents per share (e.g. 60 = $0.60). Strongly recommended — without it you accept whatever the maker quotes.

Example:

60

Response

The combo settled on-chain.

Response for POST /combo/execute.

rfqId
string
required
quoteId
string
required
yesPositionId
string
required

The combo's synthetic YES outcome position id.

blendedPriceE6
string
required

Blended maker price as a six-decimal fixed-point integer string (e.g. "16393" = 0.016393). NOT a decimal — divide by 1,000,000.

Example:

"16393"

totalRequiredE6
string
required

pUSD spent, six-decimal fixed-point integer string.

status
string
required

The RFQ gateway's settlement status, passed through verbatim.

conditionId
string | null
txHash
string | null