Hyperliquid Whale Tracker 사용자 가이드
📖 개요
Hyperliquid Whale Tracker는 Hyperliquid 거래소에서 고래 지갑 활동을 모니터링하고 자동 카피 트레이딩을 가능하게 하는 고급 기능입니다. 추적 중인 고래가 새로운 포지션을 열면, 시스템은 Discord/Telegram으로 자동으로 신호를 방송하고/또는 귀하의 계정에 미러링된 거래를 배치할 수 있습니다.
🔍 실시간 탐지
5분마다 고래 포지션을 모니터링하고 새로운 포지션을 즉시 탐지합니다.
📢 다중 플랫폼 알림
Discord, Telegram, WhatsApp으로 풍부한 포맷의 신호를 방송합니다.
🤖 자동 카피 트레이딩
사용자 맞춤 설정과 위험 매개변수로 고래 포지션을 자동으로 미러링합니다.
🎯 스마트 클로즈 트래킹
고래가 포지션을 닫으면 사용자의 포지션도 자동으로 닫습니다.
⚙️ 설정
기본 설정
설정 파일의 HyperLiquidWhaleTracker 아래에 위치:
메시징 플랫폼 설정
트레이딩 설정
🔧 작동 방식
탐지 프로세스
1초기 스캔
첫 실행 시, 시스템은 모든 기존 고래 포지션을 등록하지만 방송하지 않습니다 (스팸 방지).
2지속적 모니터링
5분마다 시스템은:
- 추적 중인 각 고래의 현재 포지션을 가져옵니다
- 이전에 본 포지션과 비교합니다
- 이전에 없던 새로운 포지션을 탐지합니다
3포지션 식별
포지션이 새로운 것으로 간주되는 경우:
- 마지막 점검 시 해당 코인이 고래의 포트폴리오에 없었을 때
- 시스템이 이전에 이 포지션을 방송하지 않았을 때
4액션 실행
각 새로운 포지션에 대해:
- 설정된 플랫폼으로 신호를 방송합니다 (활성화된 경우)
- 카피 트레이드 주문을 배치합니다 (활성화된 경우)
- 자동 클로즈 트래킹을 위한 모니터링에 포지션을 추가합니다
추적된 고래 포지션 데이터
| 데이터 포인트 | 설명 |
|---|---|
| 코인 | 거래 쌍 (예: BTC, ETH, SOL) |
| 사이드 | 롱 또는 숏 포지션 |
| 사이즈 | 계약 단위의 포지션 크기 |
| 진입 가격 | 고래의 진입 가격 |
| 레버리지 | 포지션 레버리지 |
| 미실현 PnL | 현재 수익/손실 |
| 청산 가격 | 위험 임계값 |
📢 신호 방송
방송 활성화
고래가 포지션을 열 때 알림을 받으려면 설정에서 broadcast_signals: true로 설정하세요.
Discord 알림
Rich Embed 포맷
- 색상 코딩 (롱은 녹색, 숏은 빨간색)
- 모든 포지션 세부사항이 포함된 정리된 필드
- 고래 포트폴리오로의 클릭 가능한 링크
- 추적을 위한 타임스탬프
Telegram 알림
마크다운 포맷
- 깔끔하고 읽기 쉬운 텍스트 포맷
- 데이터를 위한 모노스페이스 코드 블록
- 직접 추적 링크
- 모바일 친화적 레이아웃
플랫폼 선택
시스템은 유효한 인증 정보를 가진 모든 설정된 플랫폼으로 방송합니다. 인증 정보가 없는 플랫폼은 자동으로 건너뜁니다:
- Discord:
discord_webhook_url필요 - Telegram:
telegram_bot_token과telegram_chat_id모두 필요 - WhatsApp:
whatsapp_token과whatsapp_phone_id필요
🤖 자동 카피 트레이딩
자동 트레이딩 활성화
고래 포지션을 자동으로 미러링하려면 place_order: true로 설정하세요.
카피 트레이딩 작동 방식
- 포지션 탐지: 시스템이 새로운 고래 포지션을 탐지
- 심볼 매칭: 사용자의 거래소에서 해당 거래 쌍을 찾음
- 주문 검증: 고래 주문 제한과 봇 가용성을 확인
- 주문 배치: 설정된 설정으로 시장 주문을 배치
- 모니터링: 클로즈 모니터링 시스템에 포지션을 추가
⚠️ 중요: 사용자의 설정, 고래의 설정이 아님
카피 트레이드는 고래의 설정이 아닌 사용자의 설정을 사용합니다:
- 사용자의 포지션 크기 (고래의 것 아님)
- 사용자의 레버리지 (고래의 것 아님)
- 사용자의 TP/SL 퍼센트
- 사용자의 위험 관리 규칙
예시: 고래가 100 BTC 롱을 20x 레버리지로 열면 → 사용자의 카피 트레이드: $100 BTC 롱을 10x 레버리지로 (사용자 설정)
거래소 호환성
시스템은 사용자의 거래소에 맞게 심볼을 자동으로 조정합니다:
| 거래소 | 고래 심볼 | 사용자 심볼 |
|---|---|---|
| Binance | BTC | BTCUSDT |
| OKX | BTC | BTC-USDT-SWAP |
| Bybit | BTC | BTCUSDT |
| Bitget | BTC | BTCUSDT |
| HyperLiquid | BTC | BTC (변경 없음) |
주문 배치 로직
👁️ 포지션 모니터링 & 자동 클로즈
자동 클로즈 트래킹
고래 트레이드를 카피하면 시스템이 고래의 포지션을 지속적으로 모니터링합니다. 고래가 포지션을 닫으면 사용자의 카피 트레이드도 자동으로 닫힙니다.
작동 방식
- 포지션 등록: 카피 트레이드 배치 후 포지션이 모니터링에 추가됨
- 지속적 확인: 5분마다 시스템이 고래의 현재 포지션을 확인
- 클로즈 탐지: 고래 포지션 크기가 감소하거나 사라졌을 때 식별
- 자동 클로즈 실행: 해당 포지션을 즉시 닫음
클로즈 시나리오
완전 클로즈 (100%)
고래: 전체 포지션 닫기
사용자 트레이드: 포지션의 100% 자동 클로즈
결과: 트레이드가 완료로 이동, running_orders 정리
부분 클로즈
고래: 포지션 크기 감소 (예: 50% 클로즈)
사용자 트레이드: 일치하는 퍼센트 클로즈
결과: 새로운 수량으로 트레이드 업데이트
상태 관리
🛡️ 보안 기능
주문 제한
고래당 제한 (max_orders_per_whale)
- 기본값: 고래당 2개의 동시 주문
- 설정 가능: 임의의 숫자 설정 (1-10 권장)
- 목적: 단일 고래에 대한 과도한 노출 방지
예시: 고래 #1이 2개의 활성 포지션 보유 → 새로운 포지션 탐지 → 시스템 확인: 2/2 제한 도달 → 주문 건너뜀: "고래 주문 제한 도달"
데모 모드
실제 자본을 위험에 빠뜨리지 않고 시스템을 테스트:
데모 모드에서:
- ✅ 고래 포지션 탐지
- ✅ 신호 방송
- ✅ 주문 세부사항 기록
- ❌ 실제 주문 배치 안함
- ❌ 거래소 API 호출 안함
봇 충돌 방지
카피 트레이드 배치 전:
- 대상 봇이 실행 중인 주문이 있는지 확인
- 봇이 이미 거래 중이면 주문 건너뜀
- 동일 심볼에 대한 다중 동시 포지션 방지
포지션 검증
모든 주문은 다음에 대해 검증됩니다:
- 유효한 심볼: 사용자의 거래소에 존재해야 함
- 현재 가격: 검색 가능해야 함 (> 0)
- 수량 계산: 거래소 최소값 충족해야 함
- 레버리지 제한: 거래소 허용 범위 내
🔧 문제 해결
일반적인 문제
❌ "고래 주소가 설정되지 않음"
문제: tracking_addresses 목록이 비어있음
해결책: