Category Metrics

GET /gateway/v1/prediction-market/category-metrics

Prediction Market Category Metrics

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/prediction-market/category-metrics

200

{
  "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": "https://example.com/schemas/DataResponsePredictionMarketCategoryMetricsItem.json"
}

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

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

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