REST APIs Prediction Markets EventsList Events

List Events

GEThttps://api.gemini.com/v1/prediction-markets/events

Returns a paginated list of prediction market events with optional filtering by status, category, and search text.

GETv1/prediction-markets/events

curl --request GET \
  --url https://api.gemini.com/v1/prediction-markets/events

Query Parameters

statusarray

Filter by event status (can specify multiple)

categoryarray

Filter by category (can specify multiple). If omitted, returns events from all categories.

searchstring

Search text to filter events by title

limitinteger

Maximum number of results to return (max 500)Default: 50

offsetinteger

Number of results to skip for paginationDefault: 0

Responses

Successful response

dataarray

data[].idstring

data[].titlestring

Example: Will Bitcoin reach $100k by end of 2025?

data[].slugstring

Example: bitcoin-100k-2025

data[].descriptionstring

data[].imageUrlstring

data[].typestring·enum

Type of prediction marketEnum values: binarycategorical

data[].categorystring

Example: crypto

data[].seriesstring

data[].tickerstring

The event ticker (e.g., "BTC100K2025")Example: BTC100K2025

data[].statusstring·enum

Status of a prediction marketEnum values: approvedactiveclosedunder_reviewsettledinvalid

data[].resolvedAtstring (date-time)

data[].createdAtstring (date-time)

data[].contractsarray

Tradeable contracts within this event

data[].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 description

data[].contracts[].pricesobject

Current bid/ask pricing for the contract

data[].contracts[].totalSharesstring

data[].contracts[].colorstring

data[].contracts[].statusstring·enum

Status of a prediction marketEnum values: approvedactiveclosedunder_reviewsettledinvalid

data[].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: yesno

data[].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: openclosed

data[].contracts[].sortOrderinteger

Display order within the event

data[].contracts[].strikeobject

Strike price information for Up/Down crypto contracts

data[].contracts[].strike.valuestring

The strike price value. Null for "reference" type strikes where the value is determined at availableAt time.Example: 87500.00

data[].contracts[].strike.typestring·enum

Strike type - "reference" for Up/Down contracts, "above" for Higher/Lower contractsEnum values: referenceaboveExample: reference

data[].contracts[].strike.availableAtstring (date-time)

When the strike price becomes availableExample: 2026-03-27T19:45:00.000Z

data[].contracts[].sourcestring

Data source identifier for price observation (e.g., "GRR-KAIKO_BTCUSD_60S"). Present for crypto Up/Down contracts.Example: GRR-KAIKO_BTCUSD_60S

data[].contracts[].settlementValuestring

The observed settlement price. Only present after the contract is settled.Example: 87654.32

data[].contractOrderbooksobject

data[].volumestring

Total trading volume in USDExample: 125000.00

data[].liquiditystring

Total liquidity in USDExample: 50000.00

data[].tagsarray

data[].effectiveDatestring (date-time)

data[].expiryDatestring (date-time)

data[].subcategoryobject

Nested category information for the event

data[].sourcestring

Data source identifier for price observation. Aggregated from contracts for crypto Up/Down events.Example: GRR-KAIKO_BTCUSD_60S

data[].settlementobject

Settlement information for resolved events

data[].settlement.valuestring

The observed settlement value (e.g., the price at expiry for crypto contracts)Example: 87654.32

paginationobject

pagination.limitinteger

Example: 50

pagination.offsetinteger

Example: 0

pagination.totalinteger

Example: 100

Example Responses

