Decker + Hyperliquid

---

name: decker-hyperliquid description: "Use when user asks about Hyperliquid DEX trading via Decker. Triggers: HL, 하이퍼리퀴드, DEX, 영구선물, HL 매수, HL 포지션, Hyperliquid 시세. Includes Safety Guidelines (position sizing, slippage)." user-invocable: true metadata: version: 1.1.0 extends: decker

---

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 추가:

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 키 설정 (에이전트 안내용)

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

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

Safety Guidelines (ClawHub hyperliquid-trading 흡수)

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

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