🚀 개요
Hyperliquid Whale Tracker는 MagicTradeBot v3.1의 새로운 모듈로, 온체인 투명성을 활용하고자 하는 트레이더를 위해 설계되었습니다. 선택한 고래 지갑을 지속적으로 모니터링하고 해당 지갑이 포지션을 열거나 닫을 때 반응합니다. 두 가지 주요 모드로 사용할 수 있습니다:
- 신호 전용 모드 — Telegram, Discord, WhatsApp 또는 Webhook을 통해 고래 거래에 대한 실시간 알림을 받습니다.
- 미러링 모드 — 연결된 거래소 계정에서 지능형 보호 장치와 함께 미러링된 거래를 자동으로 실행합니다.
설정은 tradesettings.yaml 파일을 통해 완전히 관리되며, 봇 인스턴스별로 활성화할 수 있습니다. 기본적으로 안전을 위해 꺼져 있습니다.
⚙️ 설정 예시
트래커를 활성화하려면 tradesettings.yaml 파일에 다음 섹션을 추가하세요:
HyperLiquidWhaleTracker:
is_enabled: true
tracking_addresses:
- "0x2aB3...Ff12"
- "0x1cD4...Aa77"
place_order: true
order_amount: 150.0
leverage: 3
broadcast_signals: true
max_open_per_whale: 2
slippage_tolerance_percent: 0.5
follow_partial_fills: true
close_on_whale_close: true
include_liquidations: false
only_follow_buy: false
only_follow_sell: false
min_whale_order_value: 100.0
cooldown_seconds: 60
이 설정은 두 개의 고래 지갑을 추적하고, 거래당 150달러와 3배 레버리지로 그들의 거래를 미러링하며, 고래가 포지션을 닫을 때 미러링된 포지션을 자동으로 닫습니다.
🧠 작동 방식
- 이벤트 소스 — 봇은 지정된 주소에 대한 Hyperliquid의 온체인 지갑 이벤트를 구독합니다.
- 이벤트 감지 — 고래가 포지션을 열거나 닫을 때, 봇은 크기, 쿨다운, 방향 등의 필터를 기반으로 거래를 검증합니다.
- 결정 —
place_order = true인 경우, 연결된 거래소 API를 사용하여 미러링된 거래가 생성되고, 그렇지 않으면 신호가 브로드캐스트됩니다. - 실행 — 슬리피지 한도, 레버리지, 사용 가능한 마진을 준수하여 주문이 실행됩니다. 부분 체결은 비례적으로 미러링될 수 있습니다.
- 라이프사이클 — 봇은 미러링된 포지션을 모니터링하고,
close_on_whale_close가 활성화된 경우 자동으로 닫습니다. - 로깅 및 알림 — 모든 이벤트는 기록되며, 선택적으로 알림 또는 모니터링 채널로 전송됩니다.
🔒 보안 및 리스크 관리
- API 키나 개인 키를 하드코딩하지 마세요 — 환경 변수 또는 암호화된 비밀을 사용하세요.
- 권한을 거래 전용으로 제한하고, 출금을 절대 활성화하지 마세요.
- 라이브로 전환하기 전에 초기 테스트를 위해
DemoMode를 사용하세요. - max_open_per_whale 및 slippage_tolerance_percent를 보수적으로 설정하세요.
- 프로덕션 배포를 위해 오류 모니터링(예: Sentry, PagerDuty)을 활성화하세요.
📣 알림 및 브로드캐스트
broadcast_signals: true일 때, MagicTradeBot은 각 고래 거래 이벤트에 대해 포맷된 알림을 전송합니다.
예시 (Telegram / Discord):
[Hyperliquid Whale] 신규 주문
고래: 0x2aB3...Ff12
액션: 매수 (롱)
심볼: BTCUSDT
크기: 0.5 BTC (~25,000 USDT)
레버리지: 3x
미러링: 예 (주문 ID: M-123456)
예시 (Webhook JSON):
{
"type": "hyperliquid.whale.event",
"whale_address": "0x2aB3...Ff12",
"action": "open",
"side": "buy",
"symbol": "BTCUSDT",
"size": 0.5,
"notional": 25000,
"leverage": 3,
"mirrored": true,
"timestamp": "2025-10-16T12:34:56Z"
}
🧩 테스트 및 데모 모드
place_order: false와DemoMode: true를 설정하여 안전한 테스트를 진행하세요.- 미러링 거래를 활성화하기 전에 신호 메시지를 확인하세요.
- 작은
order_amount로 시작하여 정확한 이벤트 감지를 확인하세요. - 미러링된 거래 로그를 위해
completedorders.yaml을 모니터링하세요.
⚡ 운영 모범 사례
- 고래가 주문을 분할하는 경우 과도한 거래를 방지하기 위해 cooldown_seconds를 사용하세요.
- 변동성이 큰 시장에서는 신호 전용 모드를 유지하세요.
- 동적 크기 조정 및 리스크 완화를 위해 자금 관리 모듈과 결합하세요.
- 관찰 가능성 메트릭과 이벤트 감사를 위해 Prometheus와 Loki를 사용하세요.
⚠️ 제한 및 리스크
- 고래 추적 ≠ 보장된 수익 — 고래도 손실을 입거나 조작할 수 있습니다.
- 실행 지연과 슬리피지는 미러링된 거래 결과에 차이를 초래할 수 있습니다.
- 많은 지갑을 추적하면 API 부하가 증가하므로, 이에 따라 속도 제한을 조정하세요.
💬 FAQ
Q: 어떤 지갑이든 추적할 수 있나요?
예. tracking_addresses 아래에 공개 지갑 주소를 추가하면, 봇이 관련 거래 활동을 자동으로 감지합니다.
Q: 고래의 정확한 포지션 크기를 따라 하나요?
아니요. 설정된 order_amount 또는 follow_partial_fills가 활성화된 경우 비례 크기를 사용합니다.
Q: 고래가 여러 개의 소액 주문을 보내면 어떻게 되나요?
cooldown_seconds와 follow_partial_fills를 사용하여 중복 거래를 방지하고 과도한 노출을 제어하세요.
⚖️ 법적 및 윤리적 고지
공개 지갑 활동을 따르는 것은 온체인에서 투명하지만, 거래소 약관과 지역 규정을 준수해야 합니다. MagicTradeBot은 도구를 제공하며, 법적이고 윤리적인 사용에 대한 책임은 사용자에게 있습니다.
🛠️ 지원 및 문제 해결
completedorders.yaml및 로그를 확인하여 오류를 점검하세요.- API 권한과 환경 변수 구성을 확인하세요.
- 기술 지원을 위해 대시보드를 통해 공식 MagicTradeBot 지원에 문의하세요.