查看按历史时间分桶的清算统计。返回历史多头与空头清算美元总额，以及纳入和排除交易所背景。 通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Surf
查看按历史时间分桶的清算统计。返回历史多头与空头清算美元总额，以及纳入和排除交易所背景。 通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
返回历史多头与空头清算美元总额，以及纳入和排除交易所背景。 应展示排除的交易所；一个分桶的总额不一定是全球全部清算额。
请查看[Binance]在[2026年10月1日至7日]自动结束的[比特币]交易金额，并按[每小时]汇总。说明这些交易原本判断价格会上涨还是下跌，并列出未纳入的交易平台；金额可能不包含所有平台。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
queryParamsqueryParams | object | 必填 |
|
toqueryParams.to | string | 选填 | 结束时间，可使用 Unix 秒级时间戳（1706745600）或日期字符串（2024-02-01）。示例：2024-02-01。
|
fromqueryParams.from | string | 选填 | 开始时间，可使用 Unix 秒级时间戳（1704067200）或日期字符串（2024-01-01）。示例：2024-01-01。
|
limitqueryParams.limit | integer | 选填 | 每页结果数量，默认 500。示例：500。
|
symbolqueryParams.symbol | string | 必填 | 代币代码，例如 BTC 或 ETH。示例：BTC。
|
exchangequeryParams.exchange | string | 选填 | 交易所名称，可选 Binance、OKX、Bybit、Bitget、Hyperliquid、Gate、HTX、Bitmex、Bitfinex、CoinEx、Aster 或 Lighter。默认 Binance。示例：Binance。
|
intervalqueryParams.interval | string | 选填 | 图表中每个数据点的统计间隔，可选 1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d 或 1w。此端点只接受 interval，不接受 time_range；请用 from/to 限定时间范围。默认 1h。示例：1h。
|
{
"type": "object",
"required": [
"queryParams"
],
"properties": {
"queryParams": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"to": {
"type": "string",
"minLength": 1,
"description": "结束时间，可使用 Unix 秒级时间戳（1706745600）或日期字符串（2024-02-01）。示例：2024-02-01。"
},
"from": {
"type": "string",
"minLength": 1,
"description": "开始时间，可使用 Unix 秒级时间戳（1704067200）或日期字符串（2024-01-01）。示例：2024-01-01。"
},
"limit": {
"type": "integer",
"default": 500,
"maximum": 4500,
"minimum": 1,
"description": "每页结果数量，默认 500。示例：500。"
},
"symbol": {
"type": "string",
"minLength": 1,
"description": "代币代码，例如 BTC 或 ETH。示例：BTC。"
},
"exchange": {
"enum": [
"Binance",
"OKX",
"Bybit",
"Bitget",
"Hyperliquid",
"Gate",
"HTX",
"Bitmex",
"Bitfinex",
"CoinEx",
"Aster",
"Lighter"
],
"type": "string",
"default": "Binance",
"description": "交易所名称，可选 Binance、OKX、Bybit、Bitget、Hyperliquid、Gate、HTX、Bitmex、Bitfinex、CoinEx、Aster 或 Lighter。默认 Binance。示例：Binance。"
},
"interval": {
"enum": [
"1m",
"3m",
"5m",
"15m",
"30m",
"1h",
"4h",
"6h",
"8h",
"12h",
"1d",
"1w"
],
"type": "string",
"default": "1h",
"description": "图表中每个数据点的统计间隔，可选 1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d 或 1w。此端点只接受 interval，不接受 time_range；请用 from/to 限定时间范围。默认 1h。示例：1h。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
查看按历史时间分桶的清算统计
使用下列已部署输入字段。必填字段必须提供；可选筛选用于缩小结果范围。
queryParams.to (可选): 结束时间，可使用 Unix 秒级时间戳（1706745600）或日期字符串（2024-02-01）。示例：2024-02-01。
queryParams.from (可选): 开始时间，可使用 Unix 秒级时间戳（1704067200）或日期字符串（2024-01-01）。示例：2024-01-01。
queryParams.limit (可选): 每页结果数量，默认 500。示例：500。
queryParams.symbol (必填): 代币代码，例如 BTC 或 ETH。示例：BTC。
queryParams.exchange (可选): 交易所名称，可选 Binance、OKX、Bybit、Bitget、Hyperliquid、Gate、HTX、Bitmex、Bitfinex、CoinEx、Aster 或 Lighter。默认 Binance。示例：Binance。
queryParams.interval (可选): 图表中每个数据点的统计间隔，可选 1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d 或 1w。此端点只接受 interval，不接受 time_range；请用 from/to 限定时间范围。默认 1h。示例：1h。
返回历史多头与空头清算美元总额，以及纳入和排除交易所背景。
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值；可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
字段、类型与是否必填 | 含义与返回条件 |
|---|---|
data.[].contributing_exchanges array | null; 父对象内可选 | 为该清算数据点提供数据的交易所。 |
data.[].excluded_exchanges array | null; 父对象内可选 | 请求中因无清算数据而被省略的交易所。 |
data.[].long_liquidation_usd number; 父对象内必填; format: double | 多头侧汇总清算量，单位为 USD。 |
data.[].short_liquidation_usd number; 父对象内必填; format: double | 空头侧汇总清算量，单位为 USD。 |
data.[].timestamp integer; 父对象内必填; format: int64 | Unix 时间戳，单位为秒。 |
meta.cached boolean; 父对象内必填 | 该响应是否来自缓存。 |
meta.credits_used integer; 父对象内必填; format: int64 | 来源 API 为该请求扣除的积分；此字段属于来源 API，不等同于 Toolmu 客户积分上限。 |
meta.empty_reason string; 父对象内可选 | 数据数组为空时的原因提示，仅在适用时提供。 |
应展示排除的交易所；一个分桶的总额不一定是全球全部清算额。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。
此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期，不是数据观测时间。实际覆盖取决于所选接口和请求。
通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
示例请求：查看[Bybit]上[以太坊]从[2026年10月1日]到[2026年10月7日]自动结束的交易总额，按[每天]汇总，并说明这些交易原本判断价格会上涨还是下跌。
请查看[Binance]在[2026年10月1日至7日]自动结束的[比特币]交易金额，并按[每小时]汇总。说明这些交易原本判断价格会上涨还是下跌，并列出未纳入的交易平台；金额可能不包含所有平台。
示例请求：查看[OKX]上[Solana]从[2026年9月1日]到[2026年10月1日]自动结束的交易金额，按[每周]汇总，并说明总额不一定包括所有平台。
queryParams.to (可选): 结束时间，可使用 Unix 秒级时间戳（1706745600）或日期字符串（2024-02-01）。示例：2024-02-01。 queryParams.from (可选): 开始时间，可使用 Unix 秒级时间戳（1704067200）或日期字符串（2024-01-01）。示例：2024-01-01。 queryParams.limit (可选): 每页结果数量，默认 500。示例：500。 queryParams.symbol (必填): 代币代码，例如 BTC 或 ETH。示例：BTC。 queryParams.exchange (可选): 交易所名称，可选 Binance、OKX、Bybit、Bitget、Hyperliquid、Gate、HTX、Bitmex、Bitfinex、CoinEx、Aster 或 Lighter。默认 Binance。示例：Binance。 queryParams.interval (可选): 图表中每个数据点的统计间隔，可选 1m、3m、5m、15m、30m、1h、4h、6h、8h、12h、1d 或 1w。此端点只接受 interval，不接受 time_range；请用 from/to 限定时间范围。默认 1h。示例：1h。
返回历史多头与空头清算美元总额，以及纳入和排除交易所背景。
应展示排除的交易所；一个分桶的总额不一定是全球全部清算额。
通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
请让智能体查看按历史时间分桶的清算统计，并提供上方必填输入。已有 Toolmu 连接时直接复用；尚未连接时按此页的配置说明完成连接。付费执行前，智能体应读取最新 Tool 契约，核对可用性、积分上限、余额、预算和你的授权，再执行 Tool 并解释返回字段及限制。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。