Thanh lý

Thanh lý bảo vệ hệ thống khỏi những tài khoản không còn đáp ứng được nghĩa vụ ký quỹ. Khi vốn chủ sở hữu (equity) của một tài khoản giảm xuống dưới yêu cầu ký quỹ duy trì, Hypercall trước hết sẽ cố gắng khôi phục tài khoản bằng cách đóng các quyền chọn short. Nếu cách này không hiệu quả kịp thời, tài khoản sẽ chuyển sang thanh lý toàn phần.

Điều kiện kích hoạt

Thanh lý được kích hoạt khi một tài khoản bị thâm hụt (underwater):

Ký quỹ danh mục (Portfolio Margin):

$$\text{Vốn chủ sở hữu} < \text{Ký quỹ duy trì yêu cầu}$$

Ký quỹ tiêu chuẩn (Standard Margin):

$$\text{Tiền mặt} < \text{MM yêu cầu}$$

Thanh lý SM được quyết định bởi khoảng dư ký quỹ duy trì tính theo tiền mặt (cash - mm_required), không phải theo equity, vì vậy giá đánh dấu của các quyền chọn long làm tăng NAV cũng không ngăn được tình trạng thiếu hụt tiền mặt. Trường API maintenance_margin = equity - mm_required vẫn được báo cáo nhưng không phải là điều kiện kích hoạt thanh lý SM. Xem Ký quỹ tiêu chuẩn.

Với tài khoản ký quỹ danh mục, equity được tính sau khi trừ mọi khoản nợ đối với quỹ cho vay PM, và yêu cầu ký quỹ duy trì cũng tính đến việc Hyperliquid tự thanh lý các vị thế perp của bạn trên HyperCore. Hyperliquid vẫn có thể thanh lý các perp đó theo quy tắc riêng của mình, độc lập với Hypercall. Xem Ký quỹ danh mục.

Hypercall kiểm tra tình trạng của mọi tài khoản có vị thế sau mỗi 5 giây.

Các trạng thái

Trạng thái	Điều gì đang diễn ra	Lệnh
Healthy	PM: equity bằng hoặc cao hơn MM yêu cầu. SM: tiền mặt bằng hoặc cao hơn MM yêu cầu.	Cho phép mọi lệnh
PreLiquidation	Thanh lý một phần: Hypercall đặt lệnh đóng các quyền chọn short của tài khoản	Chỉ các lệnh giảm vị thế hiện có
InLiquidation	Thanh lý toàn phần. Ký quỹ tiêu chuẩn: sổ vị thế của tài khoản được chào cho một bên thanh lý	Chỉ các lệnh giảm vị thế hiện có
Liquidated	Một bên thanh lý đã tiếp quản sổ vị thế của tài khoản	Chỉ các lệnh giảm vị thế hiện có

Rút tiền và quét tiền mặt PM bị vô hiệu hóa trong trạng thái PreLiquidation và InLiquidation. Khi một tài khoản PM đang bị rút cạn để thanh lý toàn phần, mọi lệnh của tài khoản đó đều bị chặn.

Chuyển đổi trạng thái

1. Healthy sang PreLiquidation: tài khoản giảm xuống dưới ngưỡng MM.
2. PreLiquidation sang Healthy: tài khoản đạt mục tiêu có vùng đệm, MM yêu cầu × 1,05, và không còn lệnh thanh lý nào đang mở. Ranh giới được tính bao gồm.
3. PreLiquidation sang InLiquidation: tài khoản vẫn dưới mục tiêu và một trong các điều kiện chuyển cấp bên dưới được đáp ứng.
4. InLiquidation sang Healthy: tài khoản phục hồi trước khi bên thanh lý tiếp quản, và quá trình thanh lý toàn phần bị dừng.
5. InLiquidation sang Liquidated: một bên thanh lý tiếp quản tài khoản.

Thanh lý một phần

Khi một tài khoản vào trạng thái PreLiquidation:

1. Các lệnh làm tăng rủi ro bị từ chối ngay lập tức. Các lệnh giảm vị thế hiện có vẫn được chấp nhận.
2. Hypercall hủy các lệnh đang mở làm tăng rủi ro của bạn và đặt lệnh mua chỉ giảm vị thế (reduce-only) trên các quyền chọn short của bạn, với khối lượng đủ để đưa tài khoản trở lại MM yêu cầu × 1,05. Hệ thống đóng trước các vị thế short giải phóng nhiều ký quỹ nhất trên mỗi hợp đồng.
3. Mỗi lệnh được định giá bằng giá bán tốt nhất (hoặc giá giữa, hoặc giá mua, nếu không có giá bán) cộng thêm một khoản thưởng thanh lý. Khoản thưởng bắt đầu từ 0,5% và tăng tuyến tính lên 10% trong 5 phút. Lệnh được định giá lại sau mỗi 5 giây.
4. Ngay khi tài khoản trở lại bằng hoặc cao hơn mục tiêu và các lệnh thanh lý không còn, tài khoản trở về trạng thái Healthy.

