Decker + Hyperliquid

Use when user asks about Hyperliquid DEX trading via Decker. Triggers: HL, 하이퍼리퀴드, DEX, 영구선물, HL 매수, HL 포지션, Hyperliquid 시세. Includes Safety Guidelines (position sizing, slippage).

gigshow@gigshow

Install

openclaw skills install @gigshow/decker-hyperliquid

Decker + Hyperliquid (DEX) 스킬

Goal

Decker를 통해 Hyperliquid DEX에서 시세 조회·주문 실행. 메인 decker 스킬을 확장.

Quick Reference

사용자 말	액션	비고
"HL BTC 0.01 매수해줘", "Hyperliquid에서 이더 매수"	order-request exchange_id=hyperliquid	승인 플로우
"HL 시세", "Hyperliquid BTC 가격"	Assistant API 또는 시세 조회
"HL 포지션", "Hyperliquid 포지션"	Assistant API	JWT 필요

DECKER_API_URL

https://api.decker-ai.com

주문 (Hyperliquid)

order-request에 exchange_id=hyperliquid 추가:

text

GET {DECKER_API_URL}/api/v1/link/slack/order-request?slack_user_id={sender_id}&symbol=BTC&side=buy&quantity=0.01&exchange_id=hyperliquid&openclaw_secret={OPENCLAW_SECRET}

exchange_id=hyperliquid 필수 (Hyperliquid DEX 실행)
symbol: BTC, ETH 등 (USDT 선물 자동)
quantity: 계약 수량

전제 조건

Decker 가입 + Slack 연동
user_settings.exchange_preference = hyperliquid 또는 order 시 exchange_id 지정
Hyperliquid 키 연동 (Decker 설정 → 거래소 API 설정)

Hyperliquid 키 설정 (에이전트 안내용)

API 전용 지갑 생성: https://app.hyperliquid.xyz/API 접속 → "Create API Wallet"
개인키 백업: 생성 시 표시되는 개인키(0x로 시작)를 안전하게 저장 (한 번만 표시)
Decker 설정: 로그인 → 설정 → 거래소 API 설정 → Hyperliquid
- API Key: 지갑 주소(0x..., 42자) — 선택
- Secret Key: 개인키(0x..., 64자 이상) — 필수
거래소 선택: exchange_preference를 "Hyperliquid"로 설정 후 저장
주문: "HL BTC 0.01 매수해줘" (Slack/Telegram)

⚠️ API Wallet은 출금 불가, 거래 전용. 메인 지갑과 분리 권장.

Safety Guidelines (ClawHub hyperliquid-trading 흡수)

주문 실행 전:

사용자에게 거래 파라미터 확인 (코인, 수량, 방향, 가격)
현재 시세·기존 포지션을 함께 표시
예상 비용/수익 계산 후 안내

Position sizing:

계정 자산의 20% 초과 주문 시 경고
잔고 기준 적정 수량 제안

가격·슬리피지:

Limit 주문 시 지정가와 현재가 비교
지정가가 시장가 대비 5% 이상 이탈 시 오타 가능성 경고
시장가 주문 시 슬리피지(5% 등) 안내

Error Handling

"Address required" / "Private key required" → Decker 설정에서 Hyperliquid 키 연동 확인
"Unknown coin" → BTC, ETH 등 지원 심볼 확인
네트워크 오류 → API 상태·연결 확인
자동 재시도 금지 — 실패 시 사용자 확인 후 재요청

참고

메인 decker 스킬: docs/openclaw_skills/decker/SKILL.md
Hyperliquid: 탈중앙 영구선물 DEX