如何导出 Hyperliquid 交易历史（CSV）：税务与复盘完整指南

快速回答：导出 Hyperliquid 完整交易历史并不需要付费工具。交易所的公共 API 可以返回任意钱包的每一笔成交（fills）、资金费率（funding）和转账记录，App 的 History 页面也提供近期交易和资金费率的 CSV 导出按钮。问题在于：界面只能导出已加载的记录，而 API 每次调用最多返回 2,000 条。如果你不想写代码就拿到完整历史，Hyperfolio 可以即时显示任意 Hyperliquid 地址的完整 PnL、手续费和资金费率明细——免费且无需注册。

报税季快到了，你的会计发来消息："请提供 Hyperliquid 的交易记录"，而你有 4,000 笔交易分散在合约、现货和某个你几乎想不起来的钱包里。你打开 App，点击导出，得到的 CSV 只覆盖了……两三个月。你的真实 PnL 就藏在那段缺口里。

导出 Hyperliquid 交易历史是永续合约交易中最被低估的痛点。这个交易所非常透明——每一笔成交、资金费率支付、充值和提现都是链上公开数据——但把它们整理成一个干净、完整的文件却是另一回事。本指南梳理 2026 年所有可行的方法：App 的 CSV 导出及其限制、能取回全部数据的 API 端点、第三方导出工具，以及让整个问题消失的"零导出"替代方案。

为什么你需要完整的 Hyperliquid 历史记录

你的 Hyperliquid 账户历史不只是交易记录。无论是报税、分析业绩，还是对自己诚实复盘，你都需要四条独立的数据流：

• 成交记录（Fills）：每一笔已执行的订单，包括价格、数量、方向、时间戳和支付的手续费。
• 资金费率支付（Funding）：多头与空头之间的定期支付——在大多数司法管辖区属于应税收入。
• 充值与提现：进出交易所的资金流水。
• 已平仓 PnL：每笔仓位扣除手续费后实际赚了多少，而不是图表上显示的数字。

缺少任何一条数据流，你的税务报告就是错的。仅资金费率一项，就能让活跃交易者的年度 PnL 波动数千美元，而美国、英国、西班牙、德国和澳大利亚的税务机关都将永续合约资金费率视为应申报收入。Hyperliquid 税务完整指南介绍了如何申报每一条数据流；本指南则解决第一步——如何把数据取出来。

方法一：从 Hyperliquid App 导出（快，但有局限）

官方 App（app.hyperliquid.xyz）的 Portfolio → History 页面提供了 CSV 导出按钮，可以导出你的交易记录和资金费率历史。

这个方法确实能用，适合快速查看。但限制是结构性的：App 只能导出界面中当前已加载的记录。你需要不断向上滚动以加载更多历史，对于拥有数千笔成交的高频交易者来说，这根本不现实。官方界面没有"一键下载全部历史"的按钮。

要点：内置 CSV 导出适合近期活动，但不是完整历史的解决方案。

方法二：用公共 API 取回全部数据

Hyperliquid 通过一个无需认证的公共端点暴露所有账户数据：POST https://api.hyperliquid.xyz/info。你只需要钱包地址——不需要 API 密钥，不需要签名。三个关键调用：

• {"type":"userFills","user":"0x…"} — 最近的成交记录，最多 2,000 条。
• {"type":"userFillsByTime","user":"0x…","startTime":…,"endTime":…} — 指定时间窗口内的成交，可按 2,000 条一批分页翻完数年历史。
• {"type":"userFunding","user":"0x…"} — 资金费率支付（每次最多 500 条，同样分页）。
• {"type":"userNonFundingLedgerUpdates","user":"0x…"} — 充值、提现和内部转账。

一个用 Python 遍历全部成交记录的最小循环：

import requests, time

addr = "0x你的钱包"
end = int(time.time() * 1000)
start = 0
while end > start:
    r = requests.post("https://api.hyperliquid.xyz/info", json={
        "type": "userFillsByTime", "user": addr,
        "startTime": start, "endTime": end
    }).json()
    if not r: break
    for fill in r: print(fill["time"], fill["coin"], fill["side"], fill["px"], fill["sz"], fill["fee"], fill.get("closedPnl"))
    end = min(f["time"] for f in r) - 1
    time.sleep(0.2)

每条成交记录都包含税务工具所需的字段：时间戳、币种、方向、价格、数量、手续费以及该仓位平仓时的已实现 PnL。完整的开发者教程——WebSocket 流、限流和错误处理——见我们的Hyperliquid API Python 指南。

要点：API 能返回一切，但你需要自己构建并维护导出程序。如果你只想要答案，直接往下看。

方法三：第三方导出工具

因为 API 方式比较繁琐，市场上出现了自动分页的工具。最知名的是 trade-export.hypedexer.com，这是 Hyperliquid 官方文档中引用的第三方工具：连接钱包后即可将完整历史导出为 CSV 或 JSON，没有记录数量限制。它是独立维护的第三方服务，使用需自担风险——但用于一次性完整导出确实可行。

