Gemini Prediction Markets API

Markets (1.0.0)

Endpoint

Public endpoints for browsing prediction markets.

Market Data: For real-time order book and market data, use the existing APIs with the contract's instrumentSymbol (e.g., GEMI-FEDJAN26-DN25):

Get Current Order Book - View bids and asks
Get Ticker - Recent trading activity
WebSocket Market Data - Real-time streaming updates

List prediction market events

GET

https://api.gemini.com

/v1/prediction-markets/events

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

List prediction market events › query Parameters

status

string[] · style: form · explode: true

Filter by event status (can specify multiple)

Enum values:

active

closed

underreview

settled

invalid

category

string[] · style: form · explode: true

Filter by category (can specify multiple)

search

string

Search text to filter events by title

limit

integer · min: 1 · max: 100

Maximum number of results to return (max 100)

Default: 50

offset

integer · min: 0

Number of results to skip for pagination

Default: 0

List prediction market events › Responses

Successful response

object[]

object

GET/v1/prediction-markets/events

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

shell

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,
          "price": "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,
          "price": "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,
          "price": "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,
          "price": "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
  }
}

json

application/json

Get event by ticker

GET

https://api.gemini.com

/v1/prediction-markets/events/{eventTicker}

Returns detailed information about a specific prediction market event.

Get event by ticker › path Parameters

eventTicker

string · required

The event ticker symbol (e.g., "BTC100K")

Get event by ticker › Responses

Successful response

A prediction market event containing one or more tradeable contracts

id

string

title

string

slug

string

description

string | null

imageUrl

string | null

type

string · enum

Type of prediction market

Enum values:

binary

categorical

category

string

series

string | null

ticker

string

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

Example: BTC100K2025

status

string · enum

Status of a prediction market

Enum values:

active

closed

underreview

settled

invalid

resolvedAt

string | null · date-time

createdAt

string · date-time

object[]

Tradeable contracts within this event

object

volume

string

Total trading volume in USD

Example: 125000.00

liquidity

string

Total liquidity in USD

Example: 50000.00

tags

array | null

effectiveDate

string · date-time

expiryDate

string | null · date-time

GET/v1/prediction-markets/events/{eventTicker}

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

shell

Example Responses

{
  "id": "id",
  "title": "Will Bitcoin reach $100k by end of 2025?",
  "slug": "bitcoin-100k-2025",
  "description": {},
  "imageUrl": {},
  "type": "binary",
  "category": "crypto",
  "series": {},
  "ticker": "BTC100K2025",
  "status": "active",
  "resolvedAt": "2024-08-25T15:00:00Z",
  "createdAt": "2024-08-25T15:00:00Z",
  "contracts": [
    {
      "id": "id",
      "label": "label",
      "description": {},
      "price": "0.65",
      "totalShares": "totalShares",
      "color": {},
      "status": "active",
      "imageUrl": {},
      "priceHistory": {},
      "createdAt": "2024-08-25T15:00:00Z",
      "expiryDate": "2024-08-25T15:00:00Z",
      "resolutionSide": "yes",
      "resolvedAt": "2024-08-25T15:00:00Z",
      "termsAndConditionsUrl": "termsAndConditionsUrl",
      "ticker": "ticker",
      "instrumentSymbol": "instrumentSymbol",
      "effectiveDate": "2024-08-25T15:00:00Z"
    }
  ],
  "contractOrderbooks": {},
  "volume": "125000.00",
  "liquidity": "50000.00",
  "tags": {},
  "effectiveDate": "2024-08-25T15:00:00Z",
  "expiryDate": "2024-08-25T15:00:00Z"
}

json

application/json

List event categories

GET

https://api.gemini.com

/v1/prediction-markets/categories

Returns available prediction market event categories, optionally filtered by event status.

List event categories › query Parameters

status

string[] · style: form · explode: true

Filter categories by event status

Enum values:

active

closed

underreview

settled

invalid

List event categories › Responses

Successful response

categories

string[]

GET/v1/prediction-markets/categories

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

shell

Example Responses

{
  "categories": [
    "string"
  ]
}

json

application/json

Trading

List prediction market events

GET

https://api.gemini.com

/v1/prediction-markets/events

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

List prediction market events › query Parameters

status

string[] · style: form · explode: true

Filter by event status (can specify multiple)

Enum values:

active

closed

underreview

settled

invalid

category

string[] · style: form · explode: true

Filter by category (can specify multiple)

search

string

Search text to filter events by title

limit

integer · min: 1 · max: 100

Maximum number of results to return (max 100)

Default: 50

offset

integer · min: 0

Number of results to skip for pagination

Default: 0

List prediction market events › Responses

Successful response

object[]

object

{ "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, "price": "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, "price": "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, "price": "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, "price": "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 } }

Get event by ticker

GET

https://api.gemini.com

/v1/prediction-markets/events/{eventTicker}

Returns detailed information about a specific prediction market event.

Get event by ticker › path Parameters

eventTicker

string · required

The event ticker symbol (e.g., "BTC100K")

Get event by ticker › Responses

Successful response

A prediction market event containing one or more tradeable contracts

id

string

title

string

slug

string

description

string | null

imageUrl

string | null

type

string · enum

Type of prediction market

Enum values:

binary

categorical

category

string

series

string | null

ticker

string

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

Example: BTC100K2025

status

string · enum

Status of a prediction market

Enum values:

active

closed

underreview

settled

invalid

resolvedAt

string | null · date-time

createdAt

string · date-time

object[]

Tradeable contracts within this event

object

volume

string

Total trading volume in USD

Example: 125000.00

liquidity

string

Total liquidity in USD

Example: 50000.00

tags

array | null

effectiveDate

string · date-time

expiryDate

string | null · date-time

{ "id": "id", "title": "Will Bitcoin reach $100k by end of 2025?", "slug": "bitcoin-100k-2025", "description": {}, "imageUrl": {}, "type": "binary", "category": "crypto", "series": {}, "ticker": "BTC100K2025", "status": "active", "resolvedAt": "2024-08-25T15:00:00Z", "createdAt": "2024-08-25T15:00:00Z", "contracts": [ { "id": "id", "label": "label", "description": {}, "price": "0.65", "totalShares": "totalShares", "color": {}, "status": "active", "imageUrl": {}, "priceHistory": {}, "createdAt": "2024-08-25T15:00:00Z", "expiryDate": "2024-08-25T15:00:00Z", "resolutionSide": "yes", "resolvedAt": "2024-08-25T15:00:00Z", "termsAndConditionsUrl": "termsAndConditionsUrl", "ticker": "ticker", "instrumentSymbol": "instrumentSymbol", "effectiveDate": "2024-08-25T15:00:00Z" } ], "contractOrderbooks": {}, "volume": "125000.00", "liquidity": "50000.00", "tags": {}, "effectiveDate": "2024-08-25T15:00:00Z", "expiryDate": "2024-08-25T15:00:00Z" }

List event categories

GET

https://api.gemini.com

/v1/prediction-markets/categories

Returns available prediction market event categories, optionally filtered by event status.

List event categories › query Parameters

status

string[] · style: form · explode: true

Filter categories by event status

Enum values:

active

closed

underreview

settled

invalid

List event categories › Responses

Successful response

categories

string[]