청산

청산은 증거금 의무를 더 이상 충족할 수 없는 계정으로부터 시스템을 보호합니다. 계정의 자기자본이 유지증거금 요건 아래로 떨어지면 Hypercall은 먼저 숏 옵션을 정리해 계정을 회복시키려고 시도합니다. 정해진 시간 안에 회복되지 않으면 계정은 전체 청산으로 넘어갑니다.

발동 조건

계정이 언더워터 상태가 되면 청산이 발동됩니다.

포트폴리오 증거금:

$$\text{자기자본} < \text{필요 유지증거금}$$

표준 증거금:

$$\text{현금} < \text{필요 MM}$$

SM 청산은 자기자본이 아니라 현금 기준 유지증거금 여유분(cash - mm_required)으로 판단합니다. 따라서 롱 옵션의 평가가격이 올라 NAV가 늘어나도 현금 부족은 해소되지 않습니다. API 필드 maintenance_margin = equity - mm_required는 계속 제공되지만 SM 청산 발동 기준은 아닙니다. 표준 증거금을 참고하십시오.

포트폴리오 증거금 계정의 경우 자기자본은 PM 대출 풀에 대한 채무를 차감한 금액이며, 유지증거금 요건에는 HyperCore 상의 퍼프에 대해 Hyperliquid가 자체적으로 수행하는 청산도 반영됩니다. Hyperliquid는 Hypercall과 별개로 자체 규칙에 따라 해당 퍼프를 청산할 수 있습니다. 포트폴리오 증거금을 참고하십시오.

Hypercall은 포지션을 보유한 모든 계정의 건전성을 5초마다 점검합니다.

상태

상태	진행 내용	주문
Healthy	PM: 자기자본이 필요 MM 이상. SM: 현금이 필요 MM 이상.	모든 주문 허용
PreLiquidation	부분 청산: Hypercall이 계정의 숏 옵션에 대해 포지션 정리 주문을 냅니다	기존 포지션을 줄이는 주문만 허용
InLiquidation	전체 청산. 표준 증거금: 계정의 포지션 북이 청산인에게 제시됩니다	기존 포지션을 줄이는 주문만 허용
Liquidated	청산인이 계정의 포지션 북을 인수했습니다	기존 포지션을 줄이는 주문만 허용

PreLiquidation과 InLiquidation 상태에서는 출금과 PM 현금 스윕이 비활성화됩니다. PM 계정이 전체 청산을 위해 정리되기 시작하면 해당 계정의 모든 주문이 차단됩니다.

상태 전환

1. Healthy에서 PreLiquidation으로: 계정이 MM 기준 아래로 떨어집니다.
2. PreLiquidation에서 Healthy로: 계정이 버퍼가 적용된 목표치인 필요 MM × 1.05에 도달하고, 미체결 청산 주문이 하나도 남아 있지 않은 경우입니다. 경계값을 포함합니다.
3. PreLiquidation에서 InLiquidation으로: 계정이 여전히 목표치 미만이고 아래의 전환 조건 중 하나를 충족하는 경우입니다.
4. InLiquidation에서 Healthy로: 청산인이 인수하기 전에 계정이 회복되어 전체 청산이 중단되는 경우입니다.
5. InLiquidation에서 Liquidated로: 청산인이 계정을 인수합니다.

부분 청산

계정이 PreLiquidation 상태에 들어가면 다음이 진행됩니다.

1. 리스크를 늘리는 주문은 즉시 거부됩니다. 기존 포지션을 줄이는 주문은 계속 접수됩니다.
2. Hypercall은 리스크를 늘리는 미체결 주문을 취소하고, 계정을 필요 MM × 1.05 수준으로 되돌리는 데 필요한 수량만큼 숏 옵션에 대한 reduce-only 매수 주문을 냅니다. 계약당 해제되는 증거금이 가장 큰 숏부터 먼저 정리합니다.
3. 각 주문 가격은 최우선 매도호가(매도호가가 없으면 중간가 또는 매수호가)에 청산 보너스를 더한 값입니다. 보너스는 0.5% 에서 시작해 5분에 걸쳐 10% 까지 선형으로 증가합니다. 주문 가격은 5초마다 재조정됩니다.
4. 계정이 목표치 이상으로 회복되고 청산 주문이 모두 사라지면 즉시 Healthy 상태로 돌아갑니다.

