Skip to main content
GET
/
markets
List markets
curl --request GET \
  --url https://api-v2.polyrouter.io/markets \
  --header 'X-API-Key: <api-key>'
{
  "pagination": {
    "total": 50,
    "limit": 50,
    "has_more": true,
    "next_cursor": "WzMsW1swLDEsM11dXQ"
  },
  "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

Available options:
polymarket,
kalshi,
limitless,
manifold
status
enum<string>

Filter by market status

Available options:
open,
closed,
resolved,
paused,
unopened
query
string

Search query - when provided, switches to search mode

Example:

"bitcoin"

include_raw
enum<string>

Include raw platform response data in metadata._raw

Available options:
true,
false

Response

List of markets

pagination
object
required
markets
object[]
required
meta
object
required