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:
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:
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.
Get Prediction Market Volume GET https://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.
GET v1/prediction-markets/volume/2026-07-20
curl --request GET \
--url https://api.gemini.com/v1/prediction-markets/volume/2026-07-20Path Parameters date string · required
Completed UTC calendar date in YYYY-MM-DD format. Responses Properties Example
Category volume for the requested UTC day
categoryPath array · required
Display-name path from the top-level category to this category. It replaces recursive child nodes. Example: Sports,Football,Pro Football volume string · required
Total volume for this category, including all descendant categories. Example: 143567.25 [
{
"categoryPath": [
"Sports"
],
"volume": "200097"
},
{
"categoryPath": [
"Sports",
"Soccer"
],
"volume": "3952"
}
]Hourly volume
Get Hourly Prediction Market Volume GET https://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.
GET v1/prediction-markets/volume/2026-07-20/hourly
curl --request GET \
--url https://api.gemini.com/v1/prediction-markets/volume/2026-07-20/hourlyPath Parameters date string · required
Completed UTC calendar date in YYYY-MM-DD format. Responses Properties Example
Hourly category volume for the requested UTC day
periodStart string (date-time) · required
Inclusive UTC start of this hourly period. Example: 2026-07-20T00:00:00Z categoryPath array · required
Display-name path from the top-level category to this category. It replaces recursive child nodes. Example: Sports,Football,Pro Football volume string · required
Total volume for this category in this hour, including all descendant categories. Example: 143567.25 [
{
"periodStart": "2026-07-20T00:00:00Z",
"categoryPath": [
"Sports"
],
"volume": "200097"
},
{
"periodStart": "2026-07-20T00:00:00Z",
"categoryPath": [
"Sports",
"Soccer"
],
"volume": "3952"
}
]
