获取单个 Kalshi 市场的历史订单簿快照。返回 Kalshi 历史订单簿快照、价格档位、时间和分页资料。 通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Surf
获取单个 Kalshi 市场的历史订单簿快照。返回 Kalshi 历史订单簿快照、价格档位、时间和分页资料。 通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
返回 Kalshi 历史订单簿快照、价格档位、时间和分页资料。 应使用文档规定的毫秒编码与美分价格档位。历史订单簿不保证当前可执行流动性。
请查看 [Kalshi 市场分享链接] 在[过去7天]的历史报价，说明买家当时愿意出的价格和卖家要价。先从链接找到市场；如果对应多个市场，请按市场问题让我选择，不要让我提供代码。用简单语言说明变化，标出记录时间和美分价格，并提醒旧报价现在未必还能使用。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
queryParamsqueryParams | object | 必填 |
|
limitqueryParams.limit | integer | 选填 | 最多返回的快照数量，默认 100。
|
tickerqueryParams.ticker | string | 必填 | Kalshi 市场代码。示例：KXCITRINI-28JUL01。
|
end_timequeryParams.end_time | integer | 选填 | 结束时间，使用 Unix 毫秒级时间戳；0 表示当前时间。
|
start_timequeryParams.start_time | integer | 选填 | 开始时间，使用 Unix 毫秒级时间戳；0 表示 7 天前。
|
pagination_keyqueryParams.pagination_key | string | 选填 | Base64 编码的分页游标。
|
{
"type": "object",
"required": [
"queryParams"
],
"properties": {
"queryParams": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ticker"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"limit": {
"type": "integer",
"default": 100,
"maximum": 200,
"minimum": 1,
"description": "最多返回的快照数量，默认 100。"
},
"ticker": {
"type": "string",
"minLength": 1,
"description": "Kalshi 市场代码。示例：KXCITRINI-28JUL01。"
},
"end_time": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "结束时间，使用 Unix 毫秒级时间戳；0 表示当前时间。"
},
"start_time": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "开始时间，使用 Unix 毫秒级时间戳；0 表示 7 天前。"
},
"pagination_key": {
"type": "string",
"minLength": 1,
"description": "Base64 编码的分页游标。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
获取单个 Kalshi 市场的历史订单簿快照
使用下列已部署输入字段。必填字段必须提供；可选筛选用于缩小结果范围。
queryParams.limit (可选): 最多返回的快照数量，默认 100。
queryParams.ticker (必填): Kalshi 市场代码。示例：KXCITRINI-28JUL01。
queryParams.end_time (可选): 结束时间，使用 Unix 毫秒级时间戳；0 表示当前时间。
queryParams.start_time (可选): 开始时间，使用 Unix 毫秒级时间戳；0 表示 7 天前。
queryParams.pagination_key (可选): Base64 编码的分页游标。
返回 Kalshi 历史订单簿快照、价格档位、时间和分页资料。
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值；可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
字段、类型与是否必填 | 含义与返回条件 |
|---|---|
pagination object; 父对象内必填 | 由响应结构定义的对象或数组项分组：#/components/schemas/V2CursorPagination。请查看下方嵌套字段；来源没有为此分组单独说明含义。 |
pagination.count integer; 父对象内必填; format: int64 | 当前响应中的项目数。 |
pagination.has_more boolean; 父对象内必填 | 是否还有更多可用数据。 |
pagination.limit integer; 父对象内必填; format: int64 | 请求指定的数量上限。 |
pagination.pagination_key string; 父对象内可选 | 下一页的 Base64 游标。 |
snapshots array | null; 父对象内必填 | 官方合同声明了此字段，但没有解释含义或单位。其解读仍待验证，不能仅根据字段名推断完整性或单位。 |
snapshots.[].ask_depth integer; 父对象内必填; format: int64 | 卖方总深度，单位为合约。 |
snapshots.[].best_ask integer; 父对象内必填; format: int64 | 最优卖价，单位为美分。 |
snapshots.[].best_bid integer; 父对象内必填; format: int64 | 最优买价，单位为美分。 |
snapshots.[].bid_depth integer; 父对象内必填; format: int64 | 买方总深度，单位为合约。 |
snapshots.[].sequence integer; 父对象内必填; format: int64 | 序列号。 |
snapshots.[].ticker string; 父对象内必填 | 市场代码。 |
snapshots.[].timestamp integer; 父对象内必填; format: int64 | 快照时间，单位为毫秒。 |
snapshots.[].yes_asks array | null; 父对象内必填 | Yes 卖单，按价格升序排列。 |
snapshots.[].yes_asks.[].price integer; 父对象内必填; format: int64 | 价格，单位为美分，范围为 1–99。 |
snapshots.[].yes_asks.[].size integer; 父对象内必填; format: int64 | 该价格档位的合约数量。 |
snapshots.[].yes_bids array | null; 父对象内必填 | Yes 买单，按价格降序排列。 |
snapshots.[].yes_bids.[].price integer; 父对象内必填; format: int64 | 价格，单位为美分，范围为 1–99。 |
snapshots.[].yes_bids.[].size integer; 父对象内必填; format: int64 | 该价格档位的合约数量。 |
应使用文档规定的毫秒编码与美分价格档位。历史订单簿不保证当前可执行流动性。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。
此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期，不是数据观测时间。实际覆盖取决于所选接口和请求。
通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
示例请求：查看[Kalshi 市场链接]在[过去30天]的买家和卖家报价变化，并说明旧报价现在未必还能使用。
请查看 [Kalshi 市场分享链接] 在[过去7天]的历史报价，说明买家当时愿意出的价格和卖家要价。先从链接找到市场；如果对应多个市场，请按市场问题让我选择，不要让我提供代码。用简单语言说明变化，标出记录时间和美分价格，并提醒旧报价现在未必还能使用。
示例请求：查看[Kalshi 市场链接]从[2026年10月1日]到[2026年10月7日]的报价记录，并标出时间和美分价格。
queryParams.limit (可选): 最多返回的快照数量，默认 100。 queryParams.ticker (必填): Kalshi 市场代码。示例：KXCITRINI-28JUL01。 queryParams.end_time (可选): 结束时间，使用 Unix 毫秒级时间戳；0 表示当前时间。 queryParams.start_time (可选): 开始时间，使用 Unix 毫秒级时间戳；0 表示 7 天前。 queryParams.pagination_key (可选): Base64 编码的分页游标。
返回 Kalshi 历史订单簿快照、价格档位、时间和分页资料。
应使用文档规定的毫秒编码与美分价格档位。历史订单簿不保证当前可执行流动性。
通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
请让智能体获取单个 Kalshi 市场的历史订单簿快照，并提供上方必填输入。已有 Toolmu 连接时直接复用；尚未连接时按此页的配置说明完成连接。付费执行前，智能体应读取最新 Tool 契约，核对可用性、积分上限、余额、预算和你的授权，再执行 Tool 并解释返回字段及限制。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。