Hyperliquid Builder Codes 详解：机器人、钱包和第三方前端的隐藏费用

简要说明：Builder code 让代你下单的应用（钱包、Telegram 机器人、第三方交易前端）在 Hyperliquid 手续费之外再收取自己的费用。你只需用主钱包批准一次最高费率，之后该应用可在每笔成交上收取不超过该费率的费用，协议上限为永续 0.1%、现货 1%。一切都在链上，你可以审计实际支付的金额并随时撤销授权。

什么是 Hyperliquid builder code？

在 Hyperliquid 文档中，“builder”指构建在交易所之上的 DeFi 应用，而不是区块构建者。Builder code 是这些应用的收费方式：应用代你提交的每个订单都可以带上 builder 参数，包含应用地址和费率。订单成交时，这笔费用按正常手续费逻辑向你收取并记入 builder，builder 像领取推荐奖励一样领取。

因此，同一笔 BTC 交易通过 Telegram 机器人或钱包内置永续页面下单，成本可能明显高于 app.hyperliquid.xyz。订单簿、价格和流动性完全相同，多出的成本就是 builder fee。

运作方式

1. 授权：首次使用应用时，它会请求你签署 ApproveBuilderFee，设定该 builder 可收取的最高费率。必须由主钱包签署，API/代理钱包不能签。
2. 下单：之后的订单可包含 {"b": builder地址, "f": 费率}，f 以十分之一基点为单位。f = 10 即 1 个基点（0.01%），f = 100 即 0.1%。
3. 收费：每笔成交时，builder fee 加在 Hyperliquid 正常手续费之上，不会超过你批准的上限和协议上限。
4. 撤销：你可以随时用主钱包修改或撤销授权。

需要了解的限制

规则	数值
永续最高 builder fee	名义价值的 0.1%（10 个基点）
现货最高 builder fee	1%（仅对以计价资产支付的一侧，现货买入不收）
永续收取时点	开仓和平仓成交都收
每个用户的有效授权	最多同时 10 个 builder
谁可以授权	仅主钱包，代理/API 钱包不行
Builder 要求	永续账户价值至少 100 USDC

示例：builder fee 的真实成本

假设你每天在永续上交易 50,000 USDC 名义价值，大多为吃单。Hyperliquid 第一档吃单费率为 0.045%（档位和折扣见我们的手续费指南）。

渠道	每笔费率	每日成本	30 天成本
直接在 Hyperliquid	0.045%	22.5 USDC	675 USDC
builder fee 0.02% 的应用	0.065%	32.5 USDC	975 USDC
builder fee 0.05% 的应用	0.095%	47.5 USDC	1,425 USDC
达到 0.1% 上限的应用	0.145%	72.5 USDC	2,175 USDC

在上限时，仅 builder fee 就超过交易所手续费的两倍。对活跃交易者而言，这个差额往往大于月度盈亏。以上数字仅作示例，实际成本取决于你的费率档位、挂单/吃单比例和 builder 的实际费率。

值得支付 builder fee 吗？

有时值得。好用的机器人、常用的移动端流程、跟单或高级订单工具可以值几个基点。要避免的是在不知情的情况下每笔都付 0.1%，尤其是高频交易、剥头皮或高杠杆大名义仓位。手续费按名义价值而非保证金计算：20 倍杠杆下，开平仓各 0.1% 的 builder fee 相当于每个来回 4% 的保证金。详见杠杆指南和真实盈亏指南。

如何查看已授权的 builder

这些都是公开链上数据，无需连接钱包或分享密钥即可查询。两个 info 接口即可：

• {"type": "approvedBuilders", "user": "0x..."} 返回你当前授权的 builder 地址。
• {"type": "maxBuilderFee", "user": "0x...", "builder": "0x..."} 返回你对某个 builder 批准的最高费率，单位为十分之一基点（100 = 0.1%）。

如何查看已支付的 builder fee