其他税务平台（CoinTracking、Cryptact、TradingAtlas 等）也直接支持导入 Hyperliquid 的 CSV，拿到文件后，报税那一半问题就解决了。

导出方法对比

方法	你能得到什么	历史覆盖范围	工作量	价格	适合谁
App CSV 导出	交易 + 资金费率 CSV	仅界面已加载的记录（近期）	低	免费	快速查看近期数据
公共 API（手动）	全部成交、资金费率、转账	完整，分页（每次 2,000 条）	高——需要写代码	免费	开发者与自动化
第三方导出工具	完整 CSV / JSON 导出	完整历史	中等	免费（第三方）	一次性完整导出
Hyperfolio	PnL、手续费、资金费率明细，多平台	完整历史，任意钱包，无需导出	零	免费，无需注册	想要答案而不是文件的交易者

规律很明显：数据越完整，工作量越大——除了最后一行。Hyperfolio 读取同样的公开数据，并把它变成一目了然的 PnL 明细：已实现和未实现 PnL、已支付手续费、收到或支付的资金费率，按钱包和平台拆分，还附带聪明钱（smart money）信号。

一份完整的导出必须包含什么

在把任何文件交给税务工具或会计师之前，对照这份清单检查：

• 全部成交记录，而不只是最近一段——包括每笔仓位的已平仓 PnL。
• 全部资金费率支付，含时间戳和金额。这些是收入事件。
• 充值与提现——用于核对成本基础和证明资金来源。
• 手续费——maker 和 taker 手续费会减少应税收益，且通常可以抵扣。
• 强平记录——强平是一种处置，也就是应税事件，而不只是一笔亏损。
• 空投事件——HYPE 创世空投（2024 年 11 月）在多数国家按其市场价值作为收入征税。

导出 Hyperliquid 数据时的常见错误

以下是我们最常见的错误，也正是它们让税务报告和 PnL 分析失真：

• 只导出成交记录。 资金费率是独立的数据流；漏掉它，成本基础就是错的。
• 把界面导出当成完整历史。 它只反映已加载的记录。
• 忽视 API 2,000 条的限制。 单次 userFills 调用会静默截断；必须用 userFillsByTime 分页。
• 忘记其他平台。 如果你在 AsterDEX 或其他基于 Hyperliquid 的平台交易，那些 PnL 在同一生态里，却显示在不同的仪表盘中。
• 现货与合约混在一起不标注。 大多数税务工具需要区分二者。

零导出替代方案：直接查一下

这里有一个诚实的问题：你真正需要的是文件，还是数字？如果目标是知道自己的真实 PnL——扣除手续费和资金费率后，按钱包、按平台——那么导出只是手段，而Hyperfolio 直接跳过了这一步。粘贴任意 Hyperliquid 地址，或连接你的钱包，明细立刻呈现：已实现 PnL、手续费、资金费率、持仓和聪明钱流向，全部来自导出工具所读取的同一份公开数据。

不用跟 CSV 较劲，不用写分页循环，不用等待第三方服务器。几秒钟出结果，完全免费，也无需创建账户——这正是它的意义。

常见问题（FAQ）

我可以把完整的 Hyperliquid 交易历史下载为 CSV 吗？

可以，但不是一键完成。App 只能导出已加载的记录；完整历史需要分页调用公共 API（userFillsByTime），或使用 trade-export.hypedexer.com 之类的第三方导出工具。

Hyperliquid 有获取交易历史的 API 吗？

有。向 https://api.hyperliquid.xyz/info 发送 POST 请求，使用 type: "userFills"（近期，最多 2,000 条）或 type: "userFillsByTime"（按时间窗口分页）。资金费率和转账分别使用 userFunding 和 userNonFundingLedgerUpdates。

Hyperliquid 的资金费率需要缴税吗？

在大多数司法管辖区，是的。收到的资金费率被视为收入，支付的资金费率则减少你的收益。报税时需将资金费率与成交记录分开申报——各国细节见Hyperliquid 税务指南。

Hyperliquid 的交易历史可以追溯多久？

Hyperliquid 在链上保存每个账户的完整历史。数据本身没有时间限制——限制只在于单次 API 调用返回的数量（2,000 条成交）和界面能加载的范围。

不导出的话，查看 Hyperliquid PnL 最简单的方式是什么？

使用只读追踪器：在 Hyperfolio 搜索任意钱包，即可即时查看已实现 PnL、手续费和资金费率明细——免费、无需注册、无需下载任何文件。

别再导出，开始了解

你的交易历史是公开的。你的 PnL 也应该是——至少对你自己。无论你是导出 CSV 交给会计，还是跳过整个过程，数据都只隔一个地址。现在免费试用追踪器：连接你的钱包，或搜索任意 Hyperliquid 地址，几秒钟内查看完整的 PnL 明细，无需注册，也无需管理任何导出文件。