Skip to main content
GET /api/v1/events Aggregates normalized markets into event summaries keyed by canonical event_id. Use this endpoint when you want event-level browsing first, then optional market expansion and published matched_events context.

​
Error Semantics

  • 503 means the market snapshot has not finished loading yet.

​
Parameters

​
exchanges
string
Comma-separated exchange IDs to include. Omit to query all exchanges in the current snapshot.
​
search
string
Keyword search in event titles.
​
status
string
Event status filter such as active, closed, or resolved.
​
min_volume
number
Minimum total volume across all markets in the event.
​
include_markets
boolean
default:"false"
Include constituent markets directly in the response.
​
limit
number
default:"50"
Results per page. Range: 1-100.
​
cursor
string
Cursor from a previous response.

​
Response

​
(root)
object
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parsecapi.com/api/v1/events?search=super+bowl&include_markets=true&limit=5"

{
  "events": [
    {
      "event_id": "kalshi:KXSB-26",
      "title": "Super Bowl LX",
      "market_count": 12,
      "total_volume": 4500000,
      "exchanges": ["kalshi", "polymarket"],
      "status": "active",
      "close_time": "2026-02-09T00:00:00Z",
      "matched_events": [
        {
          "event_id": "ev:super-bowl-lx-winner",
          "title": "Super Bowl LX Winner",
          "exchanges": ["polymarket"],
          "confidence": 0.96,
          "confidence_tier": "HIGH",
          "source": "tier1_exact"
        }
      ],
      "markets": [
        {
          "parsec_id": "kalshi:KXSB-26-CHI",
          "exchange": "kalshi",
          "exchange_market_id": "KXSB-26-CHI",
          "question": "Will Chicago win Super Bowl LX?",
          "status": "active"
        }
      ]
    }
  ],
  "pagination": {
    "count": 1,
    "total": 1,
    "has_more": false
  }
}