List Upcoming Events
List Upcoming Events
GEThttps://api.gemini.com/v1/prediction-markets/events/upcoming
Returns a list of approved prediction market events that are not yet active (pre-launch), sorted by start time (soonest first).
GETv1/prediction-markets/events/upcoming
curl --request GET \
--url https://api.gemini.com/v1/prediction-markets/events/upcomingQuery Parameters
categoryarray
Filter by category (can specify multiple). If omitted, returns events from all categories.limitinteger
Maximum number of results to return (max 500)Default: 50offsetinteger
Number of results to skip for paginationDefault: 0Responses
Successful response
dataarray
data[].idstring
data[].titlestring
Example: Will Bitcoin reach $100k by end of 2028?data[].slugstring
Example: bitcoin-100k-2028data[].descriptionstring
data[].imageUrlstring
data[].typestring·enum
Type of prediction marketEnum values: binarycategoricaldata[].categorystring
Example: cryptodata[].seriesstring
data[].tickerstring
The event ticker (e.g., "BTC100K2028")Example: BTC100K2028data[].statusstring·enum
Status of a prediction marketEnum values: approvedactiveclosedunder_reviewsettledinvaliddata[].resolvedAtstring (date-time)
data[].createdAtstring (date-time)
data[].contractsarray
Tradeable contracts within this eventdata[].contracts[].idstring
data[].contracts[].labelstring
Human-readable label (e.g., "Yes", "No")data[].contracts[].abbreviatedNamestring
Short form label (e.g., ">$90")data[].contracts[].descriptionobject
Rich text descriptiondata[].contracts[].pricesobject
Current bid/ask pricing for the contractdata[].contracts[].totalSharesstring
data[].contracts[].colorstring
data[].contracts[].statusstring·enum
Status of a prediction marketEnum values: approvedactiveclosedunder_reviewsettledinvaliddata[].contracts[].imageUrlstring
data[].contracts[].priceHistoryarray
data[].contracts[].createdAtstring (date-time)
data[].contracts[].expiryDatestring (date-time)
data[].contracts[].resolutionSidestring·enum
The outcome being traded (Yes or No)Enum values: yesnodata[].contracts[].resolvedAtstring (date-time)
data[].contracts[].termsAndConditionsUrlstring
data[].contracts[].tickerstring
data[].contracts[].instrumentSymbolstring
data[].contracts[].effectiveDatestring (date-time)
data[].contracts[].marketStatestring·enum
Trading state of the contractEnum values: opencloseddata[].contracts[].sortOrderinteger
Display order within the eventdata[].contracts[].strikeobject
Strike price information for Up/Down crypto contractsdata[].contracts[].strike.valuestring
The strike price value. Null for "reference" type strikes where the value is determined at availableAt time.Example: 87500.00data[].contracts[].strike.typestring·enum
Strike type - "reference" for Up/Down contracts, "above" for Higher/Lower contractsEnum values: referenceaboveExample: referencedata[].contracts[].strike.availableAtstring (date-time)
When the strike price becomes availableExample: 2026-03-27T19:45:00.000Zdata[].contracts[].sourcestring
Data source identifier for price observation (e.g., "GRR-KAIKO_BTCUSD_60S"). Present for crypto Up/Down contracts.Example: GRR-KAIKO_BTCUSD_60Sdata[].contracts[].settlementValuestring
The observed settlement price. Only present after the contract is settled.Example: 87654.32data[].contractOrderbooksobject
data[].volumestring
Total trading volume in USDExample: 125000.00data[].liquiditystring
Total liquidity in USDExample: 50000.00data[].tagsarray
data[].effectiveDatestring (date-time)
data[].expiryDatestring (date-time)
data[].subcategoryobject
Nested category information for the eventdata[].sourcestring
Data source identifier for price observation. Aggregated from contracts for crypto Up/Down events.Example: GRR-KAIKO_BTCUSD_60Sdata[].settlementobject
Settlement information for resolved eventsdata[].settlement.valuestring
The observed settlement value (e.g., the price at expiry for crypto contracts)Example: 87654.32paginationobject
pagination.limitinteger
Example: 50pagination.offsetinteger
Example: 0pagination.totalinteger
Example: 100Example Responses
{
"data": [
{
"id": "4200",
"title": "Lakers vs Celtics",
"slug": "lakers-vs-celtics-march-10",
"description": "NBA game prediction market",
"imageUrl": "https://images.ctfassets.net/example.png",
"type": "binary",
"category": "Sports",
"series": null,
"ticker": "NBA260310LAL-BOS",
"status": "approved",
"resolvedAt": null,
"createdAt": "2026-03-04T12:00:00.000Z",
"effectiveDate": "2026-03-10T19:30:00.000Z",
"expiryDate": "2026-03-11T02:00:00.000Z",
"liquidity": null,
"tags": [
"NBA",
"Basketball"
],
"subcategory": {
"id": 10,
"slug": "sports_nba",
"name": "NBA",
"path": [
"Sports",
"NBA"
]
},
"contracts": [
{
"id": "4200-1",
"label": "Lakers Win",
"abbreviatedName": "LAL",
"description": null,
"prices": {
"buy": {},
"sell": {},
"bestBid": null,
"bestAsk": null,
"lastTradePrice": null
},
"totalShares": null,
"color": "#552583",
"status": "approved",
"imageUrl": null,
"priceHistory": null,
"createdAt": "2026-03-04T12:00:00.000Z",
"expiryDate": "2026-03-11T02:00:00.000Z",
"resolutionSide": null,
"resolvedAt": null,
"termsAndConditionsUrl": "https://example.com/terms",
"ticker": "LAL",
"instrumentSymbol": "GEMI-NBA260310LAL-BOS-LAL",
"effectiveDate": "2026-03-10T19:30:00.000Z",
"marketState": "closed",
"sortOrder": 1
}
]
}
],
"pagination": {
"limit": 50,
"offset": 0,
"total": 1
}
}Last modified on