GeminiGemini
SandboxGet API key
  • Crypto Trading
  • Prediction Markets
Changelog
Gemini Crypto Exchange LogoGemini Crypto Exchange Logo

© 2026 Gemini Space Station, Inc.

Information
Markets
    List prediction market eventsgetGet event by tickergetGet strike price for eventgetList newly listed eventsgetList recently settled eventsgetList upcoming eventsgetList event categoriesget
Terms
    Get prediction market termsgetGet prediction market terms statusgetAccept prediction market termspost
Trading
    Place orderpostCancel orderpost
Positions
    Get active orderspostGet order historypostGet positionspostGet settled positionspostGet volume metricspost
Combos
    List combo contractsgetGet combo by instrument symbolget
Rewards
    Get maker-rebate rate schedulegetList maker-rebate payoutspostGet maker-rebate lifetime summarygetGet liquidity-rewards program configgetList liquidity-rewards eventsgetGet liquidity-rewards daily summarygetGet liquidity-rewards lifetime summaryget
Schemas
Gemini Prediction Markets API
Gemini Prediction Markets API

Combos

Server

Public endpoints for discovering and inspecting combo contracts. Combos are pre-packaged multi-leg contracts; order entry uses the same place/cancel endpoints as single contracts.


List combo contracts

GET
https://api.gemini.com
/v1/prediction-markets/combos

Returns a paginated list of pre-packaged combo contracts. Each combo includes its full leg breakdown and per-leg resolution status.

List combo contracts › query Parameters

status
​string

Filter by combo contract status (e.g. Active, Settled, Voided)

contractId
​integer · int64

Filter to combos that contain a specific underlying contract ID as a leg

instrumentRegistered
​boolean

Filter by whether the combo has been registered as a tradeable instrument on the orderbook

limit
​integer · min: 1 · max: 500

Maximum number of results to return (max 500)

Default: 50
offset
​integer · min: 0

Number of results to skip for pagination

Default: 0

List combo contracts › Responses

Successful response

ListCombosResponse
​ComboResponse[]

List of combo contracts matching the query

​object
GET/v1/prediction-markets/combos
curl --request GET \ --url https://api.gemini.com/v1/prediction-markets/combos
shell
Example Responses
{ "combos": [ { "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 } } ] } ], "pagination": { "limit": 50, "offset": 0, "total": 1 } }
json
application/json

Get combo by instrument symbol

GET
https://api.gemini.com
/v1/prediction-markets/combos/{instrumentSymbol}

Returns the full specification of a single combo contract identified by its instrument symbol, including leg breakdown and per-leg resolution status.

Get combo by instrument symbol › path Parameters

instrumentSymbol
​string · required

The combo contract's instrument symbol (e.g. GEMI-CMB-0526-A7F3B2C1D4E5)

Get combo by instrument symbol › Responses

Successful response

ComboResponse
​object

Metadata for the combo contract itself (ticker, status, expiry, etc.)

​ComboLeg[]

Ordered list of legs that make up this combo

GET/v1/prediction-markets/combos/{instrumentSymbol}
curl --request GET \ --url https://api.gemini.com/v1/prediction-markets/combos/:instrumentSymbol
shell
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 } } ] }
json
application/json

PositionsRewards