Khoản thưởng là chi phí của bạn: đó là số tiền bạn trả cao hơn giá thị trường để các vị thế short được đóng nhanh chóng.

Hãy tận dụng khoảng thời gian này để tự khắc phục tài khoản:

• Nạp thêm tài sản thế chấp
• Đóng vị thế, đặc biệt là các quyền chọn short
• Hủy các lệnh làm tăng rủi ro

Chuyển sang thanh lý toàn phần

Một tài khoản ở trạng thái PreLiquidation vẫn dưới mục tiêu sẽ chuyển sang thanh lý toàn phần khi bất kỳ điều kiện nào sau đây đúng:

• Equity âm.
• Không còn quyền chọn short nào để thanh lý một phần đóng.
• Hết hạn chót chuyển cấp. Hạn chót là 20 phút sau khi tài khoản vào trạng thái PreLiquidation.

Khoảng thời gian 20 phút cũng có nghĩa là một giá đánh dấu xấu trong chốc lát sẽ không đẩy tài khoản thẳng vào thanh lý toàn phần.

Thanh lý toàn phần

Với tài khoản ký quỹ tiêu chuẩn, thanh lý toàn phần chuyển sổ vị thế của tài khoản cho một bên thanh lý bên trong engine của Hypercall. Hypercall trước hết hủy mọi lệnh đang mở của tài khoản, sau đó chào bán tài khoản.

• Bên thanh lý phải đưa tài khoản trở lại MM yêu cầu × 1,05, do đó họ bỏ ra phần ký quỹ mà tài khoản đang thiếu.
• Nếu tài khoản vẫn còn equity dương, bên thanh lý trả phần equity đó cho bạn.
• Bên thanh lý nhận toàn bộ vị thế và tiền mặt của tài khoản.

Nếu tài khoản phục hồi trước khi bên thanh lý tiếp quản, quá trình thanh lý toàn phần bị dừng và tài khoản trở về trạng thái Healthy.

Với tài khoản ký quỹ danh mục, thanh lý một phần ở trên là bước bạn cần lên kế hoạch. Khi một tài khoản PM chuyển cấp, các lệnh đang mở của tài khoản bị hủy và các lệnh bị chặn trong lúc tài khoản được xử lý; trang này sẽ mô tả phần còn lại của bước đó khi được hoàn thiện.

Khoản lỗ vượt quá equity

Khoản lỗ vượt quá equity của một tài khoản không bao giờ được bù đắp bằng cách đóng vị thế của trader khác; Hypercall không có auto-deleveraging. Ai gánh khoản lỗ tùy thuộc vào chế độ ký quỹ.

Ký quỹ tiêu chuẩn. Bên thanh lý nhận lại vị thế và tiền mặt của tài khoản theo đúng hiện trạng, kể cả phần thâm hụt. Khoản thiếu hụt do equity âm thuộc về bên thanh lý.

Ký quỹ danh mục. Khoản tài khoản vẫn còn nợ sau thanh lý (khoản vay từ pool và khoản thanh toán chưa trả) được xử lý theo một thứ tự cố định:

1. Tài sản thế chấp của người vay. Hypercall thu từ tài sản thế chấp trên HyperCore của tài khoản. Xem thu hồi. Khoản vay chỉ bị xóa sổ sau khi việc thu hồi đã cạn.
2. Quỹ dự phòng chịu lỗ đầu tiên. Quỹ trước tiên trả cho các tài khoản mà người vay vẫn còn nợ tiền thanh toán, bắt đầu từ lô cũ nhất, sau đó bù cho khoản vay bị xóa sổ.
3. Người cho vay của pool. Phần quỹ dự phòng không bù được sẽ làm giảm giá cổ phần của pool.

Khoản nợ không được xóa. Mọi khoản thu hồi sau này từ người vay trước hết trả cho các đối tác settlement còn bị nợ, bắt đầu từ lô cũ nhất, sau đó trả khoản vay pool còn tồn; chỉ phần còn lại mới về quỹ dự trữ và người cho vay, theo tỷ lệ khoản lỗ của mỗi bên. Quỹ dự trữ chịu lỗ đầu tiên chỉ bảo đảm cho các khoản vay PM; không có quỹ bảo hiểm chung cho toàn sàn.

Các endpoint API

Lấy trạng thái thanh lý

GET /liquidation/status?wallet=0x...

data là null đối với tài khoản chưa từng rời khỏi trạng thái Healthy.

Phản hồi:

{
  "success": true,
  "data": {
    "wallet": "0x...",
    "state": "pre_liquidation",
    "liquidation_mode": "partial",
    "margin_mode": "portfolio",
    "equity": "4500.00",
    "mm_required": "5000.00",
    "maintenance_margin": "-500.00",
    "shortfall": "500.00",
    "partial_liquidation": {
      "entered_at": 1737312000000,
      "target_equity": "5250.00",
      "mm_shortfall": "500.00",
      "escalation_deadline": 1737313200000,
      "bonus_bps": 50
    },
    "full_liquidation": null
  }
}