{
  "data": [
    {
      "id": "evt_123",
      "title": "Will Bitcoin reach $100k by end of 2025?",
      "slug": "bitcoin-100k-2025",
      "description": "Bitcoin must reach $100,000 USD on any major exchange by December 31, 2025",
      "imageUrl": "https://example.com/btc.png",
      "type": "binary",
      "category": "crypto",
      "series": null,
      "ticker": "BTC100K2025",
      "status": "active",
      "resolvedAt": null,
      "createdAt": "2025-01-01T00:00:00.000Z",
      "effectiveDate": "2025-01-01T00:00:00.000Z",
      "expiryDate": "2025-12-31T23:59:59.000Z",
      "liquidity": "500000.00",
      "tags": [
        "bitcoin",
        "cryptocurrency",
        "price-prediction"
      ],
      "contracts": [
        {
          "id": "contract_123",
          "label": "Yes",
          "description": null,
          "prices": {
            "buy": {
              "yes": "0.65",
              "no": "0.35"
            },
            "sell": {
              "yes": "0.65",
              "no": "0.35"
            },
            "bestBid": "0.64",
            "bestAsk": "0.66",
            "lastTradePrice": "0.65"
          },
          "totalShares": "1000000",
          "color": "#00ff00",
          "status": "active",
          "imageUrl": null,
          "priceHistory": null,
          "createdAt": "2025-01-01T00:00:00.000Z",
          "expiryDate": "2025-12-31T23:59:59.000Z",
          "resolutionSide": null,
          "resolvedAt": null,
          "termsAndConditionsUrl": "https://example.com/terms",
          "ticker": "BTC100K-YES",
          "instrumentSymbol": "GEMI-BTC100K-YES",
          "effectiveDate": "2025-01-01T00:00:00.000Z"
        },
        {
          "id": "contract_124",
          "label": "No",
          "description": null,
          "prices": {
            "buy": {
              "yes": "0.35",
              "no": "0.65"
            },
            "sell": {
              "yes": "0.35",
              "no": "0.65"
            },
            "bestBid": "0.34",
            "bestAsk": "0.36",
            "lastTradePrice": "0.35"
          },
          "totalShares": "1000000",
          "color": "#ff0000",
          "status": "active",
          "imageUrl": null,
          "priceHistory": null,
          "createdAt": "2025-01-01T00:00:00.000Z",
          "expiryDate": "2025-12-31T23:59:59.000Z",
          "resolutionSide": null,
          "resolvedAt": null,
          "termsAndConditionsUrl": "https://example.com/terms",
          "ticker": "BTC100K-NO",
          "instrumentSymbol": "GEMI-BTC100K-NO",
          "effectiveDate": "2025-01-01T00:00:00.000Z"
        }
      ]
    },
    {
      "id": "evt_124",
      "title": "Will ETH reach $5k by end of 2025?",
      "slug": "ethereum-5k-2025",
      "description": "Ethereum must reach $5,000 USD on any major exchange by December 31, 2025",
      "imageUrl": "https://example.com/eth.png",
      "type": "binary",
      "category": "crypto",
      "series": null,
      "ticker": "ETH5K2025",
      "status": "active",
      "resolvedAt": null,
      "createdAt": "2025-01-01T00:00:00.000Z",
      "effectiveDate": "2025-01-01T00:00:00.000Z",
      "expiryDate": "2025-12-31T23:59:59.000Z",
      "liquidity": "300000.00",
      "tags": [
        "ethereum",
        "cryptocurrency",
        "price-prediction"
      ],
      "contracts": [
        {
          "id": "contract_125",
          "label": "Yes",
          "description": null,
          "prices": {
            "buy": {
              "yes": "0.48",
              "no": "0.52"
            },
            "sell": {
              "yes": "0.48",
              "no": "0.52"
            },
            "bestBid": "0.47",
            "bestAsk": "0.49",
            "lastTradePrice": "0.48"
          },
          "totalShares": "800000",
          "color": "#00ff00",
          "status": "active",
          "imageUrl": null,
          "priceHistory": null,
          "createdAt": "2025-01-01T00:00:00.000Z",
          "expiryDate": "2025-12-31T23:59:59.000Z",
          "resolutionSide": null,
          "resolvedAt": null,
          "termsAndConditionsUrl": "https://example.com/terms",
          "ticker": "ETH5K-YES",
          "instrumentSymbol": "GEMI-ETH5K-YES",
          "effectiveDate": "2025-01-01T00:00:00.000Z"
        },
        {
          "id": "contract_126",
          "label": "No",
          "description": null,
          "prices": {
            "buy": {
              "yes": "0.52",
              "no": "0.48"
            },
            "sell": {
              "yes": "0.52",
              "no": "0.48"
            },
            "bestBid": "0.51",
            "bestAsk": "0.53",
            "lastTradePrice": "0.52"
          },
          "totalShares": "800000",
          "color": "#ff0000",
          "status": "active",
          "imageUrl": null,
          "priceHistory": null,
          "createdAt": "2025-01-01T00:00:00.000Z",
          "expiryDate": "2025-12-31T23:59:59.000Z",
          "resolutionSide": null,
          "resolvedAt": null,
          "termsAndConditionsUrl": "https://example.com/terms",
          "ticker": "ETH5K-NO",
          "instrumentSymbol": "GEMI-ETH5K-NO",
          "effectiveDate": "2025-01-01T00:00:00.000Z"
        }
      ]
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 2
  }
}

PreviousEvents NextGet Event

Last modified on April 17, 2026

Query Parameters

statusarray

Filter by event status (can specify multiple)

categoryarray

Filter by category (can specify multiple). If omitted, returns events from all categories.

searchstring

Search text to filter events by title

limitinteger

Maximum number of results to return (max 500)Default: 50

offsetinteger

Number of results to skip for paginationDefault: 0

Responses

Successful response

dataarray

data[].idstring

data[].titlestring

Example: Will Bitcoin reach $100k by end of 2025?

data[].slugstring

Example: bitcoin-100k-2025

data[].descriptionstring

data[].imageUrlstring

data[].typestring·enum

Type of prediction marketEnum values: binarycategorical

data[].categorystring

Example: crypto

data[].seriesstring

data[].tickerstring

The event ticker (e.g., "BTC100K2025")Example: BTC100K2025

data[].statusstring·enum

Status of a prediction marketEnum values: approvedactiveclosedunder_reviewsettledinvalid

data[].resolvedAtstring (date-time)

data[].createdAtstring (date-time)

data[].contractsarray

Tradeable contracts within this event

data[].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 description

data[].contracts[].pricesobject

Current bid/ask pricing for the contract

data[].contracts[].totalSharesstring

data[].contracts[].colorstring

data[].contracts[].statusstring·enum

Status of a prediction marketEnum values: approvedactiveclosedunder_reviewsettledinvalid

data[].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: yesno

data[].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: openclosed

data[].contracts[].sortOrderinteger

Display order within the event

data[].contracts[].strikeobject

Strike price information for Up/Down crypto contracts

data[].contracts[].strike.valuestring

The strike price value. Null for "reference" type strikes where the value is determined at availableAt time.Example: 87500.00

data[].contracts[].strike.typestring·enum

Strike type - "reference" for Up/Down contracts, "above" for Higher/Lower contractsEnum values: referenceaboveExample: reference

data[].contracts[].strike.availableAtstring (date-time)

When the strike price becomes availableExample: 2026-03-27T19:45:00.000Z

data[].contracts[].sourcestring

Data source identifier for price observation (e.g., "GRR-KAIKO_BTCUSD_60S"). Present for crypto Up/Down contracts.Example: GRR-KAIKO_BTCUSD_60S

data[].contracts[].settlementValuestring

The observed settlement price. Only present after the contract is settled.Example: 87654.32

data[].contractOrderbooksobject

data[].volumestring

Total trading volume in USDExample: 125000.00

data[].liquiditystring

Total liquidity in USDExample: 50000.00

data[].tagsarray

data[].effectiveDatestring (date-time)

data[].expiryDatestring (date-time)

data[].subcategoryobject

Nested category information for the event

data[].sourcestring

Data source identifier for price observation. Aggregated from contracts for crypto Up/Down events.Example: GRR-KAIKO_BTCUSD_60S

data[].settlementobject

Settlement information for resolved events

data[].settlement.valuestring

The observed settlement value (e.g., the price at expiry for crypto contracts)Example: 87654.32

paginationobject

pagination.limitinteger

Example: 50

pagination.offsetinteger

Example: 0

pagination.totalinteger

Example: 100

Example Responses

{
  "data": [
    {
      "id": "evt_123",
      "title": "Will Bitcoin reach $100k by end of 2025?",
      "slug": "bitcoin-100k-2025",
      "description": "Bitcoin must reach $100,000 USD on any major exchange by December 31, 2025",
      "imageUrl": "https://example.com/btc.png",
      "type": "binary",
      "category": "crypto",
      "series": null,
      "ticker": "BTC100K2025",
      "status": "active",
      "resolvedAt": null,
      "createdAt": "2025-01-01T00:00:00.000Z",
      "effectiveDate": "2025-01-01T00:00:00.000Z",
      "expiryDate": "2025-12-31T23:59:59.000Z",
      "liquidity": "500000.00",
      "tags": [
        "bitcoin",
        "cryptocurrency",
        "price-prediction"
      ],
      "contracts": [
        {
          "id": "contract_123",
          "label": "Yes",
          "description": null,
          "prices": {
            "buy": {
              "yes": "0.65",
              "no": "0.35"
            },
            "sell": {
              "yes": "0.65",
              "no": "0.35"
            },
            "bestBid": "0.64",
            "bestAsk": "0.66",
            "lastTradePrice": "0.65"
          },
          "totalShares": "1000000",
          "color": "#00ff00",
          "status": "active",
          "imageUrl": null,
          "priceHistory": null,
          "createdAt": "2025-01-01T00:00:00.000Z",
          "expiryDate": "2025-12-31T23:59:59.000Z",
          "resolutionSide": null,
          "resolvedAt": null,
          "termsAndConditionsUrl": "https://example.com/terms",
          "ticker": "BTC100K-YES",
          "instrumentSymbol": "GEMI-BTC100K-YES",
          "effectiveDate": "2025-01-01T00:00:00.000Z"
        },
        {
          "id": "contract_124",
          "label": "No",
          "description": null,
          "prices": {
            "buy": {
              "yes": "0.35",
              "no": "0.65"
            },
            "sell": {
              "yes": "0.35",
              "no": "0.65"
            },
            "bestBid": "0.34",
            "bestAsk": "0.36",
            "lastTradePrice": "0.35"
          },
          "totalShares": "1000000",
          "color": "#ff0000",
          "status": "active",
          "imageUrl": null,
          "priceHistory": null,
          "createdAt": "2025-01-01T00:00:00.000Z",
          "expiryDate": "2025-12-31T23:59:59.000Z",
          "resolutionSide": null,
          "resolvedAt": null,
          "termsAndConditionsUrl": "https://example.com/terms",
          "ticker": "BTC100K-NO",
          "instrumentSymbol": "GEMI-BTC100K-NO",
          "effectiveDate": "2025-01-01T00:00:00.000Z"
        }
      ]
    },
    {
      "id": "evt_124",
      "title": "Will ETH reach $5k by end of 2025?",
      "slug": "ethereum-5k-2025",
      "description": "Ethereum must reach $5,000 USD on any major exchange by December 31, 2025",
      "imageUrl": "https://example.com/eth.png",
      "type": "binary",
      "category": "crypto",
      "series": null,
      "ticker": "ETH5K2025",
      "status": "active",
      "resolvedAt": null,
      "createdAt": "2025-01-01T00:00:00.000Z",
      "effectiveDate": "2025-01-01T00:00:00.000Z",
      "expiryDate": "2025-12-31T23:59:59.000Z",
      "liquidity": "300000.00",
      "tags": [
        "ethereum",
        "cryptocurrency",
        "price-prediction"
      ],
      "contracts": [
        {
          "id": "contract_125",
          "label": "Yes",
          "description": null,
          "prices": {
            "buy": {
              "yes": "0.48",
              "no": "0.52"
            },
            "sell": {
              "yes": "0.48",
              "no": "0.52"
            },
            "bestBid": "0.47",
            "bestAsk": "0.49",
            "lastTradePrice": "0.48"
          },
          "totalShares": "800000",
          "color": "#00ff00",
          "status": "active",
          "imageUrl": null,
          "priceHistory": null,
          "createdAt": "2025-01-01T00:00:00.000Z",
          "expiryDate": "2025-12-31T23:59:59.000Z",
          "resolutionSide": null,
          "resolvedAt": null,
          "termsAndConditionsUrl": "https://example.com/terms",
          "ticker": "ETH5K-YES",
          "instrumentSymbol": "GEMI-ETH5K-YES",
          "effectiveDate": "2025-01-01T00:00:00.000Z"
        },
        {
          "id": "contract_126",
          "label": "No",
          "description": null,
          "prices": {
            "buy": {
              "yes": "0.52",
              "no": "0.48"
            },
            "sell": {
              "yes": "0.52",
              "no": "0.48"
            },
            "bestBid": "0.51",
            "bestAsk": "0.53",
            "lastTradePrice": "0.52"
          },
          "totalShares": "800000",
          "color": "#ff0000",
          "status": "active",
          "imageUrl": null,
          "priceHistory": null,
          "createdAt": "2025-01-01T00:00:00.000Z",
          "expiryDate": "2025-12-31T23:59:59.000Z",
          "resolutionSide": null,
          "resolvedAt": null,
          "termsAndConditionsUrl": "https://example.com/terms",
          "ticker": "ETH5K-NO",
          "instrumentSymbol": "GEMI-ETH5K-NO",
          "effectiveDate": "2025-01-01T00:00:00.000Z"
        }
      ]
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 2
  }
}