资金费率数据既可以指合约发布的费率,也可以指某一账户记录的收支款项。这两者回答的是不同的问题。本走查基于 2026 年 9 月 27 日核对的 Hyperliquid 官方公开文档以及只读 BTC 历史查询。端点字段和交易场所规则可能会发生变动,且示例并不代表其他交易所。

根据具体需求选择相应的端点

Hyperliquid 记录了用于查询代币历史费率的 fundingHistory,以及用于查询关联至公开账户地址的资金费记录的 userFunding。前者有助于研究合约环境;后者则有助于对账账户记录的现金流。仅凭费率序列无法确定某个特定账户实际支付或收取了多少费用。

这两个请求均通过 JSON POST 发送至 https://api.hyperliquid.xyz/info. 若要获取某一 UTC 日的 BTC 费率,请求体可写为:

{
  "type": "fundingHistory",
  "coin": "BTC",
  "startTime": 1790208000000,
  "endTime": 1790294399999
}

这些毫秒时间戳限定了 UTC 时间 2026 年 9 月 24 日;文档明确说明开始与结束时间均为闭区间,因此最终值为该 UTC 日的最后一毫秒。代币标识符必须与所查询的市场一致。当前的 API 页面还显示某些市场的代币带有永续 DEX 命名空间标识符。Hyperliquid 的资金费率文档指出 HIP-3 永续合约使用不同的溢价公式,因此应核查具体合约的市场名称和资金费规则,而不能假定其适用原生永续合约的设置。

在 2026 年 9 月 27 日,该 BTC 时间窗口返回了 24 行数据。第一行的时间戳为 1790208000045,最后一行的时间戳为 1790290800038,均在所请求的 UTC 日之内,且间隔大约为一小时。响应摘录包含 coin: BTC、fundingRate: 0.0000125、一个溢价字段以及毫秒级的 time。这是针对单一市场和单一日期可复现的 API 观察结果,不能作为未来资金费率的证据、策略结果或通用的响应大小。

观察到的 Hyperliquid 资金费率历史分页,含一行重叠的边界记录2026 年 9 月 27 日核查的只读 BTC fundingHistory 观察:500 行的第一页结束于 9 月 21 日 19:00:00.031 UTC;从该时间戳继续查询返回 125 行,其中包含该边界记录;保留 625 行原始数据,并在验证重叠后使用 624 条按币种与时间戳去重后的观察值。满页即为继续拉取的信号第 1 页 · 500 行01 Sep → 21 Sep · 19:00:00.031 UTC第 2 页 · 125 行startTime = 第 1 页最后一个时间戳26 Sep · 23:00 UTC同一边界行保留原始数据 · 去重视图625 行原始数据 − 1 条经校验的边界重复 = 624 条唯一的币种-时间观测值 · 某日快照,并非永久保证
2026 年 9 月 27 日核查的只读 BTC fundingHistory 观察:500 行的第一页结束于 9 月 21 日 19:00:00.031 UTC;从该时间戳继续查询返回 125 行,其中包含该边界记录;保留 625 行原始数据,并在验证重叠后使用 624 条按币种与时间戳去重后的观察值。 教学说明图 · 非实时市场数据

对较长历史数据进行分页时避免丢失边界

Hyperliquid 的通用信息端点文档指出,时间范围查询的响应限制为 500 个元素或独立区块。对于更长的时间范围,它指导客户端使用最后返回的时间戳作为下一次请求的 startTime。这是该 API 明确记录的连续分页规则;请完整保留每一页的精确请求与响应,因为分页边界可能会被重复包含两次。

在 2026 年 9 月 1 日至 9 月 26 日期间进行的一项只读 BTC 查询中,首次请求返回了 500 行数据。其最后一行位于 2026-09-21T19:00:00.031Z。使用该行的时间戳毫秒数继续查询,又返回了 125 行数据,且起始于同一时间戳。在这两次响应中,625 行原始数据包含一个重复的 (coin, time) 边界以及 624 条唯一观察值;最后一条唯一记录位于 2026-09-26T23:00:00.010Z。在该样本中观察到的时间间隔约为每小时一次。此示例是于 9 月 27 日核对的 API 快照,并不代表对后续历史数据或其他市场的保证。

首先完整保存响应的原始字节,随后验证分页顺序、请求的代币、时间界限、行数以及实际重叠情况。如果相邻页面中出现了相同的市场和完全一致的时间戳,请在归档中保留两份原始副本,并在分析视图中对该确认的边界进行去重。请在键中包含市场标识符:来自不同合约的相同时间戳并不属于重复项。如果缺失了重叠部分、页面之间存在意外间隔,或者单页内部出现重复键,应立即暂停并排查原因,而不是默不作声地删除或填充数据行。请将获取时间戳和每个请求体随输出结果一同保存,以防日后的数据刷新覆盖原有证据。

官方文档说明了时间范围查询的最大响应数据量,但并未详述所有故障模式,也未提供永久的服务级别保障。在抓取大量页面时,请采用保守的请求频次,并严格遵循当前的限频规则页面。遇到达到上限的响应应当触发分页机制;但这并不意味着剩余时间范围内没有记录。

