Skip to main content
GET
/
series
List series
curl --request GET \
  --url https://api-v2.polyrouter.io/series \
  --header 'X-API-Key: <api-key>'
{
  "pagination": {
    "total": 50,
    "limit": 50,
    "has_more": true,
    "next_cursor": "WzMsW1swLDEsM11dXQ"
  },
  "series": [
    {
      "id": "1",
      "platform": "polymarket",
      "platform_id": "<string>",
      "title": "NFL 2024 Season",
      "last_synced_at": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "image_url": "<string>",
      "category": "<string>",
      "tags": [
        "<string>"
      ],
      "event_count": 123,
      "market_count": 123,
      "total_volume": 123,
      "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 series)

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 events in series. Defaults to false for v1 compatibility

Available options:
true,
false

Response

List of series

pagination
object
required
series
object[]
required
meta
object
required