查询交易对行情、买卖价差与 24 小时市场统计
如何使用这个 Tool
使用下列已部署输入字段。必填字段必须提供;可选筛选用于缩小结果范围。
queryParams.pair (必填): 交易对,例如 BTC/USDT。
queryParams.type (可选): 市场类型:现货使用 spot,永续合约可使用 swap、perpetual 或 perp;默认值为 spot。
queryParams.exchange (可选): 交易所标识符,默认值为 binance。注意:hyperliquid 使用 USDC 结算的永续合约,查询时应传入 USDC 报价交易对,例如 BTC/USDC:USDC。
返回内容
返回最新价、买价、卖价、24 小时高低价、基础币成交量、涨跌百分比和快照时间。
返回字段与解读方式
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值;可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
表内路径从 Surf 响应根开始。此 Tool 的已保存 Example 将该响应放在 result 内,例如表内 data.[].field 对应保存 run 输出中的 result.data.[].field。这个包装关系和已观测记录仅说明保存的请求,不能保证所有后续输入都返回相同内容。
覆盖范围、单位与时效
价格单位取决于请求交易对。BTC/USDT 样本的价格为 USDT、基础币成交量为 BTC;保存时间点的价格不是当前市价。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整;来源没有说明时效或完整性保证时,应视为未知。保存的 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 客户费用。