Kalshi 資料 API
Kalshi Data API
Kalshi 深度的一個 API：使用 Bearer 金鑰的 REST JSON 以存取歷史資料，並透過 WebSocket 提供標準化的即時訂單簿更新。每個介面均有詳細的封包格式與時間戳記說明。
DepthFeed Kalshi 資料 API 透過 REST 回傳市場發現、元資料及完整深度的歷史觀察資料。WebSocket 則發布標準化的即時訂單簿畫面。兩者皆為純 JSON，但用戶應遵循其文件規範，而非假設兩者物件逐位元組完全相同。
Kalshi 資料 API 一覽
- 協議
- HTTPS 上的 JSON — REST + WebSocket
- 認證
- Bearer / X-API-Key（或 WS 上的 ?api_key=）
- 發現流程
- 市場 → 快照 → 即時 /v3/stream
- 代理準備
- 無 SDK；適用 MCP / 函式呼叫
- 資產
- 7 種 — BTC · ETH · SOL · XRP · DOGE · BNB · HYPE
- 時間戳記
- 毫秒級觀察時間；場館專屬來源時間戳
- 標的價格
- 可用時採用最近的 Binance 參考價
- 歷史資料
- 7/30/90 天視窗 + 完整檔案（Desk）
- 交付方式
- REST 歷史資料 + 標準化即時 WebSocket 畫面
- 解析度
- 原始儲存觀察或 ?interval= 1s–1d
在拉取 Kalshi 歷史前先發現代碼
Kalshi 系列名稱與市場代碼是不同的識別碼。先發現請求時間窗內的場館原生代碼，再將其中一個精確代碼傳給訂單簿或快照端點。
curl -s "https://api.depthfeed.com/v3/kalshi/markets?series=KXBTC15M&start_time=2026-07-01T00:00:00Z&end_time=2026-07-02T00:00:00Z" \
-H "Authorization: Bearer df_your_key"
curl -s "https://api.depthfeed.com/v3/kalshi/<exact_market_ticker>/snapshots?include_orderbook=true" \
-H "Authorization: Bearer df_your_key"- 請勿從 UTC 時間戳合成歷史市場代碼；請使用發現回傳的識別碼。
- DepthFeed 將價格正規化為 0–1 美元，同時保留場館原生代碼與 Yes/No 訂單簿語義。
Kalshi 資料 API
API 提供的功能
歷史資料用 REST，即時訂單簿用 WebSocket
先發現市場，再透過 REST 拉取完整深度觀察資料。即時串流（wss://api.depthfeed.com/v3/stream）發布標準化的即時訂單簿畫面。共用的訂單簿欄位方便整合，場館專屬的識別碼、時間戳記與回應封包則保持明確。
為自動化與代理設計
API 為純 JSON，使用單一 Bearer 金鑰（或 X-API-Key），無需 SDK，可直接用於任何函式呼叫或 MCP 風格工具定義。WebSocket 協議包含三種 JSON 操作（訂閱 / 取消訂閱 / ping），無法設定標頭時可用 ?api_key= 認證。錯誤使用穩定的代碼列舉，可依此分支處理（AUTH_INVALID、COIN_NOT_IN_PLAN、RATE_LIMIT_BURST 等）。
計量、分頁且可調整
使用鍵集分頁、一般 REST 存取限制與獨立的歷史工作負載控管，確保大量拉取可預測。可選擇儲存解析度或加上 ?interval=，範圍從 1 秒到 1 天，每個時間桶選取一筆紀錄。端點不會插值未曾擷取的列。
