加密货币市场数据 API：交易所 K 线与成交量 · Surf

获取单个交易对的交易所 OHLCV 蜡烛图数据。返回交易对 OHLCV 蜡烛图，以及可用周期边界、极值、成交量和蜡烛图数量。通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0072 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。

你的 AI

在你的 AI 中使用

多步骤任务，也可以在你常用的 AI 中继续完成。

CodexClaude CodeCursorWindsurfCline

查看指令

在后台把用户熟悉的币名和计价货币匹配到受支持的市场，不要让用户输入交易对代码。名称可能对应多个币种或货币时，先简单追问。默认使用 [Binance] 和普通买卖市场；只有用户提出时才选择其他支持的交易所或合约市场。结果默认每 [1 小时] 一条。用户说明回看时长后，选择合适的记录间隔，让结果尽量覆盖所需时段；不要让用户填写记录数量或页码。需要额外付费查询才能补全更长历史时，先说明并征求同意。价格按用户选择的货币显示，不要自动换算成美元；只有返回内容说明单位时才解释成交量。用日常语言说明更新时间和数据范围，没有证据时不要承诺实时或完整。复用现有 Toolmu 连接，或引导用户访问 https://toolmu.com/zh/get-started。付费前核对当前可用性、最高费用、余额、预算和用户授权。参考 https://toolmu.com/zh/tools/exchange-ohlcv-candlesticks-surf。

任务:
查看 [Binance] 上 [比特币] 以 [泰达币] 计价的价格和成交量，回看 [7 天]，每 [4 小时] 一次。

粘贴到已连接工具的 AI 对话中。

连接指南

每次调用最多 0.0072 积分

按确认的实际用量结算，未使用的预留额度会恢复到可用余额。

Surf

加密货币市场数据 API：交易所 K 线与成交量 · Surf

得到的结果

返回交易对 OHLCV 蜡烛图，以及可用周期边界、极值、成交量和蜡烛图数量。价格使用请求交易对的报价币种；BTC/USDT 的价格单位为 USDT，不能自动标为美元。成交量单位以字段文档为准。

从你的任务开始

查看 [Binance] 上 [比特币] 以 [泰达币] 计价的价格和成交量，回看 [7 天]，每 [4 小时] 一次。

输入与输出

开始前检查当前输入要求、可用状态和最高预留费用。

输入参数

输入参数
字段 / 路径	类型	是否必填	含义
queryParams`queryParams`	`object`	必填	必填字段 `pair`
from`queryParams.from`	`string`	选填	开始时间，可使用 Unix 秒级时间戳或日期字符串（YYYY-MM-DD、ISO8601）。示例：2026-03-01。最小长度 `1`
pair`queryParams.pair`	`string`	必填	交易对，例如 BTC/USDT。示例：BTC/USDT。最小长度 `1`
type`queryParams.type`	`string`	选填	市场类型：spot 表示现货；swap、perpetual 或 perp 表示永续合约。默认 spot。示例：spot。默认值 `spot` 可选值 `spot, swap, perpetual, perp`
limit`queryParams.limit`	`integer`	选填	最多返回的 K 线数量，默认 100。交易所可能设置更低的上限，例如 200–1000。查询更长时间范围时，用上次返回的最后一个时间戳作为下一次的 from。示例：100。默认值 `100` 最小值 `1` 最大值 `1000`
exchange`queryParams.exchange`	`string`	选填	交易所标识，默认 binance。hyperliquid 使用 USDC 结算的永续合约，例如 BTC/USDC:USDC，查询时请使用以 USDC 报价的交易对。示例：binance。默认值 `binance` 可选值 `binance, okx, bybit, bitget, coinbase, kraken, gate, htx, kucoin, mexc, upbit, bitfinex, bitstamp, deribit, bitmex, bithumb, hyperliquid`
interval`queryParams.interval`	`string`	选填	每条价格与成交量 K 线的时间周期。此端点只接受 interval，不接受 time_range；请用 from 和 limit 控制查询范围。默认 1h。示例：1h。默认值 `1h` 可选值 `1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M`

