Get Event
Get Event
GEThttps://api.gemini.com/v1/prediction-markets/events/{eventTicker}
Returns detailed information about a specific prediction market event.
GETv1/prediction-markets/events/BTC100K2025
curl --request GET \
--url https://api.gemini.com/v1/prediction-markets/events/BTC100K2025Path Parameters
eventTickerstring·required
The event ticker symbol (e.g., "BTC100K")Responses
Successful response
idstring
titlestring
Example: Will Bitcoin reach $100k by end of 2028?slugstring
Example: bitcoin-100k-2028descriptionstring
imageUrlstring
typestring·enum
Type of prediction marketEnum values: binarycategoricalcategorystring
Example: cryptoseriesstring
sportsMarketobject
Atomic sports-market classification shared by every contract grouped under the event. Present only for sports events. All fields except `metric` are required together.sportsMarket.sportstring·enum·required
Sport whose rules give the market's scope and metric their sport-specific meaning.Enum values: american_footballathleticsaustralian_rules_footballbaseballbasketballboxingchesscricketcyclingdartsesportsgolfhockeylacrossemixed_martial_artsmotorsportsrugbysailingsoccertennissportsMarket.typestring·enum·required
Conventional sports-market family. `subject`, `scope`, and `metric` provide detail within the family. This classification is independent of the event's structural `type` (`binary` or `categorical`).Enum values: moneylinespreadtotalpropcorrect_scoreto_advancefuturesothersportsMarket.subjectstring·enum·required
What the market is about. `participant` covers non-player entrants such as drivers and horses.Enum values: contestteamplayerparticipantothersportsMarket.scopeobject·required
Settlement scope. `ordinal` identifies one unit; `start` and `end` identify an inclusive range of units.sportsMarket.scope.typestring·enum·required
Unit covered by the market. `full_contest` follows the market's official final-result rules; `regulation` covers scheduled regulation play only. Ordinal and range qualifiers are represented separately on `SportsMarketScope`.Enum values: full_contestregulationhalfquarterperiodinningteam_inningsoverpowerplaysetgameroundholematch_daysessionsuper_overracesprintqualifyingpracticestagelapseriesseasontournamentcompetitionothersportsMarket.scope.ordinalinteger (int32)
Optional ordinal within the scope type, such as half `1` or quarter `4`.sportsMarket.scope.startinteger (int32)
Optional inclusive start of a scope range, such as inning `1`.sportsMarket.scope.endinteger (int32)
Optional inclusive end of a scope range, such as inning `5`.sportsMarket.metricstring·enum
Statistic measured by the market. Interpret shared metric names using `sportsMarket.sport`.Enum values: acesassistsballs_facedbirdiesblocked_shotsblocksbogeysboundariesbreak_points_woncardscatchesclean_sheetscompleted_passescontrol_timecornersdefensive_reboundsdouble_doubledouble_faultsdoubleseaglesearned_runserrorsfaceoff_winsfairways_hitfantasy_pointsfastest_lapfield_goals_madefinishing_positionfoulsfoursfree_throws_madefumblesgamesgoalsgoals_allowedgreens_in_regulationgrid_positionhitshits_allowedhits_runs_rbisholes_in_onehome_runsinnings_pitchedinterceptions_thrownkicking_pointsknockdownslaps_completedlaps_ledlap_timelongest_pass_completionlongest_receptionlongest_rushmaiden_oversoffensive_reboundsoffsidesparspassespass_attemptspass_completionspassing_touchdownspassing_yardspenalty_minutespitching_outs_recordedpit_stopspointspoints_assistspoints_reboundspoints_rebounds_assistspositions_gainedpower_play_pointsputtsqualifying_positionreboundsrebounds_assistsreceiving_touchdownsreceiving_yardsreceptionsred_cardsretirementsroundsrunsruns_batted_inruns_concededrush_attemptsrushing_touchdownsrushing_yardssackssafety_carssavessetsshotsshots_on_goalshots_on_targetshutoutssignificant_strikessinglessixesstealsstolen_basesstrokesstrikeoutssubmission_attemptstacklestakedownsthree_pointers_madetiebreaks_wontotal_basestotal_points_wontotal_strikestouchdownstriplestriple_doubleturnoverswalkswicketswinsyellow_cardsothertickerstring
The event ticker (e.g., "BTC100K2028")Example: BTC100K2028statusstring·enum
Status of a prediction marketEnum values: approvedactiveclosedunder_reviewsettledinvalidresolvedAtstring (date-time)
createdAtstring (date-time)
contractsarray
Tradeable contracts within this eventcontracts[].idstring
contracts[].labelstring
Human-readable label (e.g., "Yes", "No")contracts[].abbreviatedNamestring
Short form label (e.g., ">$90")contracts[].descriptionobject
Rich text descriptioncontracts[].pricesobject
Current bid/ask pricing for the contractcontracts[].totalSharesstring
contracts[].colorstring
contracts[].statusstring·enum
Status of a prediction marketEnum values: approvedactiveclosedunder_reviewsettledinvalidcontracts[].imageUrlstring
contracts[].priceHistoryarray
contracts[].createdAtstring (date-time)
contracts[].expiryDatestring (date-time)
contracts[].resolutionSidestring·enum
The outcome being traded (Yes or No)Enum values: yesnocontracts[].resolvedAtstring (date-time)
contracts[].termsAndConditionsUrlstring
contracts[].tickerstring
contracts[].instrumentSymbolstring
contracts[].quantityIncrementstring
Contract quantity grid from instrument refdata (for example, "0.01").contracts[].quantityMinimumstring
Minimum contract quantity from instrument refdata (for example, "1.00").contracts[].priceIncrementstring
Contract price grid from instrument refdata (for example, "0.0001").contracts[].quoteAssetPrecisioninteger
Decimal places supported by the instrument's quote asset.contracts[].priceMinimumstring
Minimum contract price and anchor for the instrument price grid (for example, "0.0001").contracts[].effectiveDatestring (date-time)
contracts[].marketStatestring·enum
Trading state of the contractEnum values: openclosedcontracts[].sortOrderinteger
Display order within the eventcontracts[].strikeobject
Strike price or contract threshold information for Up/Down crypto contracts and sports prediction market contracts.contracts[].strike.valuestring
The strike price value. Null for "reference" type strikes where the value is determined at availableAt time. For sports contracts, this represents the derived numeric strike value (e.g. spread margin, total line, or position/rank threshold).Example: 87500.00contracts[].strike.typestring·enum
Strike or condition inequality type for contract threshold evaluation. - `reference`: Crypto Up/Down reference strike price captured at `availableAt` time. - `above`: Higher/Lower contract threshold. - `spread`: Point, run, or goal handicap spread line. - `over`: Total or prop threshold evaluated as strict greater than (`>`). - `over_or_equal`: Total or prop threshold evaluated as greater than or equal to (`>=`). - `under`: Total or prop threshold evaluated as strict less than (`<`). - `under_or_equal`: Position, rank, or total threshold evaluated as less than or equal to (`<=`).Enum values: referenceabovespreadoverover_or_equalunderunder_or_equalExample: spreadcontracts[].strike.availableAtstring (date-time)
When the strike price becomes availableExample: 2026-03-27T19:45:00.000Zcontracts[].sourcestring
Deprecated: use the event-level `sourceDetails` (`agency` + `index`) instead. Data source identifier for price observation (e.g., "GRR-KAIKO_BTCUSD_60S"). Present for crypto Up/Down contracts.Example: GRR-KAIKO_BTCUSD_60Scontracts[].settlementValuestring
The observed settlement price. Only present after the contract is settled.Example: 87654.32contractOrderbooksobject
volumestring
Total trading volume in USDExample: 125000.00liquiditystring
Total liquidity in USDExample: 50000.00tagsarray
effectiveDatestring (date-time)
expiryDatestring (date-time)
subcategoryobject
Nested category information for the eventsourcestring
Deprecated: use `sourceDetails` (`agency` + `index`) instead. Data source identifier for price observation. Aggregated from contracts for crypto Up/Down events.Example: GRR-KAIKO_BTCUSD_60SsourceDetailsobject
Structured data source information for price observation. Replaces the deprecated flat `source` string on the event and contract. Present for crypto Up/Down events. Both fields are omitted when not available.settlementobject
Settlement information for resolved eventssettlement.valuestring
The observed settlement value (e.g., the price at expiry for crypto contracts)Example: 87654.32Last modified on