partial_liquidation cũng liệt kê ID của các lệnh thanh lý đang mở. full_liquidation chứa thông tin chi tiết về việc tiếp quản, bao gồm margin_needed, winner và giá đặt mua yêu cầu hiện tại.

Lấy lịch sử thanh lý

GET /liquidation/history?wallet=0x...&limit=20

Trả về lịch sử chuyển đổi trạng thái của một tài khoản.

Lấy lịch sử thanh lý công khai

GET /liquidations?limit=50

Trả về lịch sử chuyển đổi trạng thái thanh lý trên tất cả các ví, mới nhất trước. Endpoint này công khai và dùng phân trang theo cursor dành cho bot thanh lý và công cụ giám sát.

Tham số truy vấn

• cursor: Cursor dạng mờ (opaque) được trả về từ trang trước.
• limit: Kích thước trang, mặc định 50, tối đa 100.
• wallet: Bộ lọc ví tùy chọn.
• status hoặc state: Bộ lọc trạng thái chuyển đổi thanh lý tùy chọn. Giá trị được chấp nhận là healthy, pre_liquidation, in_liquidation và liquidated.
• margin_mode: Bộ lọc chế độ ký quỹ tùy chọn. Giá trị được chấp nhận là standard và portfolio.
• liquidation_mode: Bộ lọc chế độ thanh lý tùy chọn. Giá trị được chấp nhận là partial và full.

Phản hồi: PublicLiquidationsResponse với các mục chuyển đổi trạng thái thanh lý và page.next_cursor cho yêu cầu tiếp theo.

Lấy chi tiết phiên đấu giá

GET /liquidation/auction/{auction_id}

Trả về trạng thái, các vị thế và chi tiết thanh toán của đợt thanh lý toàn phần.

Thông báo WebSocket

Các thay đổi trạng thái thanh lý được phát trên kênh liquidation:

{
  "type": "LiquidationStateChange",
  "wallet_address": "0x...",
  "previous_state": "healthy",
  "new_state": "pre_liquidation",
  "liquidation_mode": "partial",
  "margin_mode": "portfolio",
  "equity": "4500.00",
  "mm_required": "5000.00",
  "maintenance_margin": "-500.00",
  "shortfall": "500.00",
  "partial_liquidation": { "escalation_deadline": 1737313200000, "bonus_bps": 50 },
  "full_liquidation": null,
  "timestamp": 1737312000000
}

partial_liquidation và full_liquidation chứa các trường giống như endpoint trạng thái. Hãy đăng ký để nhận cập nhật theo thời gian thực cho ví của bạn.

Tham số

Tham số	Giá trị	Mô tả
Chu kỳ kiểm tra tình trạng	5 giây	Tần suất kiểm tra tình trạng tài khoản
Mục tiêu phục hồi	MM yêu cầu × 1,05	Equity (PM) hoặc tiền mặt (SM) cần có để trở về Healthy, và là mức mà thanh lý toàn phần khôi phục
Mức thiếu hụt tối thiểu	0	Bất kỳ mức thiếu hụt nào cũng bắt đầu thanh lý một phần
Khoản thưởng thanh lý	0,5% tăng lên 10% trong 5 phút	Mức cộng thêm so với giá tham chiếu trên các lệnh thanh lý một phần
Chu kỳ định giá lại	5 giây	Tần suất định giá lại các lệnh thanh lý một phần
Hạn chót chuyển cấp	20 phút	Thời gian ở trạng thái PreLiquidation trước khi thanh lý toàn phần bắt đầu

Thực hành tốt nhất

Dành cho nhà giao dịch

1. Theo dõi tỷ lệ ký quỹ: Giữ equity cao hơn nhiều so với MM (khuyến nghị vùng đệm 2x)
2. Đặt cảnh báo: Dùng WebSocket để phát hiện sớm trạng thái tiền thanh lý
3. Chuẩn bị sẵn vốn dự phòng: Giữ sẵn tài sản thế chấp dư để nạp khi cần
4. Tự đóng các vị thế short: Bạn không phải trả khoản thưởng thanh lý cho các lệnh do chính bạn đặt

Truy vấn tình trạng tài khoản

Thường xuyên kiểm tra trạng thái ký quỹ của bạn:

curl "https://api.hypercall.xyz/portfolio?wallet=0x..."

# Look for:
# - span_margin.equity vs span_margin.maintenance_margin_required (portfolio)
# - margin_summary.standard_margin.maintenance_margin_headroom (standard)

---

Xem thêm:

• Ký quỹ danh mục: cách tính MM cho tài khoản ký quỹ danh mục
• Ký quỹ tiêu chuẩn: cách tính MM cho tài khoản ký quỹ tiêu chuẩn
• Sàn ký quỹ: các mức sàn an toàn ảnh hưởng đến ngưỡng thanh lý
• Tài trợ PM: cách thu hồi nợ PM
• Tham số rủi ro PM: tỷ lệ MM và mọi thiết lập PM khác đang có hiệu lực
• Mô phỏng rủi ro PM: kiểm tra khoảng dư MM trên một danh mục giả định