Get Combo
Get Combo
GEThttps://api.gemini.com/v1/prediction-markets/combos/{instrumentSymbol}
Returns the full specification of a single combo contract by its instrument symbol, including leg breakdown and per-leg resolution status.
Production availability
This Combo Prediction Markets endpoint is not currently enabled in production.
GETv1/prediction-markets/combos/GEMI-CMB-0526-A7F3B2C1D4E5
curl --request GET \
--url https://api.gemini.com/v1/prediction-markets/combos/GEMI-CMB-0526-A7F3B2C1D4E5Path Parameters
instrumentSymbolstring·required
The combo contract's instrument symbol (e.g. GEMI-CMB-0526-A7F3B2C1D4E5)Responses
Successful response
contractobject·required
Metadata for the combo contract itself (ticker, status, expiry, etc.)contract.contractIdstring
contract.contractNamestring
contract.contractTickerstring
contract.eventTickerstring
contract.eventNamestring
contract.categorystring
contract.contractStatusstring
contract.eventTypestring
Event type ("binary" or "categorical")contract.expiryDatestring (date-time)
contract.resolvedAtstring (date-time)
contract.resolutionSidestring
Winning outcome if resolved ("yes" or "no")contract.parentEventTickerstring
Parent event ticker for sub-eventscontract.startTimestring (date-time)
Start datetime (ISO 8601)legsarray·required
Ordered list of legs that make up this combolegs[].comboIdinteger (int64)·required
Internal ID of the parent combo contractExample: 456legs[].legIndexinteger·required
Zero-based position of this leg in the comboExample: 0legs[].contractIdstring·required
Internal ID of the underlying single contract, represented as a decimal stringExample: 101legs[].requiredOutcomestring·enum·required
The outcome this leg must settle for the combo to settle YESEnum values: YesNoExample: Yeslegs[].legOutcomestring
The outcome this leg has settled to, if resolved (`"Yes"` or `"No"`). Null while the leg is still active.Example: nulllegs[].resolvedAtstring (date-time)
UTC timestamp when this leg resolved. Null while still active.Example: nulllegs[].contractobject
Full metadata for the underlying single contractlegs[].contract.contractIdstring
legs[].contract.contractNamestring
legs[].contract.contractTickerstring
legs[].contract.eventTickerstring
legs[].contract.eventNamestring
legs[].contract.categorystring
legs[].contract.contractStatusstring
legs[].contract.eventTypestring
Event type ("binary" or "categorical")legs[].contract.expiryDatestring (date-time)
legs[].contract.resolvedAtstring (date-time)
legs[].contract.resolutionSidestring
Winning outcome if resolved ("yes" or "no")legs[].contract.parentEventTickerstring
Parent event ticker for sub-eventslegs[].contract.startTimestring (date-time)
Start datetime (ISO 8601)Example Responses
{
"contract": {
"contractId": "456",
"contractName": "BTC EOY26 > $120k AND ETH EOY26 > $4k",
"contractTicker": "GEMI-CMB-0526-A7F3B2C1D4E5",
"eventTicker": "GEMI-CMB-0526-A7F3B2C1D4E5",
"eventName": "BTC EOY26 > $120k AND ETH EOY26 > $4k",
"category": "Combo",
"contractStatus": "Active",
"eventType": "binary",
"expiryDate": "2026-12-31T23:59:59Z",
"resolvedAt": null,
"resolutionSide": null,
"parentEventTicker": null,
"startTime": null
},
"legs": [
{
"comboId": 456,
"legIndex": 0,
"contractId": "101",
"requiredOutcome": "Yes",
"legOutcome": null,
"resolvedAt": null,
"contract": {
"contractId": "101",
"contractName": "BTC above $120,000 at year-end 2026",
"contractTicker": "GEMI-BTC-EOY26-HI120000",
"eventTicker": "GEMI-BTC-EOY26",
"eventName": "Bitcoin Year-End 2026",
"category": "Crypto",
"contractStatus": "Active",
"eventType": "binary",
"expiryDate": "2026-12-31T23:59:59Z",
"resolvedAt": null,
"resolutionSide": null,
"parentEventTicker": null,
"startTime": null
}
},
{
"comboId": 456,
"legIndex": 1,
"contractId": "202",
"requiredOutcome": "Yes",
"legOutcome": null,
"resolvedAt": null,
"contract": {
"contractId": "202",
"contractName": "ETH above $4,000 at year-end 2026",
"contractTicker": "GEMI-ETH-EOY26-HI4000",
"eventTicker": "GEMI-ETH-EOY26",
"eventName": "Ethereum Year-End 2026",
"category": "Crypto",
"contractStatus": "Active",
"eventType": "binary",
"expiryDate": "2026-12-31T23:59:59Z",
"resolvedAt": null,
"resolutionSide": null,
"parentEventTicker": null,
"startTime": null
}
}
]
}