接受分页资金费率历史序列前的四项检查保留每一页原始数据,从返回的最后一个毫秒级时间戳继续,校验确切的交易市场与边界重叠,然后仅在分析副本中对已确认的同市场时间戳重复项去重。先保留。仅在校验后清洗。01 · 归档请求 + 原始页面02 · 继续最后一个时间戳03 · 比对市场 + 重叠04 · 分析对已确认的键值去重不匹配或有缺口?停止 · 检查原始页面只有当时间戳在同一市场且处于经校验的页面边界内重复出现时,才属于重复项
保留每一页原始数据,从返回的最后一个毫秒级时间戳继续,校验确切的交易市场与边界重叠,然后仅在分析副本中对已确认的同市场时间戳重复项去重。 教学说明图 · 非实时市场数据
研究前审计有界资金费率历史响应来源审计流程会记录确切的行情请求与获取时间,保留原始响应,然后在为序列打上研究标签之前检查 UTC 边界、频率、重复项与缺口。缺失的观测值保持未知状态,仅凭 API 返回成功并不能证明覆盖完整。从有据可查的查询到可审计的序列1 · 请求币种 · UTC 边界毫秒2 · 保留响应体 · 获取时间原始响应3 · 标准化UTC · 小数费率市场标识4 · 核查节奏 · 重复项边界 · 缺口5 · 标注已知 / 未知范围结论观测到的数据行仅对所请求的时间区间构成证据HTTP 请求成功并不证明数据完整 · 切勿用零填补缺失的小时每次开展新研究前,重新核对交易所 API 结构与资金费率规则
来源审计流程会记录确切的行情请求与获取时间,保留原始响应,然后在为序列打上研究标签之前检查 UTC 边界、频率、重复项与缺口。缺失的观测值保持未知状态,仅凭 API 返回成功并不能证明覆盖完整。 教学说明图 · 非实时市场数据

保持单位、频次与正负符号的一致性

该 API 在其示例中将数值作为字符串返回。应将其解析为十进制小数,切勿将诸如 0.0000125 之类的费率误转为 0.0000125%:乘以 100 之后,在所代表的周期内它实际上是 0.00125%。Hyperliquid 的资金费页面详细描述了其按小时结算机制、正费率方向以及特定于该交易所的计算公式。在发布附带日期的数值示例之前,请再次核对官方页面;切勿将单小时的观察值年化并将其作为未来预测展示。

仅就规模估算而言,在简化的线性计算下,名义价值为 $10,000 的仓位乘以假定的结算费率 0.0000125,在该时间段内的支付金额大小为 $0.125。究竟由哪一方支付取决于费率的正负符号和仓位方向。该交易场所文档记载的计算公式使用的是仓位大小和现货预言机价格;实际对账以真实账户记录和具体标的详情为准。本算术计算排除了价格变动、手续费以及所有其他账户事件。

在使用数据序列之前进行验证

完整归档精确的请求体、市场标识符、检索时间以及未经修改的原始响应。将每个毫秒时间戳转换为 UTC 并按时间排序。核验观察到的频次、所请求时间范围的预期行数、重复项、缺失间隔、异常代币名称、空值以及无法进行数值解析的条目。将首次和末次返回的时间与请求的界限进行对比。对于长跨度范围,请遵循上文所述的文档延续规则,仔细对比每个分页边界,并记录从任何去重分析表中排除的数据行。

缺失的观察值应保持为未知状态。切勿用零填充空白小时、顺延先前费率,或在未明确标注说明的情况下拼接最邻近记录。对于基于 K线 的测试,请明确结算时间戳处观察到的费率是适用于该时间戳之前还是之后,并使其与交易场所的资金费结算事件及仓位快照保持对齐。即使图表稍后显示本地时间,原始数据源的时间戳也务必以 UTC 存储。

市场资金费率与账户资金费记账是两类独立记录fundingHistory 接口返回指定币种、限定时间区间内的市场费率序列。userFunding 接口返回指定公开账户在某一时间区间内的资金费流水事件。费率可用于市场研究;而核对某账户实际发生的现金流,需要账户事件记录。切勿用其中一个来源替代另一个。同一交易所 · 不同数据集 · 不同问题市场费率 · fundingHistory币种 · fundingRate · premium · 时间问题:返回了哪段费率历史?适用于有界市场状况研究不能证明某一账户的支付账户流水 · userFundinguser · coin · szi · usdc · 时间问题:记录了哪个事件?适用于该账户的现金流核对地址可能暴露账户活动不可相互替代仅在时间、仓位、合约与交易所口径均明确时才可关联市场费率响应 ≠ 账户现金流证据
fundingHistory 接口返回指定币种、限定时间区间内的市场费率序列。userFunding 接口返回指定公开账户在某一时间区间内的资金费流水事件。费率可用于市场研究;而核对某账户实际发生的现金流,需要账户事件记录。切勿用其中一个来源替代另一个。 教学说明图 · 非实时市场数据

账户资金收支须单独对账

文档中记录的 userFunding 请求接收一个账户地址和以毫秒为单位的起始时间;结束时间为可选参数,默认为当前时间。其响应示例包含一个资金费差值,字段包括 coin、fundingRate、仓位大小、带正负符号的 USDC 金额以及事件发生时间。在确认任何金额已实现之前,请将这些事件记录与账户的持仓及交易所账本进行对比核实。切勿仅凭日期将公开的市场费率与账户支付记录进行关联,也不要假定每个账户在每次结算时都持有仓位。

尽管该历史查询请求并不需要私钥,但账户地址仍可能暴露交易活动。在没有明确理由和许可的情况下,切勿随意公开他人的地址或账户历史记录。切勿在只读信息查询中放入私钥、助记词或签名凭证。

SuperQuant 支持用户自行提供的资金费输入,并包含合成示例数据;它并不声称归档了完整且经独立验证的 Hyperliquid 历史数据。请使用资金费率解析、历史数据质量检查、手续费与资金费工作表以及永续合约资金费结算审计工作表,将各事件的具体交易所规则、原始费率与账户报告的支付记录整合在一起。该工作表属于记录辅助工具,并非与 Hyperliquid 的直连器,亦不能证明款项已完成结算。本文属于数据源走查,不构成投资建议或对任何交易场所的背书。