보너스는 사용자가 부담하는 비용입니다. 숏 포지션을 빠르게 정리하기 위해 시장가보다 더 지불하는 금액입니다.

이 기간을 활용해 직접 계정을 정상화하십시오.

• 담보 입금
• 포지션 정리, 특히 숏 옵션
• 리스크를 늘리는 주문 취소

전체 청산으로의 전환

PreLiquidation 상태에서 여전히 목표치 미만인 계정은 다음 중 하나라도 해당하면 전체 청산으로 넘어갑니다.

• 자기자본이 음수인 경우.
• 부분 청산으로 정리할 숏 옵션이 더 이상 없는 경우.
• 전환 기한이 지난 경우. 기한은 계정이 PreLiquidation에 진입한 후 20분입니다.

20분의 유예 시간 덕분에 일시적인 잘못된 평가가격 때문에 계정이 곧바로 전체 청산으로 넘어가는 일도 방지됩니다.

전체 청산

표준 증거금 계정의 경우 전체 청산은 계정의 포지션 북을 Hypercall 엔진 내부의 청산인에게 넘기는 방식으로 진행됩니다. Hypercall은 먼저 계정의 모든 미체결 주문을 취소한 다음 계정을 제시합니다.

• 청산인은 계정을 필요 MM × 1.05 수준으로 되돌려야 하므로, 계정에 부족한 증거금을 직접 투입합니다.
• 계정에 아직 양(+)의 자기자본이 남아 있다면 청산인이 그 금액을 사용자에게 지급합니다.
• 청산인은 모든 포지션과 계정의 현금을 인수합니다.

청산인이 인수하기 전에 계정이 회복되면 전체 청산은 중단되고 계정은 Healthy 상태로 돌아갑니다.

포트폴리오 증거금 계정의 경우 대비해야 할 단계는 위의 부분 청산입니다. PM 계정이 전체 청산으로 넘어가면 미체결 주문이 취소되고 처리되는 동안 주문이 차단됩니다. 이 단계의 나머지 내용은 확정되는 대로 이 페이지에 추가할 예정입니다.

자기자본을 초과하는 손실

자기자본을 초과하는 손실은 다른 트레이더의 포지션을 청산해서 메우지 않습니다. Hypercall에는 자동 디레버리징이 없습니다. 누가 손실을 흡수하는지는 증거금 모드에 따라 다릅니다.

표준 증거금. 청산인은 계정의 포지션과 현금을 부족분까지 포함해 그대로 인수합니다. 음(-)의 자기자본으로 인한 부족분은 청산인이 떠안습니다.

포트폴리오 증거금. 청산 후에도 계정에 남은 채무(풀 대출과 미지급 결제)는 정해진 순서로 처리됩니다.

1. 차입자의 담보. Hypercall은 계정의 HyperCore 담보에서 회수합니다. 회수를 참고하십시오. 대출은 회수 수단이 소진된 후에만 상각됩니다.
2. 최우선 손실 준비금. 먼저 차입자가 아직 결제금을 지급하지 않은 상대 계정에 가장 오래된 배치부터 지급하고, 그다음 상각된 대출을 보전합니다.
3. 풀 대출자. 준비금으로 보전하지 못한 부분은 풀의 지분 가격을 낮춥니다.

채무는 면제되지 않습니다. 이후 차입자로부터 회수된 금액은 먼저 아직 지급받지 못한 결제 상대방에게 가장 오래된 배치부터 지급되고, 그다음 남아 있는 풀 대출을 갚는 데 쓰입니다. 그 나머지만 각자의 손실에 비례해 준비금과 대여자에게 돌아갑니다. 퍼스트 로스 준비금은 PM 대출만 보증하며, 거래소 전체의 보험 기금은 없습니다.

