内部测试中:交易引擎未上线,控制台为演示数据,不会下单。以下产品说明为设计方案。
读一个地址,别只看一笔成交
先固定地址、时间范围和查看时刻。一笔漂亮的平仓记录,解释不了账户还承担着多少风险。
本页内容
先找对账户地址
- 复制要查看的主账户或子账户完整公开地址。API 钱包只是签名身份,用它查询可能得到空结果。
- 在官方 More 中打开 Explorer,粘贴地址并回车。核对结果页的完整地址,再逐条查看动作和时间。
- 查看自己已连接的账户时,Portfolio 把持仓、成交历史和资金费用分栏展示。Explorer 中出现下单动作,不能单凭这一点认定已经成交。
直接查询任意公开地址的成交
需要直接核对数据时,把下方 YOUR_ADDRESS 替换成完整地址,在终端运行。这是一条公开信息查询,不连接钱包,也不会下单。
curl --request POST https://api.hyperliquid.xyz/info --header 'Content-Type: application/json' --data '{"type": "userFills", "user": "YOUR_ADDRESS"}'
这条查询最多提供最近 2,000 笔成交。结果为空不能证明这个地址从未交易。按时段查询可参阅文末的 userFillsByTime,其可查询的历史也有范围限制。
把仍在承担的风险和成交分开
要把 HIP-3 一起查到,先查询 {"type": "perpDexs"},取每个非空条目的 name,作为 dex 加进各次 clearinghouseState 请求。相关 DEX 要逐个核对,第一个 DEX 返回空仓不能说明别处也没有仓位;账户余额还须结合账户模式解释。
- 未平仓风险
- 标准永续账户可用 clearinghouseState 查询 assetPositions:szi 是带正负号的数量,leverage 包含保证金模式和杠杆设置。不填 dex 时,只覆盖第一个永续 DEX。
- 已发生成交
- 成交记录要一起读 time、coin、dir、sz 和 px。每行保留成交编号,避免把重复导出的记录算成额外交易。
- 费用
- 同时核对 fee 与 feeToken。出现 builderFee 时,它已包含在 fee 中,再加一次就会重复计费。资金费用要另外查账。
资金费用和曲线各看什么
Hyperliquid 永续资金费用按小时在多空双方之间结算。查看与成交相同时间段的实际收付,不要拿眼前一刻的费率推算整个持仓过程。
查询任意公开地址的资金费时,把前面命令中 --data 后的 JSON 换成下面这份。算例时间为 UTC 2026 年 9 月 1 日零时至 9 月 2 日零时,请把两个毫秒时间戳改成自己的时段。核对 time、delta.coin 和带符号的 delta.usdc:正数为收入,负数为支出;合计不同 DEX 前先记录抵押资产。较大时段按文档分页读取。
{"type": "userFunding", "user": "YOUR_ADDRESS", "startTime": 1788220800000, "endTime": 1788307200000}
Portfolio 曲线采用采样记录,其中包含每十五分钟的采样。短暂回撤可能落在两个点之间;曲线适合先看轮廓,精确核账还要回到明细。
三种容易看偏的比较
- 单笔大额正向结果
- 在自己的分析副本里拿掉最大的一笔正向平仓结果,再看其余时间的情况。别把未平仓损失和费用藏到表格之外。
- 幸存者偏差
- 只收集仍被展示的成功地址,会漏掉失败或放弃的地址。展示出来的数字即使都正确,样本也可能不完整。
- 杠杆与出入金
- 把仓位名义与支撑它的资金一起看。$10,000 的风险敞口对 $1,000 资金是 10×,对 $5,000 则是 2×。余额的变化还混有转入和转出。
留一份最小核对记录
- 记录地址、账户模式、UTC 起止时间和数据来源。
- 写下最大的未平仓敞口、观察到的最深损失,以及哪段历史缺失。
- 成交、资金费用、出入金分别记;合并之前先核对每个字段的计算口径。
- 这些材料只能帮助描述已经发生的事,不能确定这个地址下一步会怎样,也不构成投资建议。
协议资料Hyperliquid:账户查询与成交Hyperliquid:永续账户字段Hyperliquid:资金费用Hyperliquid:账户曲线采样Hyperliquid:账户模式