Hyperliquid Whale Tracker 사용자 가이드

📑 목차

개요
설정
작동 방식
신호 방송
자동 카피 트레이딩
포지션 모니터링
보안 기능
문제 해결

📖 개요

Hyperliquid Whale Tracker는 Hyperliquid 거래소에서 고래 지갑 활동을 모니터링하고 자동 카피 트레이딩을 가능하게 하는 고급 기능입니다. 추적 중인 고래가 새로운 포지션을 열면, 시스템은 Discord/Telegram으로 자동으로 신호를 방송하고/또는 귀하의 계정에 미러링된 거래를 배치할 수 있습니다.

🔍 실시간 탐지

5분마다 고래 포지션을 모니터링하고 새로운 포지션을 즉시 탐지합니다.

📢 다중 플랫폼 알림

Discord, Telegram, WhatsApp으로 풍부한 포맷의 신호를 방송합니다.

🤖 자동 카피 트레이딩

사용자 맞춤 설정과 위험 매개변수로 고래 포지션을 자동으로 미러링합니다.

🎯 스마트 클로즈 트래킹

고래가 포지션을 닫으면 사용자의 포지션도 자동으로 닫습니다.

⚙️ 설정

기본 설정

설정 파일의 HyperLiquidWhaleTracker 아래에 위치:

HyperLiquidWhaleTracker:
  is_enabled: true                 # 고래 추적 활성화/비활성화
  tracking_addresses:              # 고래 지갑 주소 목록
    - "0x2ea18c23f72a4b6172c55b411823cdc5335923f4"
    - "0xb317d2bc2d3d2df5fa441b5bae0ab9d8b07283ae"
    - "0x9458f423df6569f053358ee9906613cd69c1ec04"
    # 더 많은 주소 추가...
  
  place_order: false               # 자동으로 미러링된 주문 배치
  broadcast_signals: true          # 메시징 플랫폼으로 방송
  max_orders_per_whale: 2          # 고래당 최대 동시 주문
    

메시징 플랫폼 설정

broadcast:
  # Discord
  discord_webhook_url: "https://discord.com/api/webhooks/YOUR_WEBHOOK"
  
  # Telegram
  telegram_bot_token: "YOUR_BOT_TOKEN"
  telegram_chat_id: "YOUR_CHAT_ID"
  
  # WhatsApp (선택사항)
  whatsapp_token: "YOUR_TOKEN"
  whatsapp_phone_id: "YOUR_PHONE_ID"
    

트레이딩 설정

general:
  initial_trade_amount: 100        # 거래당 USD 금액
  leverage: 10                     # 레버리지 배수
  demo_mode: false                 # 실제 거래 없이 테스트

sltp_settings:
  take_profit_percent: 5.0         # 익절 %
  stop_loss_percent: 2.0           # 손절 %
    

🔧 작동 방식

탐지 프로세스

1초기 스캔

첫 실행 시, 시스템은 모든 기존 고래 포지션을 등록하지만 방송하지 않습니다 (스팸 방지).

2지속적 모니터링

5분마다 시스템은:

추적 중인 각 고래의 현재 포지션을 가져옵니다
이전에 본 포지션과 비교합니다
이전에 없던 새로운 포지션을 탐지합니다

3포지션 식별

포지션이 새로운 것으로 간주되는 경우:

마지막 점검 시 해당 코인이 고래의 포트폴리오에 없었을 때
시스템이 이전에 이 포지션을 방송하지 않았을 때

4액션 실행

각 새로운 포지션에 대해:

설정된 플랫폼으로 신호를 방송합니다 (활성화된 경우)
카피 트레이드 주문을 배치합니다 (활성화된 경우)
자동 클로즈 트래킹을 위한 모니터링에 포지션을 추가합니다

추적된 고래 포지션 데이터

데이터 포인트	설명
코인	거래 쌍 (예: BTC, ETH, SOL)
사이드	롱 또는 숏 포지션
사이즈	계약 단위의 포지션 크기
진입 가격	고래의 진입 가격
레버리지	포지션 레버리지
미실현 PnL	현재 수익/손실
청산 가격	위험 임계값

📢 신호 방송

방송 활성화

고래가 포지션을 열 때 알림을 받으려면 설정에서 broadcast_signals: true로 설정하세요.

Discord 알림

Rich Embed 포맷

색상 코딩 (롱은 녹색, 숏은 빨간색)
모든 포지션 세부사항이 포함된 정리된 필드
고래 포트폴리오로의 클릭 가능한 링크
추적을 위한 타임스탬프

🐋 고래 알림: 고래 #1 고래 #1이 BTC에서 롱 포지션을 열었습니다 📊 포지션 세부사항 코인: BTC 사이드: 롱 📈 사이즈: 50.5 레버리지: 20x 💰 가격 정보 진입 가격: $65,432.10 미실현 PnL: $-125.50 ⏰ 시간 포지션 개설: 2025-01-15 14:30:00 UTC 탐지: 14:35:00

Telegram 알림

마크다운 포맷

깔끔하고 읽기 쉬운 텍스트 포맷
데이터를 위한 모노스페이스 코드 블록
직접 추적 링크
모바일 친화적 레이아웃

🐋 *고래 알림* 🟢 *고래 #1*이 *롱* 포지션을 열었습니다 *포지션 세부사항:* 코인 : BTC 사이드 : 롱 사이즈 : 50.5 진입 가격 : $65,432.10 레버리지 : 20x 미실현 PnL : $-125.50 청산 : $60,123.45 text *시간:* 개설 : 2025-01-15 14:30:00 UTC 탐지 : 2025-01-15 14:35:00 text 🔗 [CoinGlass에서 추적] _고래: 0x2ea18c23..._

