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 APIJWT 필요

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

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