Resolutions

Full resolution lifecycle timeline for one market

Returns the append-only event timeline (proposed, disputed, reset, settled, etc.) for a market's resolution, oldest first, capped at 200 events, keyed the same way as .../resolution (kalshi ticker identifies the market directly; CTF venues resolve market_id to its on-chain condition id first). Duplicate ingestion events are de-duplicated before ordering chronologically. Rate-limit bucket: LIGHT.

Cache lifetime matches the resolution-status endpoint: a Cache-Control header with a strong ETag (304 on matching If-None-Match).

get/v1/markets/{provider}/{market_id}/resolution/events

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

Path parameters

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

For kalshi, the ticker (used directly as market_key). For CTF venues, the market id — resolved to its condition_id internally.

Response

Resolution event timeline (possibly empty if the market has resolution state but no recorded events yet).

providerstring required
market_idstring required

Echoes the requested market_id.

market_keystring required

The key events were actually queried by — equals market_id for kalshi; equals the resolved condition_id for CTF venues.

Example response

{
  "provider": "kalshi",
  "market_id": "TICK-A",
  "market_key": "TICK-A",
  "events": [
    {
      "event_type": "proposed",
      "source": "polygon",
      "event_ts": "2026-07-01T10:00:00+00:00",
      "price_norm": 1,
      "payout_numerators": [
        1,
        0
      ],
      "proposer": "0xprop",
      "bond": "500000000000",
      "reward": "5000000",
      "expiration_ts": "2026-07-01T12:00:00+00:00",
      "request_timestamp": "2026-07-01T09:00:00+00:00",
      "tx_hash": "0xdead",
      "block_number": 123
    }
  ]
}

Changes

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