Trang này được dịch tự động. Bản gốc tiếng Anh là phiên bản chính thức. Đọc bằng tiếng Anh →
Chuyển đến nội dung chính

Bắt đầu sử dụng Portfolio Margin

Portfolio Margin (PM) đã hoạt động trên môi trường production và mở cho mọi tài khoản. PM tính ký quỹ chung cho quyền chọn và hợp đồng vĩnh viễn (perp) Hyperliquid của bạn dựa trên rủi ro danh mục trong kịch bản xấu nhất. Nhờ vậy, một danh mục đã phòng hộ cần ít tài sản đảm bảo hơn nhiều so với khi dùng Standard Margin. Trang này hướng dẫn cách chuyển sang PM. Để biết cách tính ký quỹ, vui lòng xem Portfolio Margin.

Tóm tắt: dùng một ví quản lý mới, tạo tài khoản Hypercall cho ví đó, bật chế độ unified account của HyperCore, chuyển sang chế độ Portfolio, và chỉ nạp tiền sau cùng.

Vì sao bạn bắt đầu từ một ví mới​

Một tài khoản Standard Margin (SM) còn số dư hoặc còn vị thế, lệnh đang mở thì không thể chuyển trực tiếp sang Portfolio Margin. Hypercall chỉ chấp nhận việc chuyển sang chế độ Portfolio khi ví quản lý đáp ứng tất cả các điều kiện sau:

Yêu cầuÝ nghĩa
Đúng một tài khoản HypercallVí quản lý kiểm soát đúng một hợp đồng Account. Không có tài khoản nào, hoặc có nhiều hơn một, đều bị từ chối.
Số dư Standard bằng 0Số dư tiền mặt Standard Margin của ví bằng 0. Bất kỳ số dư nào có thể rút được đều chặn việc chuyển đổi.
Không còn vị thếKhông có vị thế mở và không có lệnh đang mở, trên cả ví quản lý lẫn Account của ví.

Các quy tắc này tồn tại vì hai chế độ là hai loại tài khoản khác nhau, chứ không phải một tài khoản với một tùy chọn cài đặt:

  • Tài sản đảm bảo của bạn được lưu giữ theo cách khác nhau. Chuyển từ Standard sang Portfolio Margin nghĩa là di chuyển tiền của bạn, chứ không phải bật một công tắc.
  • Vị thế được tính ký quỹ theo các quy tắc khác nhau. Một vị thế đang mở sẽ phải được tính lại ký quỹ từ bộ quy tắc này sang bộ quy tắc kia.
  • Vì vậy, việc chuyển đổi diễn ra từ một tài khoản trống. Hệ thống không hỗ trợ thực hiện an toàn cả hai việc trong một bước, đó là lý do tài khoản phải không còn vị thế và trống trước.

Chế độ ký quỹ được đặt theo từng ví quản lý, nên một ví không thể chạy cả hai chế độ. Cách đơn giản nhất là dùng một ví quản lý mới cho PM, giúp tài khoản SM hiện tại của bạn vẫn tiếp tục báo giá trong khi bạn thiết lập. Bạn cũng có thể làm trống ví hiện tại (đóng mọi vị thế, hủy mọi lệnh, rút toàn bộ tiền mặt Standard) rồi chuyển đổi, nhưng bạn sẽ không thể duy trì danh mục SM đó trong thời gian này.

Trước khi bắt đầu​

  • Một ví quản lý mới (một EOA do bạn kiểm soát, tốt nhất là dùng ví cứng hoặc khóa được bảo mật bằng cách khác).
  • HYPE trên HyperEVM trong ví đó, dùng cho khoản tiền gửi tạo tài khoản cộng với phí gas.
  • Lượng USDC bạn dự định dùng làm tài sản đảm bảo.

Các bước thiết lập​

