Helmsman

Hyperliquid API 钱包:Agent 密钥能做什么、不能做什么

API 钱包的作用,是让软件替你交易 Hyperliquid 账户,而不必把你的钱包交出去。Hyperliquid 也把它叫作 Agent;在 Helmsman 里,它叫交易密钥。

内部测试中:交易引擎尚未上线。目前能打开的控制台显示的是示例数据,不会发生任何交易。这些页面描述的是 Helmsman 被设计成怎样工作。

它是什么

一对独立的密钥,由你的主钱包用一次链下签名批准,不花 gas。此后,用这把密钥签署的订单就会被当作你本人的订单接受。

能做什么、不能做什么

可以

下单与撤单,修改杠杆与保证金模式,向逐仓仓位划转保证金。

不能

提现、转账、批准另一个 API 钱包、批准 builder fee。这些都必须由你的主钱包来做。

有效期与数量

批准时可以设定最长 180 天的有效期。到期之后,它的所有操作都会失败,直到你批准一把新的。

一个账户可以有 1 个未命名的 API 钱包和最多 3 个命名的。如果名额已经被别的应用占满,先到 app.hyperliquid.xyz → More → API 移除一个,再批准新的。

怎么撤销

在同一个 API 页面上把它移除即可,持有它的应用会立刻失去权限。规范的应用每次授权都会生成一把全新的密钥,绝不复用旧地址。

需要留意的

  • API 钱包提不走资金,但可以通过交易把它亏掉。权限是全有或全无的:不存在“只能撤单”的密钥。
  • 任何正规应用在设置 API 钱包时,都不需要你主钱包的私钥或助记词。
  • 签名请求里显示的域名,要和你正在访问的网站一致。