userFills 或 userFillsByTime 返回的每笔成交都有 fee 字段（总手续费，含 builder 部分）和可选的 builderFee 字段，仅在收取了 builder fee 时出现。把它加总即可得到准确成本。下面的 Python 脚本会输出近期总额、builder fee 最多的币种以及每个已授权 builder 的上限：

import requests
from collections import defaultdict

USER = "0xYourAddress"
URL = "https://api.hyperliquid.xyz/info"

fills = requests.post(URL, json={"type": "userFills", "user": USER}).json()
total_fee = sum(float(f["fee"]) for f in fills)
builder_fee = sum(float(f.get("builderFee", 0)) for f in fills)
by_coin = defaultdict(float)
for f in fills:
    by_coin[f["coin"]] += float(f.get("builderFee", 0))

print(f"Fills checked: {len(fills)}")
print(f"Total fees: {total_fee:.2f}  of which builder fees: {builder_fee:.2f}")
for coin, fee in sorted(by_coin.items(), key=lambda x: -x[1])[:10]:
    if fee:
        print(coin, round(fee, 2))

approved = requests.post(URL, json={"type": "approvedBuilders", "user": USER}).json()
for b in approved:
    mx = requests.post(URL, json={"type": "maxBuilderFee", "user": USER, "builder": b}).json()
    print(b, "max approved:", mx / 1000, "%")

userFills 返回最近的成交（最多 2,000 笔）；更长历史可用 userFillsByTime 按起止时间分页。刚接触 API 可先看Hyperliquid API Python 指南；需要逐笔含手续费的 CSV，见如何导出交易历史。

如何撤销或降低授权

用主钱包为该 builder 重新签署一个更低（或为零）的 ApproveBuilderFee 即可撤销。请在可信界面或官方 Python SDK 中操作。由于最多只能有 10 个有效授权，清理不再使用的应用是良好习惯，就像撤销旧的代理钱包一样（见API 钱包指南和钱包安全指南）。

Builder fee 与推荐码的区别

两者是不同机制。Builder fee 是路由你订单的应用额外收取的费用；推荐码则相反，为你减免 Hyperliquid 自身的手续费。推荐码 HYPERFOLIO 在前 2,500 万美元交易量内享 4% 手续费折扣，详见推荐码指南。

通过第三方应用交易前的检查清单

• 阅读授权请求：你签署的最高费率是多少？
• 按你的月交易量，比较应用总成本与直接在 Hyperliquid 交易的成本。
• 优先选择公开披露 builder 费率的应用。
• 前几笔交易后检查成交中的 builderFee，确认实际费率。
• 撤销不再使用的 builder。

用 Hyperfolio 追踪手续费和真实盈亏

Hyperfolio 是免费、只读的 Hyperliquid 投资组合追踪器。它从不要求你签署任何内容，因此没有 builder 授权，也不收 builder fee。粘贴任意地址即可在一处查看持仓、盈亏、手续费和资金费，比较钱包、关注聪明钱，并在下单前用永续计算器确定仓位。把它作为 PWA 安装到手机上，随时了解交易的真实成本。

常见问题

Builder code 会改变成交价格吗？

不会。订单仍进入同一个 Hyperliquid 订单簿，builder code 只在成交时增加费用。

应用能收取超过我批准的费用吗？

不能。协议强制执行你批准的上限以及永续 0.1%、现货 1% 的全局上限。

挂单也收 builder fee 吗？

对带有 builder 参数的订单，每笔成交都会收取，无论挂单还是吃单。费率由应用按订单设定，不超过你批准的上限。

代理钱包可以批准 builder fee 吗？

不可以。必须由主钱包签署，这样即使机器人密钥泄露也无法提高你的费率。

如何知道自己是否在支付 builder fee？

查看成交中的 builderFee 字段或运行上面的脚本。如果没有该字段，说明该笔成交没有收取 builder fee。