Kalshi 历史成交记录 | BlockRun

指定市场与时段

至少提供 ticker 或 event_ticker 中的一项。ticker 精确匹配一个 Kalshi 市场，event_ticker 按事件代码前缀匹配。事件查询可能涉及多个市场代码，应明确保留请求范围。供应商未说明同时提供这两个条件时如何组合；市场与事件条件冲突时，应先澄清，不能自行改变范围。

这些条件直接放在 queryParams 中，queryParams.query 不会展开成成交查询参数。可选 start_time 和 end_time 使用整数 Unix 秒。提供日历时间时注明时区，让智能体正确转换。来源没有说明最早历史日期、保留期限或时间边界的包含规则。

可选条件与分页

供应商规定 taker_side 为 yes 或 no，min_count 为至少 1 的整数，单位是合约数量。limit 接受 1–500 的整数，默认 100。order 接受 asc 或 desc，默认 desc；来源未明确排序字段或相同值的先后规则。这些条件不保证返回指定数量的记录，也不保证历史覆盖完整。

pagination.count 是本页成交记录数，不是合约数量或整个时段的总数。pagination.limit 表示请求的分页大小。has_more 表示供应商报告还有记录；有提供时，pagination_key 是下一页游标，应保留原值。空页仅表示此响应没有返回成交，不能证明没有发生交易，也不能证明历史完整。

阅读返回的成交

供应商用 trade_id、市场 ticker、count、yes_price、no_price、taker_side 和 created_time 描述成交。count 表示这笔成交的合约数量。yes_price 和 no_price 是分别返回的价格小数，来源将其描述为 0–1 数值，应保留两项原值。来源未定义这些字段的货币换算或概率校准，不能由一边的价格推算另一边，也不能把它们当作经过验证的概率。

created_time 使用 Unix 秒。taker_side 是供应商的 yes/no 标记，不标识交易者，也不能据此确定买入或卖出、盈亏或当前持仓。这些是已记录的成交，与当前订单簿报价不同。其他返回字段应保留原值，不能仅根据字段名称猜测单位。此查询获取记录，不下单。

来源与连接

Predexon 的 Kalshi 成交历史文档说明市场或事件条件、时间参数及成交字段；对应的 BlockRun 接口定义提供本工具的路径。连接智能体到 Toolmu后，提供需要查看的市场或事件。