Public endpoints for discovering and inspecting combo contracts, plus an authenticated endpoint to create or retrieve a canonical combo. Combos are multi-leg contracts; order entry uses the same place/cancel endpoints as single contracts.
List combo contracts
Returns a paginated list of combo contracts. Each combo includes its full leg breakdown and per-leg resolution status. When status is omitted, the endpoint returns only Active combos. This Combo Prediction Markets endpoint is not currently enabled in production.
query Parameters
statusFilter by combo contract status (for example, Active, Settled, or Voided). Defaults to Active when omitted.
contractIdFilter to combos that contain a specific underlying contract ID as a leg
instrumentRegisteredFilter by whether the combo has been registered with an instrument symbol
limitMaximum number of results to return (max 500)
offsetNumber of results to skip for pagination
List combo contracts › Responses
Successful response
List of combo contracts matching the query
Create or retrieve a canonical combo
Creates a combo from two to six underlying contract legs for the authenticated account. The service canonicalizes the complete leg set, so submitting the same legs again returns the existing combo regardless of leg order. The account is derived from the authenticated API key; do not include an account ID in the request. This Combo Prediction Markets endpoint is not currently enabled in production.
Requires signed private REST authentication, the PredictionsNewOrder permission, and an unrestricted trading account. A new canonical combo returns 201 Created with alreadyExisted: false; an existing canonical combo returns 200 OK with alreadyExisted: true.
Create or retrieve a canonical combo › Request Body
Two to six distinct underlying contract legs. The service canonicalizes their complete set, so leg order does not create a distinct combo.
Create or retrieve a canonical combo › Responses
The canonical combo already exists.
alreadyExistedfalse when this request created the canonical combo; true when the canonical combo already existed.
Get combo by instrument symbol
Returns the full specification of a single combo contract identified by its instrument symbol, including leg breakdown and per-leg resolution status. This Combo Prediction Markets endpoint is not currently enabled in production.
path Parameters
instrumentSymbolThe combo contract's instrument symbol (e.g. GEMI-CMB-0526-A7F3B2C1D4E5)
Get combo by instrument symbol › Responses
Successful response
Metadata for the combo contract itself (ticker, status, expiry, etc.)
Ordered list of legs that make up this combo