KAkairos
Markets

Paginate active markets for one provider

Enumerates active markets for a single provider, cursor-paginated. Rate-limit bucket: LIGHT.

The response is ETagged (strong ETag) with a Cache-Control header; a matching If-None-Match returns 304.

Returns 503 (cache_cold) until the active-market listing has been populated for the requested provider at least once.

get/v1/markets

Request

  • Base URL
    https://md.kairos.trade
  • Auth
    • none
    • or API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Query parameters

provider'kalshi' | 'polymarket' | 'opinion' | 'predictfun' | 'hyperliquid' | 'kalshi_offchain' | 'dome' required

Venue identifier. Case-insensitive; unknown values are rejected with 400.

limitinteger

Page size. Must be an integer in [1, 250].

cursorstring

Opaque pagination cursor from a previous response's next_cursor.

Response

Page of active markets.

exchange_idstring required
countinteger required

Number of markets in this page (markets.length).

next_cursorstring nullable required

Opaque cursor for the next page, or null when this is the last page.

has_moreboolean required

Example response

{
  "exchange_id": "kalshi",
  "markets": [
    {
      "exchange_id": "polymarket",
      "market_id": "1897040",
      "condition_id": "0xabc123...",
      "event_id": "evt-4521",
      "title": "Will BTC close above $120k on July 31?",
      "tick_size": 0.01,
      "taker_base_fee_bps": 200,
      "category": "Crypto",
      "group_slug": "btc-price-2026",
      "fee_type": "standard",
      "status": "active",
      "end_date": "2026-07-31T23:59:59Z",
      "open_time": "2026-01-01T00:00:00Z",
      "resolution_status": "resolved",
      "payout_numerators": [
        1,
        0
      ],
      "resolved_ts": "2026-07-16T00:00:00Z",
      "proposed_price": 1,
      "challenge_window_ends_at": "2026-07-16T02:00:00Z",
      "match_delay_ms": 1000,
      "outcomes": [
        {
          "outcome": "Yes",
          "normalized_outcome": "yes",
          "token_id": "18812649149814341758733697580460697418474693998558159483117",
          "side": "yes"
        }
      ]
    }
  ],
  "count": 100
}

Changes

No recorded changes to this operation across all 1 revision of this API.