市场与时间范围
请提供准确的 Kalshi 市场代码,以及带时区的起止时间。这里需要的是具体市场 ticker,而非事件或系列代码。智能体将两项时间转换为整数 Unix 毫秒,并把 ticker、start_time、end_time 直接放在 queryParams 中,不放进 queryParams.query。结束时间应晚于开始时间。可选 limit 为 1–2,000 的整数,供应商默认 100;分页上限不保证实际返回数量。
供应商说明该历史数据从 2026 年 1 月 7 日开始,但未说明精确的起始时刻。这不保证每个市场、每段时间都有记录。空列表或不完整结果不能证明没有订单,一页结果也不能证明连续覆盖。这是历史查询,不是持续推送当前订单簿变化的数据流。
阅读可用的快照记录
供应商将可用快照描述为带市场代码、毫秒时间戳的记录。yes_bids 是 Yes 选项的买盘价格档位,按价格降序;yes_asks 是 Yes 选项的卖盘档位,按价格升序。每个档位的 price 使用整数美分,size 表示合约数量。供应商文档列出的价格为 1–99 美分,但返回的边界价格也可能为 0 或 100,应原样保留。例如返回的价格值 50 表示 50 美分(0.50 美元),应明确保留单位。
best_bid、best_ask 使用美分价格。bid_depth、ask_depth 表示买盘、卖盘的合约总数量,并非美元金额,也不是已经成交的交易量。sequence 用于同一时间戳内的记录排序,不表示全局唯一或无缺口的序列。快照是订单簿记录,不能据此认定已成交或保证成交。 深度是供应商返回的数值,可能与展示档位的数量之和不同,应保留原值,不能用重新计算的总数替换。
整美分精度与可用性
此查询将带小数美分精度的价格舍入为整美分。供应商说明,这会扩大买卖价差,并合并相邻价格档位,因此无法据此还原原始的小数美分价格或原生订单簿的精确价差。应保留返回的档位及数量,不能猜测更细的价格。
供应商已经宣布将停用此查询,但该文档尚未给出截止日期。它推荐的小数美分查询是另一项能力,本工具不会自动切换过去。请求历史记录前,应检查工具当前可用性。
来源与连接
Predexon 的 Kalshi 订单簿历史文档说明时间、价格、数量和舍入限制;对应的 BlockRun 接口定义提供本工具使用的路径。连接智能体到 Toolmu后,提供需要查看的市场和时间段。