플랫폼 선택

시스템은 유효한 인증 정보를 가진 모든 설정된 플랫폼으로 방송합니다. 인증 정보가 없는 플랫폼은 자동으로 건너뜁니다:

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 (변경 없음)

주문 배치 로직

새로운 고래 포지션 탐지 시:
  → broadcast_signals 활성화 여부 확인 → 알림 전송
  → place_order 활성화 여부 확인:
    → 고래 주문 제한 초과 여부 확인
    → 일치하는 활성 거래 쌍 찾기
    → 봇이 실행 중인 주문이 없는지 확인 (충돌 방지)
    → 사용자의 설정에서 주문 크기 계산
    → 사용자의 TP/SL로 시장 주문 배치
    → opentrades.yaml에 저장
    → 자동 클로즈를 위한 모니터링에 추가
    

👁️ 포지션 모니터링 & 자동 클로즈

자동 클로즈 트래킹

고래 트레이드를 카피하면 시스템이 고래의 포지션을 지속적으로 모니터링합니다. 고래가 포지션을 닫으면 사용자의 카피 트레이드도 자동으로 닫힙니다.

작동 방식

포지션 등록: 카피 트레이드 배치 후 포지션이 모니터링에 추가됨
지속적 확인: 5분마다 시스템이 고래의 현재 포지션을 확인
클로즈 탐지: 고래 포지션 크기가 감소하거나 사라졌을 때 식별
자동 클로즈 실행: 해당 포지션을 즉시 닫음

클로즈 시나리오

완전 클로즈 (100%)

고래: 전체 포지션 닫기

사용자 트레이드: 포지션의 100% 자동 클로즈

결과: 트레이드가 완료로 이동, running_orders 정리

부분 클로즈

고래: 포지션 크기 감소 (예: 50% 클로즈)

사용자 트레이드: 일치하는 퍼센트 클로즈

결과: 새로운 수량으로 트레이드 업데이트

상태 관리

# 클로즈 전
running_orders:
  - order_id: "12345"
    symbol: "BTCUSDT"
    status: "Active"
    whale_address: "0x2ea..."

# 클로즈 후
running_orders: null  # 정리됨, 다음 트레이드를 위한 준비
completed_trades:
  - order_id: "12345"
    status: "Closed"
    realized_pnl: 45.30
    close_reason: "고래 #1이 BTC 포지션을 닫음"
    

🛡️ 보안 기능

주문 제한

고래당 제한 (`max_orders_per_whale`)

기본값: 고래당 2개의 동시 주문
설정 가능: 임의의 숫자 설정 (1-10 권장)
목적: 단일 고래에 대한 과도한 노출 방지

예시: 고래 #1이 2개의 활성 포지션 보유 → 새로운 포지션 탐지 → 시스템 확인: 2/2 제한 도달 → 주문 건너뜀: "고래 주문 제한 도달"

데모 모드

실제 자본을 위험에 빠뜨리지 않고 시스템을 테스트:

general:
  demo_mode: true  # 실행 없이 주문 시뮬레이션
        

데모 모드에서:

✅ 고래 포지션 탐지
✅ 신호 방송
✅ 주문 세부사항 기록
❌ 실제 주문 배치 안함
❌ 거래소 API 호출 안함

봇 충돌 방지

카피 트레이드 배치 전:

대상 봇이 실행 중인 주문이 있는지 확인
봇이 이미 거래 중이면 주문 건너뜀
동일 심볼에 대한 다중 동시 포지션 방지

포지션 검증

모든 주문은 다음에 대해 검증됩니다:

유효한 심볼: 사용자의 거래소에 존재해야 함
현재 가격: 검색 가능해야 함 (> 0)
수량 계산: 거래소 최소값 충족해야 함
레버리지 제한: 거래소 허용 범위 내

🔧 문제 해결

일반적인 문제

❌ "고래 주소가 설정되지 않음"

문제: tracking_addresses 목록이 비어있음

해결책:

HyperLiquidWhaleTracker:
  tracking_addresses:
    - "0xYOUR_WHALE_ADDRESS_HERE" 

Hyperliquid Whale Tracker 사용자 가이드

📑 목차

📖 개요

🔍 실시간 탐지

📢 다중 플랫폼 알림

🤖 자동 카피 트레이딩

🎯 스마트 클로즈 트래킹

⚙️ 설정

기본 설정

메시징 플랫폼 설정

트레이딩 설정

🔧 작동 방식

탐지 프로세스

추적된 고래 포지션 데이터

📢 신호 방송

방송 활성화

Discord 알림

Rich Embed 포맷

Telegram 알림

마크다운 포맷

플랫폼 선택

🤖 자동 카피 트레이딩

자동 트레이딩 활성화

카피 트레이딩 작동 방식

⚠️ 중요: 사용자의 설정, 고래의 설정이 아님

거래소 호환성

주문 배치 로직

👁️ 포지션 모니터링 & 자동 클로즈

자동 클로즈 트래킹

작동 방식

클로즈 시나리오

완전 클로즈 (100%)

부분 클로즈

상태 관리

🛡️ 보안 기능

주문 제한

고래당 제한 (max_orders_per_whale)

데모 모드

봇 충돌 방지

포지션 검증

🔧 문제 해결

일반적인 문제

❌ "고래 주소가 설정되지 않음"

📎 Related Topics

고래당 제한 (`max_orders_per_whale`)