API 엔드포인트

청산 상태 조회

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

한 번도 Healthy 상태를 벗어난 적이 없는 계정의 경우 data는 null입니다.

응답:

{
  "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에는 미체결 청산 주문 ID 목록도 포함됩니다. full_liquidation에는 margin_needed, winner, 현재 필요 입찰가 등 인수 관련 세부 정보가 담깁니다.

청산 이력 조회

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

계정의 상태 전환 이력을 반환합니다.

공개 청산 이력 조회

GET /liquidations?limit=50

전체 지갑의 청산 상태 전환 이력을 최신순으로 반환합니다. 이 엔드포인트는 공개되어 있으며, 청산 봇과 모니터링 도구를 위해 커서 기반 페이지네이션을 사용합니다.

쿼리 파라미터

• cursor: 이전 페이지에서 반환된 불투명 커서입니다.
• limit: 페이지 크기입니다. 기본값 50, 최대 100입니다.
• wallet: 선택 사항인 지갑 필터입니다.
• status 또는 state: 선택 사항인 청산 전환 상태 필터입니다. 허용 값은 healthy, pre_liquidation, in_liquidation, liquidated입니다.
• margin_mode: 선택 사항인 증거금 모드 필터입니다. 허용 값은 standard와 portfolio입니다.
• liquidation_mode: 선택 사항인 청산 모드 필터입니다. 허용 값은 partial과 full입니다.

응답: 청산 전환 항목과 다음 요청에 사용할 page.next_cursor를 담은 PublicLiquidationsResponse입니다.

경매 세부 정보 조회

GET /liquidation/auction/{auction_id}

전체 청산의 상태, 포지션, 결제 세부 정보를 반환합니다.

WebSocket 알림

청산 상태 변경은 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과 full_liquidation에는 상태 엔드포인트와 동일한 필드가 담깁니다. 구독하면 자신의 지갑에 대한 실시간 업데이트를 받을 수 있습니다.

파라미터

파라미터	값	설명
건전성 점검 주기	5초	계정 건전성을 점검하는 주기
회복 목표치	필요 MM × 1.05	Healthy로 복귀하는 데 필요한 자기자본(PM) 또는 현금(SM)이며, 전체 청산이 복원하는 수준
최소 부족액	0	부족액이 조금이라도 있으면 부분 청산이 시작됨
청산 보너스	5분에 걸쳐 0.5%에서 10%까지 증가	부분 청산 주문에서 기준 가격에 더해지는 프리미엄
가격 재조정 주기	5초	부분 청산 주문 가격을 재조정하는 주기
전환 기한	20분	전체 청산이 시작되기 전 PreLiquidation 상태로 머무는 시간

권장 사항

트레이더를 위한 권장 사항

1. 증거금 비율 모니터링: 자기자본을 MM보다 충분히 높게 유지하십시오(2배 버퍼 권장)
2. 알림 설정: WebSocket을 사용해 사전 청산 상태를 조기에 감지하십시오
3. 예비 자금 준비: 즉시 입금할 수 있는 여유 담보를 확보해 두십시오
4. 숏은 직접 정리: 직접 낸 주문에는 청산 보너스가 붙지 않습니다

건전성 조회

증거금 상태를 정기적으로 확인하십시오.

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)

---

함께 보기:

• 포트폴리오 증거금: 포트폴리오 계정의 MM 계산
• 표준 증거금: 표준 계정의 MM 계산
• 증거금 하한: 청산 기준에 영향을 주는 안전 하한
• PM 파이낸싱: PM 채무 회수 방식
• PM 리스크 파라미터: 현재 적용 중인 MM 비율 및 기타 모든 PM 설정
• PM 리스크 시뮬레이션: 가상의 포지션 북으로 MM 여유분 확인