Hyperliquid 交易历史汇总 · Surf

按选定周期汇总账户的已平仓交易。返回周期分桶的交易数、毛损益与净损益、手续费、胜率，以及单独报告的资金费用背景。通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。

你的 AI

在你的 AI 中使用

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

CodexClaude CodeCursorWindsurfCline

查看指令

汇总一个 Hyperliquid 账户的已平仓交易。不要让用户填写字段名称、市场代码或特殊格式的日期。如果用户提供 Hyperliquid 个人资料链接，仅在链接能明确识别公开账户时使用；否则用简单的话请用户提供能识别账户的个人资料链接或公开钱包地址。默认汇总所有可用市场和可用历史，并按天整理。每次调用只能选择一种查看方式：按天、按币种、按用户判断价格会上涨或下跌时的交易、按交易金额大小，或按持有时间。如果用户说了日期或时间段，换算成工具支持的日期范围。一次不能混合多种查看方式；用户提出多种时，先用简单问题询问想先看哪一种。复用现有 Toolmu 连接；尚未连接时引导用户访问 https://toolmu.com/zh/get-started。任何付费调用前，核对最新契约、可用状态、maximumCredits、余额、预算和用户授权。付费调用状态不确定时不要自动重交。用通俗的话解释汇总数据：净损益不含资金费用；资金费用合计可能只覆盖最新一部分记录。历史资金费用缺失时不要说成 0，也不要声称历史数据完整。结果说明见 https://toolmu.com/zh/tools/closed-trades-aggregate-surf。

任务:
提供 [Hyperliquid 个人资料链接]，并选择一种方式汇总 [已平仓交易]：[按天]、[按币种]、[按你判断币价会上涨或下跌的方向]、[按交易金额大小]，或 [按每笔交易持有多久]。默认使用所有可用记录并按天汇总；如果只查一段时间，请提供 [开始日期] 和 [结束日期]。如果链接无法识别账户，我会用简单问题向你确认。

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

连接指南

每次调用最多 0.0288 积分

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

Surf

Hyperliquid 交易历史汇总 · Surf

得到的结果

返回周期分桶的交易数、毛损益与净损益、手续费、胜率，以及单独报告的资金费用背景。此处净损益为毛损益减手续费，不含资金费用。与含资金费用的排行榜比较前，应检查 funding_status。

从你的任务开始

提供 [Hyperliquid 个人资料链接]，并选择一种方式汇总 [已平仓交易]：[按天]、[按币种]、[按你判断币价会上涨或下跌的方向]、[按交易金额大小]，或 [按每笔交易持有多久]。默认使用所有可用记录并按天汇总；如果只查一段时间，请提供 [开始日期] 和 [结束日期]。如果链接无法识别账户，我会用简单问题向你确认。

输入与输出

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

输入参数

输入参数
字段 / 路径	类型	是否必填	含义
queryParams`queryParams`	`object`	必填	必填字段 `address`
to`queryParams.to`	`string`	选填	交易汇总参数 1。最小长度 `1`
dex`queryParams.dex`	`string`	选填	交易汇总参数 2。可选值 `main_dex, xyz, flx, vntl, hyna, km, abcd, cash, para, mkts`
from`queryParams.from`	`string`	选填	交易汇总参数 3。最小长度 `1`
address`queryParams.address`	`string`	必填	交易汇总参数 4。最小长度 `1`
group_by`queryParams.group_by`	`string`	选填	交易汇总参数 5。默认值 `day` 可选值 `day, symbol, direction, size_bucket, hold_bucket`
fill_gaps`queryParams.fill_gaps`	`boolean`	选填	交易汇总参数 6。默认值 `false`

