List events

Fetch events from prediction market platforms with pagination. Only Polymarket and Kalshi support events.

GET /events

List events

cURL

curl --request GET \
  --url https://api-v2.polyrouter.io/events \
  --header 'X-API-Key: <api-key>'

200

{
  "pagination": {
    "total": 50,
    "limit": 50,
    "has_more": true,
    "next_cursor": "WzMsW1swLDEsM11dXQ"
  },
  "events": [
    {
      "id": "4690",
      "platform": "polymarket",
      "platform_id": "<string>",
      "title": "US Presidential Election 2024",
      "last_synced_at": "<string>",
      "series_id": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "image_url": "<string>",
      "resolution_source_url": "<string>",
      "event_start_at": "<string>",
      "event_end_at": "<string>",
      "market_count": 5,
      "total_volume": 123,
      "markets": [
        {
          "id": "KXELONMARS-99",
          "platform": "kalshi",
          "platform_id": "KXELONMARS-99",
          "title": "Will Elon Musk visit Mars before Aug 1, 2099?",
          "status": "open",
          "market_type": "binary",
          "outcomes": [
            {
              "id": "yes",
              "name": "Yes"
            }
          ],
          "current_prices": {},
          "last_synced_at": "<string>",
          "event_id": "KXELONMARS-99",
          "event_name": "Will Elon Musk visit Mars?",
          "event_slug": "elon-musk-mars",
          "series_id": "<string>",
          "slug": "kxelonmars-99",
          "market_slug": "kxelonmars-99",
          "description": "<string>",
          "category": "Science",
          "subcategory": "<string>",
          "tags": [
            "<string>"
          ],
          "volume_24h": 10000,
          "volume_7d": 50000,
          "volume_total": 500000,
          "liquidity": 123,
          "liquidity_score": 123,
          "open_interest": 123,
          "unique_traders": 123,
          "fee_rate": 123,
          "trading_fee": 123,
          "withdrawal_fee": 123,
          "source_url": "https://kalshi.com/markets/kxelonmars-99",
          "image_url": "<string>",
          "created_at": "<string>",
          "trading_start_at": "<string>",
          "trading_end_at": "<string>",
          "resolution_date": "<string>",
          "resolved_at": "<string>",
          "resolution_criteria": "<string>",
          "resolution_source": "<string>",
          "price_24h_changes": {},
          "price_7d_changes": {},
          "last_trades": {},
          "metadata": {
            "conditionId": "<string>",
            "ammType": "<string>",
            "marketType": "<string>",
            "formatType": "<string>",
            "competitive": 0,
            "score": 0,
            "bestBid": 0.64,
            "bestAsk": 0.66,
            "spread": 0.02,
            "clobTokenIds": [
              "<string>"
            ]
          }
        }
      ]
    }
  ],
  "meta": {
    "platforms_queried": [
      "polymarket",
      "kalshi"
    ],
    "request_time": 150,
    "cache_hit": false,
    "data_freshness": "2025-01-01T00:00:00.000Z"
  }
}

Authorizations

X-API-Key · string · header · required

API key for authentication

Query Parameters

limit · string

Number of items to return (max 100)

Example:

"50"

cursor · string

Pagination cursor from previous response

platform · enum<string>

Filter by specific platform (only polymarket and kalshi support events)

Available options: polymarket, kalshi

query · string

Search query - when provided, switches to search mode

Example:

"bitcoin"

include_raw · enum<string>

Include raw platform response data

Available options: true, false

include_nested · enum<string>

Include nested markets in events. Defaults to false for v1 compatibility

Available options: true, false

Response

200

application/json

List of events

pagination · object · required

Show child attributes

events · object[] · required

Show child attributes

meta · object · required

Show child attributes