Skip to main content
GET
/
gateway
/
v1
/
prediction-market
/
category-metrics
Prediction Market Category Metrics
curl --request GET \
  --url https://api.ask.surf/gateway/v1/prediction-market/category-metrics
{
  "data": [
    {
      "category": "<string>",
      "notional_volume_usd": 123,
      "open_interest_usd": 123,
      "source": "<string>",
      "subcategory": "<string>",
      "timestamp": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "<string>"
}

Query Parameters

source
enum<string>

Filter by prediction market platform: Kalshi or Polymarket

Available options:
Kalshi,
Polymarket
Example:

"Polymarket"

category
enum<string>

Filter by top-level category

Available options:
crypto,
culture,
economics,
financials,
politics,
stem,
sports
Example:

"politics"

time_range
enum<string>
default:30d

Predefined time range: 7d, 30d, 90d, 180d, 1y, or all

Available options:
7d,
30d,
90d,
180d,
1y,
all
Example:

"30d"

limit
integer<int64>
default:200

Maximum rows to return

Required range: 1 <= x <= 10000
Example:

200

offset
integer<int64>
default:0

Pagination offset

Required range: x >= 0
Example:

0

Response

OK

data
object[] | null
required
meta
object
required
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponsePredictionMarketCategoryMetricsItem.json"