查看原始 JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "address"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "to": {
          "type": "string",
          "minLength": 1,
          "description": "交易汇总参数 1。"
        },
        "dex": {
          "enum": [
            "main_dex",
            "xyz",
            "flx",
            "vntl",
            "hyna",
            "km",
            "abcd",
            "cash",
            "para",
            "mkts"
          ],
          "type": "string",
          "description": "交易汇总参数 2。"
        },
        "from": {
          "type": "string",
          "minLength": 1,
          "description": "交易汇总参数 3。"
        },
        "address": {
          "type": "string",
          "minLength": 1,
          "description": "交易汇总参数 4。"
        },
        "group_by": {
          "enum": [
            "day",
            "symbol",
            "direction",
            "size_bucket",
            "hold_bucket"
          ],
          "type": "string",
          "default": "day",
          "description": "交易汇总参数 5。"
        },
        "fill_gaps": {
          "type": "boolean",
          "default": false,
          "description": "交易汇总参数 6。"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

返回结构

暂未配置返回字段说明。

补充说明

按选定周期汇总账户的已平仓交易

如何使用这个 Tool

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

queryParams.to (可选): 交易汇总参数 1。

queryParams.dex (可选): 交易汇总参数 2。

queryParams.from (可选): 交易汇总参数 3。

queryParams.address (必填): 交易汇总参数 4。

queryParams.group_by (可选): 交易汇总参数 5。

queryParams.fill_gaps (可选): 交易汇总参数 6。

返回内容

返回周期分桶的交易数、毛损益与净损益、手续费、胜率，以及单独报告的资金费用背景。

返回字段与解读方式

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

字段、类型与是否必填	含义与返回条件
data.[].avg_loss number; 父对象内可选; format: double	亏损交易的平均 net_pnl，单位为 USD，为负值；该组没有亏损交易时省略。
data.[].avg_win number; 父对象内可选; format: double	盈利交易的平均 net_pnl，单位为 USD；该组没有盈利交易时省略。
data.[].fees number; 父对象内必填; format: double	各持仓期间的手续费合计，单位为 USD。
data.[].funding_pnl number; 父对象内必填; format: double	单独归属的资金费用合计，单位为 USD，正值表示收到。不计入 net_pnl；使用前检查 funding_status。
data.[].funding_status string; 父对象内必填; enum: ["complete", "partial", "unavailable"]	该组各持仓的 funding_pnl 覆盖状态。
data.[].gross_pnl number; 父对象内必填; format: double	各持仓的手续费前 gross_pnl 合计，单位为 USD。
data.[].key string; 父对象内必填	分组标识：按 day 分组时为 UTC 日期 YYYY-MM-DD；按 symbol 分组时为市场 ID；按 direction 时为 long/short；按 size_bucket 或 hold_bucket 时为区间标签，例如 10k-100k 或 1h-1d。
data.[].net_pnl number; 父对象内必填; format: double	各持仓 net_pnl 合计，单位为 USD；等于 gross_pnl 减手续费，不包括资金费用。
data.[].trade_count integer; 父对象内必填; format: int64	该组已结束的持仓交易次数。
data.[].volume_usd number; 父对象内必填; format: double	名义成交量，单位为 USD，按开仓数量乘入场价格汇总。
data.[].win_rate number; 父对象内必填; format: double	net_pnl 大于零的交易占比，范围为 0–1。
meta.cached boolean; 父对象内必填	该响应是否来自缓存。
meta.credits_used integer; 父对象内必填; format: int64	来源 API 为该请求扣除的积分；此字段属于来源 API，不等同于 Toolmu 客户积分上限。
meta.empty_reason string; 父对象内可选	数据数组为空时的原因提示，仅在适用时提供。
meta.has_more boolean; 父对象内可选	是否可能还有未返回的数据。offset 分页接口可增加 offset 继续查询；没有 offset/cursor 的时间序列接口返回 true 时，表示时间范围触及上游上限，应缩小 from/to。无法确认是否已取完时省略。
meta.limit integer; 父对象内必填; format: int64	本次响应最多返回的项目数。
meta.offset integer; 父对象内必填; format: int64	已跳过的项目数，即分页偏移量。
meta.total integer; 父对象内可选; format: int64	分页前的匹配项目总数；总数未知时省略。
meta.watermark integer; 父对象内可选; format: int64	本次计算采用的数据仓库水位时间，单位为 Unix 秒。仓库接口中，水位以前的数据来自仓库，更新的数据来自实时尾部；其他接口省略。

覆盖范围、单位与时效

此处净损益为毛损益减手续费，不含资金费用。与含资金费用的排行榜比较前，应检查 funding_status。

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

数据来源与引用

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

Surf Data API 官方文档

Surf 官方 OpenAPI 合同

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

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

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

连接指南

提供 [Hyperliquid 个人资料链接]，再选择一种汇总方式，例如 [按天] 或 [按币种]。默认按天整理所有可用记录。只查一段时间时，再提供 [开始日期] 和 [结束日期]。如果链接无法识别账户，我会请你提供能识别账户的个人资料链接或公开钱包地址。

Hyperliquid 交易历史汇总 · Surf

Hyperliquid 交易历史汇总 · Surf

得到的结果

从你的任务开始

输入与输出

输入参数

返回结构

如何使用这个 Tool

返回内容

返回字段与解读方式

覆盖范围、单位与时效

数据来源与引用

按天查看汇总

按币种和日期汇总

比较看涨和看跌时的交易

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

得到的结果

从你的任务开始

输入与输出

输入参数

返回结构

如何使用这个 Tool

返回内容

返回字段与解读方式

覆盖范围、单位与时效

数据来源与引用

按天查看汇总

按币种和日期汇总

比较看涨和看跌时的交易

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

需要提供什么？

结果包含什么？

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

这个 Tool 如何计费？

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

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