Vui lòng thực hiện theo đúng thứ tự. Bước 4 phải được thực hiện trước bước 5.

  1. Tạo một ví quản lý mới. Không dùng lại ví quản lý SM, ví API hoặc khóa agent của bạn.

  2. Tạo tài khoản Hypercall. Từ ví quản lý, gọi createAccount(salt) trên hợp đồng Factory kèm khoản tiền gửi HYPE để tạo tài khoản. Thao tác này triển khai hợp đồng Account của bạn và kích hoạt nó trên HyperCore. Xem Onboarding (hợp đồng). Chỉ tạo một tài khoản cho ví quản lý này.

  3. Bật chế độ unified account của HyperCore cho Account. Gửi action hl_set_abstraction, được ký bởi ví quản lý, với user là địa chỉ Account của bạn và abstraction là 2 (unified account). POST /v1/actions/hl_set_abstraction/typed-data trả về chính xác typed data cần ký, và POST /v1/actions/hl_set_abstraction dùng để gửi nó. Chờ đến khi HyperCore báo cáo Account ở trạng thái unifiedAccount. Các chế độ tài khoản khác của Hyperliquid, bao gồm cả chế độ portfolio margin riêng của Hyperliquid, không được hỗ trợ.

  4. Chuyển sang chế độ Portfolio. Gửi POST /margin-mode với wallet là địa chỉ ví quản lý và margin_mode là portfolio, được ký bởi ví quản lý (xem Xác thực). Phản hồi trả về địa chỉ Account của bạn làm ví PM. Hãy thực hiện bước này trước khi nạp tiền: khi ví vẫn ở chế độ Standard, khoản nạp vào Hypercall sẽ được ghi có thành tiền mặt Standard, và số dư đó sẽ chặn việc chuyển đổi cho đến khi bạn rút ra.

  5. Nạp USDC vào Account. Nạp qua ứng dụng (ứng dụng tự định tuyến theo chế độ ký quỹ), hoặc gửi USDC trên HyperCore đến địa chỉ Account của bạn. Số tiền sẽ được tính vào ký quỹ khi snapshot HyperCore tiếp theo của Hypercall ghi nhận chúng.

  6. Thiết lập khóa ký. Các phê duyệt trên ví SM cũ của bạn không được chuyển sang.

    • Quyền chọn (REST): phê duyệt khóa giao dịch của bạn cho ví quản lý mới bằng POST /approve-agent. Xem Ủy quyền Agent.
    • Perp (directive on-chain): đăng ký một ví API trên Account của bạn bằng action hc_update_api_wallet do ví quản lý ký. Một ví API chỉ có thể hoạt động trên một Account. Xem Ký EIP-712.

  7. Giao dịch. Tiếp tục gửi địa chỉ ví quản lý làm wallet trong các yêu cầu quyền chọn; Hypercall sẽ định tuyến chúng đến tài khoản PM của bạn. Các loại lệnh, API đặt lệnh và cách ký giống như trên Standard Margin. Để giao dịch perp Hyperliquid từ ứng dụng, xem Perp trên Hypercall.

Trong ứng dụng, chọn Portfolio tại Settings > Margin Mode sẽ tự động thực hiện các bước 2 đến 4: tạo tài khoản nếu bạn chưa có, bật chế độ unified account và chuyển chế độ.

Nếu bạn bỏ qua chế độ unified account

Hypercall định giá tài khoản PM dựa trên vốn chủ sở hữu HyperCore, và HyperCore chỉ công bố giá trị này cho các Account ở chế độ unified account. Nếu Account không ở chế độ đó, bước 4 sẽ bị từ chối với 400 pm_account_not_unified. Hãy hoàn tất bước 3, chờ HyperCore xác nhận chế độ, rồi thử lại.

Nếu sau đó Account rời khỏi chế độ unified account, các truy vấn danh mục sẽ trả về 503 pm_account_equity_pending (hoặc 409 pm_account_not_unified nếu HyperCore chưa từng công bố vốn chủ sở hữu cho Account đó), và lệnh sẽ thất bại với lỗi như missing HyperCore account equity for PM wallet 0x.... Bật lại chế độ unified account để khắc phục. Xem Lỗi & Lý do từ chối.

Câu hỏi thường gặp​

Tôi có thể tiếp tục duy trì tài khoản Standard Margin không? Có. Hãy thiết lập PM trên một ví quản lý mới và giữ nguyên tài khoản SM của bạn.

Vì sao yêu cầu chuyển chế độ ký quỹ của tôi bị từ chối? Thông báo lỗi sẽ nêu rõ quy tắc bị vi phạm: ví không có Account (hoặc có nhiều hơn một), ví còn số dư Standard, ví còn vị thế hoặc lệnh đang mở, hoặc Account chưa ở chế độ unified account của HyperCore (pm_account_not_unified). Xem Vì sao bạn bắt đầu từ một ví mới.

Tôi đã nạp tiền trước khi chuyển đổi. Giờ phải làm gì? Khoản nạp đã được ghi có thành tiền mặt Standard. Hãy rút số tiền đó, sau đó chuyển sang chế độ Portfolio và nạp vào Account của bạn.

Tôi có cần khóa API mới không? Bạn cần các phê duyệt mới. Phê duyệt agent cho quyền chọn gắn với ví quản lý, nên hãy phê duyệt lại khóa của bạn cho ví mới. Một ví API perp chỉ có thể hoạt động trên một Account, nên hãy dùng khóa mới hoặc gỡ khóa đó khỏi Account cũ trước (bước 6).

Tôi có thể tìm hiểu cách hoạt động của ký quỹ, thanh lý và thanh toán trong PM ở đâu? Xem Portfolio Margin, Ví dụ tính ký quỹ PM, Ngưỡng ký quỹ tối thiểu, Thanh lý và Thanh toán.

Cập nhật lần cuối vào