本页为简体中文译文。如有歧义，请以英文原文为准。 阅读英文版 →
跳转到主要内容

开通 Portfolio Margin

Portfolio Margin（PM）已在生产环境上线，向所有账户开放。它基于投资组合的最坏情况风险，对您的期权和 Hyperliquid 永续合约进行统一保证金计算，因此与 Standard Margin 相比，已对冲的头寸所需抵押品要少得多。本页介绍如何开通 PM。关于保证金本身的计算方式，请参阅 Portfolio Margin。

**简而言之：**使用一个新的管理钱包，创建其 Hypercall 账户，开启 HyperCore 统一账户模式，切换到 Portfolio 模式，然后再存入资金。

为什么要从新钱包开始​

有余额或有持仓的 Standard Margin（SM）账户无法原地切换为 Portfolio Margin。只有当管理钱包同时满足以下所有条件时，Hypercall 才接受切换到 Portfolio 模式：

要求含义
恰好一个 Hypercall 账户该管理钱包控制一个 Account 合约。没有账户或有多个账户均会被拒绝。
Standard 余额为零该钱包的 Standard Margin 现金余额为零。任何可提取余额都会阻止切换。
无持仓管理钱包及其 Account 上均无未平仓头寸，也无未成交订单。

之所以有这些规则，是因为这两种模式是不同类型的账户，而不是同一个账户上的一项设置：

  • **您的抵押品托管方式不同。**从 Standard 切换到 Portfolio Margin 意味着转移您的资金，而不是拨动一个开关。
  • **头寸按不同规则计算保证金。**未平仓头寸必须从一套规则重新按另一套规则计算保证金。
  • **因此切换必须从空账户开始。**系统不支持在一步之内安全地同时完成这两件事，所以账户必须先清空持仓和余额。

保证金模式按管理钱包设置，因此一个钱包无法同时运行两种模式。最简单的做法是为 PM 使用一个全新的管理钱包，这样您现有的 SM 账户在您设置期间可以继续报价。您也可以清空现有钱包（平掉所有头寸、撤销所有订单、提取全部 Standard 现金）后再切换，但在此期间无法继续运行该 SM 账户。

开始之前​

  • 一个新的管理钱包（由您控制的 EOA，最好使用硬件钱包或其他安全方式保管的密钥）。
  • 该钱包在 HyperEVM 上持有 HYPE，用于支付账户创建押金和 gas。
  • 您计划用作抵押品的 USDC。

设置步骤​

请按顺序执行。第 4 步必须在第 5 步之前完成。

  1. **创建新的管理钱包。**不要复用您的 SM 管理钱包、API 钱包或代理密钥。

  2. **创建您的 Hypercall 账户。**使用管理钱包调用 Factory 合约上的 createAccount(salt)，并附上 HYPE 创建押金。这会部署您的 Account 合约并在 HyperCore 上激活它。请参阅 开通（合约）。该管理钱包只能创建一个账户。

  3. **为 Account 开启 HyperCore 统一账户模式。**提交由管理钱包签名的 hl_set_abstraction 操作，将 user 设为您的 Account 地址，abstraction 设为 2（统一账户）。POST /v1/actions/hl_set_abstraction/typed-data 返回需要签名的确切类型化数据，POST /v1/actions/hl_set_abstraction 用于提交。等待 HyperCore 将该 Account 报告为 unifiedAccount。Hyperliquid 的其他账户模式，包括其自身的组合保证金模式，均不受支持。

  4. 切换到 Portfolio 模式。发送 POST /margin-mode，将 wallet 设为您的管理钱包地址，margin_mode 设为 portfolio，并由管理钱包签名（请参阅 身份验证）。响应会返回您的 Account 地址作为 PM 钱包。请在存入资金之前完成此步骤：当钱包仍处于 Standard 模式时，Hypercall 存款会被记为 Standard 现金，该余额会阻止切换，直到您再次将其提取。

  5. **向您的 Account 存入 USDC。**通过应用存款（应用会按保证金模式路由），或在 HyperCore 上将 USDC 发送到您的 Account 地址。当 Hypercall 下一次 HyperCore 快照显示这笔资金后，它们即计入保证金。

  6. **设置您的签名密钥。**旧 SM 钱包上的授权不会延续。

    • **期权（REST）：**使用 POST /approve-agent 为新的管理钱包授权您的交易密钥。请参阅 代理授权。
    • **永续合约（链上指令）：**使用由管理钱包签名的 hc_update_api_wallet 操作在您的 Account 上注册 API 钱包。一个 API 钱包只能在一个 Account 上处于激活状态。请参阅 EIP-712 签名。

  7. **开始交易。**在期权请求中继续将您的管理钱包地址作为 wallet 发送；Hypercall 会将其路由到您的 PM 账户。订单类型、订单 API 和签名方式与 Standard Margin 相同。如需通过应用交易 Hyperliquid 永续合约，请参阅 Hypercall 上的永续合约。

在应用中，于 Settings > Margin Mode 下选择 Portfolio 会自动为您执行第 2 至第 4 步：如果您还没有账户，它会创建账户，开启统一账户模式，并切换模式。

如果跳过统一账户模式

Hypercall 根据 PM 账户的 HyperCore 权益对其估值，而 HyperCore 只为处于统一账户模式的 Account 发布权益数据。如果 Account 未处于该模式，第 4 步会被拒绝，并返回 400 pm_account_not_unified。请完成第 3 步，等待 HyperCore 确认该模式后重试。

如果某个 Account 之后退出了统一账户模式，组合查询会返回 503 pm_account_equity_pending（如果 HyperCore 从未为其发布过权益数据，则返回 409 pm_account_not_unified），订单也会失败，并报出类似 missing HyperCore account equity for PM wallet 0x... 的错误。重新开启统一账户模式即可修复。请参阅 错误与拒绝原因。

常见问题​

我可以继续运行我的 Standard Margin 账户吗？ 可以。在新的管理钱包上开通 PM，保持您的 SM 账户不变即可。

为什么我的保证金模式切换被拒绝？ 错误信息会指明具体规则：该钱包没有 Account（或有多个）、有 Standard 余额、有未平仓头寸或未成交订单，或者 Account 尚未处于 HyperCore 统一账户模式（pm_account_not_unified）。请参阅 为什么要从新钱包开始。

我在切换前就存了款，现在怎么办？ 这笔存款已被记为 Standard 现金。请先将其提取，然后切换到 Portfolio 模式，再存入您的 Account。

我需要新的 API 密钥吗？ 您需要新的授权。期权代理授权与管理钱包绑定，因此请为新钱包重新授权您的密钥。一个永续合约 API 钱包只能在一个 Account 上处于激活状态，因此请使用新密钥，或先将其从旧 Account 中移除（第 6 步）。

在哪里了解 PM 保证金、强制平仓和结算的运作方式？ 请参阅 Portfolio Margin、PM 保证金计算示例、保证金下限、强制平仓 和 结算。

最后更新于