GET/api/v1/markets/{ticker}/snapshots

Get snapshots

Return a downsampled top-of-book + coin price series for a research window (max 6 hours). For the market-page chart, use preview.

Auth required.

Try it

API key

Loading…

Query parameters

Name	Default	Notes
`limit`	1000	Max rows (1–5000)
`step_ms`	1000	Downsample interval
`include_book`	false	Full L2 arrays when true
`start_ts` / `end_ts`	—	Optional unix bounds (max 6 hours)
`preview`	false	Short research clamp. Prefer GET /preview for the UI

curl

curl "https://kalshieye.com/api/v1/markets/KXBTC15M-26OCT051600-00/snapshots?limit=24&step_ms=30000" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

200 response

{
  "ticker": "KXBTC15M-26OCT051600-00",
  "series": "KXBTC15M",
  "step_ms": 30000,
  "include_book": false,
  "count": 2,
  "snapshots": [
    {
      "ts": 1728152700.0,
      "yes_best_bid": 0.36,
      "yes_best_ask": 0.37,
      "coin_price": 85693.975
    },
    {
      "ts": 1728152730.0,
      "yes_best_bid": 0.40,
      "yes_best_ask": 0.41,
      "coin_price": 85710.12
    }
  ]
}