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

© 2026 Gemini Space Station, Inc.

Getting StartedAPI Specifications
Maker and Taker Incentives
    Market Maker ProgramMaker Rebate ProgramLiquidity Rewards ProgramTaker Rewards Program
WebSocket
    IntroductionAuthenticationMessage Format
    Streams
      Book TickerL2 Partial DepthL2 Differential DepthTrade StreamOrder EventsBalance UpdatesPosition UpdatesContract Status
    Playground
      OverviewconninfopingtimeSUBSCRIBEUNSUBSCRIBELIST_SUBSCRIPTIONSdepthorder.placeorder.cancelorder.cancel_allorder.cancel_session
REST APIs
    Combos
    Events
    Volume
      Get Prediction Market Volume
    Terms
    Order Management
    Positions
    Rewards
Combo Contracts
    Overview
Combos Request-for-Quote (RFQ)
    OverviewWebSocket StreamsQuote MethodsMaker IntegrationExamples
Tickers & Taxonomy
    OverviewCryptoSportsSports Market TaxonomyCommoditiesWeather
Schemas

Get Prediction Market Volume

Requests

Select one completed UTC date from the rolling one-year window. The current UTC day is unavailable. The daily endpoint returns flat category-path rows for the whole day:

TerminalCode
curl "https://api.gemini.com/v1/prediction-markets/volume/2026-07-20"

Append /hourly to return one flat category row for each completed UTC hour. Each hourly row includes its periodStart:

TerminalCode
curl "https://api.gemini.com/v1/prediction-markets/volume/2026-07-20/hourly"

Dates before the 2025-12-15 launch and post-launch dates with any missing source hour return 404 NOT_FOUND; the endpoint never returns a partial day.

REST APIsPrediction MarketsVolumeGet Prediction Market Volume

Get Prediction Market Volume

GEThttps://api.gemini.com/v1/prediction-markets/volume/{date}

Returns public prediction-market trade volume for one completed UTC day as flat category-path rows. No authentication is required.

GETv1/prediction-markets/volume/2026-07-20
curl --request GET \
  --url https://api.gemini.com/v1/prediction-markets/volume/2026-07-20

Path Parameters

datestring·required
Completed UTC calendar date in YYYY-MM-DD format.

Responses

Category volume for the requested UTC day

categoryPatharray·required
Display-name path from the top-level category to this category. It replaces recursive child nodes.Example: Sports,Football,Pro Football
volumestring·required
Total volume for this category, including all descendant categories.Example: 143567.25
Example Responses
[
  {
    "categoryPath": [
      "Sports"
    ],
    "volume": "200097"
  },
  {
    "categoryPath": [
      "Sports",
      "Soccer"
    ],
    "volume": "3952"
  }
]

Hourly volume

REST APIsPrediction MarketsVolumeGet Prediction Market Volume

Get Hourly Prediction Market Volume

GEThttps://api.gemini.com/v1/prediction-markets/volume/{date}/hourly

Returns public prediction-market trade volume for each completed UTC hour in one date as flat category-path rows. No authentication is required.

GETv1/prediction-markets/volume/2026-07-20/hourly
curl --request GET \
  --url https://api.gemini.com/v1/prediction-markets/volume/2026-07-20/hourly

Path Parameters

datestring·required
Completed UTC calendar date in YYYY-MM-DD format.

Responses

Hourly category volume for the requested UTC day

periodStartstring (date-time)·required
Inclusive UTC start of this hourly period.Example: 2026-07-20T00:00:00Z
categoryPatharray·required
Display-name path from the top-level category to this category. It replaces recursive child nodes.Example: Sports,Football,Pro Football
volumestring·required
Total volume for this category in this hour, including all descendant categories.Example: 143567.25
Example Responses
[
  {
    "periodStart": "2026-07-20T00:00:00Z",
    "categoryPath": [
      "Sports"
    ],
    "volume": "200097"
  },
  {
    "periodStart": "2026-07-20T00:00:00Z",
    "categoryPath": [
      "Sports",
      "Soccer"
    ],
    "volume": "3952"
  }
]
PreviousVolumeNextTerms
Last modified on July 28, 2026
On this page
  • Requests
  • Hourly volume