查看原始 JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "pair"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "from": {
          "type": "string",
          "minLength": 1,
          "description": "开始时间，可使用 Unix 秒级时间戳或日期字符串（YYYY-MM-DD、ISO8601）。示例：2026-03-01。"
        },
        "pair": {
          "type": "string",
          "minLength": 1,
          "description": "交易对，例如 BTC/USDT。示例：BTC/USDT。"
        },
        "type": {
          "enum": [
            "spot",
            "swap",
            "perpetual",
            "perp"
          ],
          "type": "string",
          "default": "spot",
          "description": "市场类型：spot 表示现货；swap、perpetual 或 perp 表示永续合约。默认 spot。示例：spot。"
        },
        "limit": {
          "type": "integer",
          "default": 100,
          "maximum": 1000,
          "minimum": 1,
          "description": "最多返回的 K 线数量，默认 100。交易所可能设置更低的上限，例如 200–1000。查询更长时间范围时，用上次返回的最后一个时间戳作为下一次的 from。示例：100。"
        },
        "exchange": {
          "enum": [
            "binance",
            "okx",
            "bybit",
            "bitget",
            "coinbase",
            "kraken",
            "gate",
            "htx",
            "kucoin",
            "mexc",
            "upbit",
            "bitfinex",
            "bitstamp",
            "deribit",
            "bitmex",
            "bithumb",
            "hyperliquid"
          ],
          "type": "string",
          "default": "binance",
          "description": "交易所标识，默认 binance。hyperliquid 使用 USDC 结算的永续合约，例如 BTC/USDC:USDC，查询时请使用以 USDC 报价的交易对。示例：binance。"
        },
        "interval": {
          "enum": [
            "1m",
            "3m",
            "5m",
            "15m",
            "30m",
            "1h",
            "2h",
            "4h",
            "6h",
            "8h",
            "12h",
            "1d",
            "3d",
            "1w",
            "1M"
          ],
          "type": "string",
          "default": "1h",
          "description": "每条价格与成交量 K 线的时间周期。此端点只接受 interval，不接受 time_range；请用 from 和 limit 控制查询范围。默认 1h。示例：1h。"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

返回结构

暂未配置返回字段说明。

补充说明

获取单个交易对的交易所 OHLCV 蜡烛图数据

如何使用这个 Tool

使用下列已部署输入字段。必填字段必须提供；可选筛选用于缩小结果范围。

queryParams.from (可选): 开始时间，可使用 Unix 秒级时间戳或日期字符串（YYYY-MM-DD、ISO8601）。示例：2026-03-01。

queryParams.pair (必填): 交易对，例如 BTC/USDT。示例：BTC/USDT。

queryParams.type (可选): 市场类型：spot 表示现货；swap、perpetual 或 perp 表示永续合约。默认 spot。示例：spot。

queryParams.limit (可选): 最多返回的 K 线数量，默认 100。交易所可能设置更低的上限，例如 200–1000。查询更长时间范围时，用上次返回的最后一个时间戳作为下一次的 from。示例：100。

queryParams.exchange (可选): 交易所标识，默认 binance。hyperliquid 使用 USDC 结算的永续合约，例如 BTC/USDC:USDC，查询时请使用以 USDC 报价的交易对。示例：binance。

queryParams.interval (可选): 每条价格与成交量 K 线的时间周期。此端点只接受 interval，不接受 time_range；请用 from 和 limit 控制查询范围。默认 1h。示例：1h。

返回内容

返回交易对 OHLCV 蜡烛图，以及可用周期边界、极值、成交量和蜡烛图数量。

返回字段与解读方式

下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值；可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。

字段、类型与是否必填	含义与返回条件
data.[].candles array \| null; 父对象内必填	OHLCV K 线数据。
data.[].candles.[].close number; 父对象内必填; format: double	收盘价格。
data.[].candles.[].high number; 父对象内必填; format: double	该时间间隔内的最高价格。
data.[].candles.[].low number; 父对象内必填; format: double	该时间间隔内的最低价格。
data.[].candles.[].open number; 父对象内必填; format: double	开盘价格。
data.[].candles.[].timestamp integer \| null; 父对象内必填; format: int64	K 线开始时间，单位为 Unix 秒。
data.[].candles.[].volume number; 父对象内必填; format: double	成交量，单位为基础币数量。
data.[].count integer; 父对象内必填; format: int64	K 线数量。
data.[].exchange string; 父对象内必填	交易所标识。
data.[].interval string; 父对象内必填	K 线时间间隔。
data.[].pair string; 父对象内必填	交易对。
data.[].period_end string \| null; 父对象内必填	最后一根 K 线的日期时间。
data.[].period_high number \| null; 父对象内必填; format: double	该期间最高价格。
data.[].period_low number \| null; 父对象内必填; format: double	该期间最低价格。
data.[].period_start string \| null; 父对象内必填	第一根 K 线的日期时间。
data.[].period_volume number \| null; 父对象内必填; format: double	该期间总成交量。
meta.cached boolean; 父对象内必填	该响应是否来自缓存。
meta.credits_used integer; 父对象内必填; format: int64	来源 API 为该请求扣除的积分；此字段属于来源 API，不等同于 Toolmu 客户积分上限。
meta.empty_reason string; 父对象内可选	数据数组为空时的原因提示，仅在适用时提供。

覆盖范围、单位与时效

价格使用请求交易对的报价币种；BTC/USDT 的价格单位为 USDT，不能自动标为美元。成交量单位以字段文档为准。

按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。

数据来源与引用

此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期，不是数据观测时间。实际覆盖取决于所选接口和请求。

Surf Data API 官方文档

Surf 官方 OpenAPI 合同

通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0072 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。

关于这个工具，你可能还想知道。

输入要求、结果含义，以及使用前需要了解的细节。

连接指南

告诉我要查哪种币、用哪种货币看价格，例如 [比特币] 以 [泰达币] 计价。可以指定交易所，如 [Binance]；不指定时默认使用 [Binance]。也可以说明回看多久、每条记录间隔多久，例如回看 [7 天]、每 [4 小时] 一条。默认每小时一条。默认查普通买卖市场；想查 [永续合约] 时请说明。币名或货币名不明确时，我会先问清楚。你不需要输入交易对代码。

加密货币市场数据 API：交易所 K 线与成交量 · Surf

加密货币市场数据 API：交易所 K 线与成交量 · Surf

得到的结果

从你的任务开始

输入与输出

输入参数

返回结构

如何使用这个 Tool

返回内容

返回字段与解读方式

覆盖范围、单位与时效

数据来源与引用

按小时查看近期数据

按天查看以太坊历史

每四小时查看 Solana 历史

关于这个工具，你可能还想知道。

得到的结果

从你的任务开始

输入与输出

输入参数

返回结构

如何使用这个 Tool

返回内容

返回字段与解读方式

覆盖范围、单位与时效

数据来源与引用

按小时查看近期数据

按天查看以太坊历史

每四小时查看 Solana 历史

关于这个工具，你可能还想知道。

需要提供哪些输入？

结果包含什么？

如何理解覆盖范围与单位？

这个 Tool 如何计费？

如何让智能体完成这个任务？

打开页面或 Example 会获取当前数据吗？