MagicTradeBot v3.1 — Hyperliquid 고래 복사 거래 기능 소개

게시됨: 17 10월, 2025

MagicTradeBot의 새로운 Hyperliquid Whale Tracker를 통해 Hyperliquid 및 기타 탈중앙화된 지갑 기반 거래소에서 지갑 수준의 거래 활동을 추적할 수 있습니다. 이제 어떤 지갑 주소든 추적하고, 실시간 알림을 받으며, 완전한 안전성, 필터링 및 제어 옵션과 함께 고래의 거래를 자동으로 미러링(복사)할 수 있습니다.

🚀 개요

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배 레버리지로 그들의 거래를 미러링하며, 고래가 포지션을 닫을 때 미러링된 포지션을 자동으로 닫습니다.

🧠 작동 방식

  1. 이벤트 소스 — 봇은 지정된 주소에 대한 Hyperliquid의 온체인 지갑 이벤트를 구독합니다.
  2. 이벤트 감지 — 고래가 포지션을 열거나 닫을 때, 봇은 크기, 쿨다운, 방향 등의 필터를 기반으로 거래를 검증합니다.
  3. 결정place_order = true인 경우, 연결된 거래소 API를 사용하여 미러링된 거래가 생성되고, 그렇지 않으면 신호가 브로드캐스트됩니다.
  4. 실행 — 슬리피지 한도, 레버리지, 사용 가능한 마진을 준수하여 주문이 실행됩니다. 부분 체결은 비례적으로 미러링될 수 있습니다.
  5. 라이프사이클 — 봇은 미러링된 포지션을 모니터링하고, close_on_whale_close가 활성화된 경우 자동으로 닫습니다.
  6. 로깅 및 알림 — 모든 이벤트는 기록되며, 선택적으로 알림 또는 모니터링 채널로 전송됩니다.

🔒 보안 및 리스크 관리

  • API 키나 개인 키를 하드코딩하지 마세요 — 환경 변수 또는 암호화된 비밀을 사용하세요.
  • 권한을 거래 전용으로 제한하고, 출금을 절대 활성화하지 마세요.
  • 라이브로 전환하기 전에 초기 테스트를 위해 DemoMode를 사용하세요.
  • max_open_per_whaleslippage_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: falseDemoMode: true를 설정하여 안전한 테스트를 진행하세요.
  • 미러링 거래를 활성화하기 전에 신호 메시지를 확인하세요.
  • 작은 order_amount로 시작하여 정확한 이벤트 감지를 확인하세요.
  • 미러링된 거래 로그를 위해 completedorders.yaml을 모니터링하세요.

⚡ 운영 모범 사례

  • 고래가 주문을 분할하는 경우 과도한 거래를 방지하기 위해 cooldown_seconds를 사용하세요.
  • 변동성이 큰 시장에서는 신호 전용 모드를 유지하세요.
  • 동적 크기 조정 및 리스크 완화를 위해 자금 관리 모듈과 결합하세요.
  • 관찰 가능성 메트릭과 이벤트 감사를 위해 Prometheus와 Loki를 사용하세요.

⚠️ 제한 및 리스크

  • 고래 추적 ≠ 보장된 수익 — 고래도 손실을 입거나 조작할 수 있습니다.
  • 실행 지연과 슬리피지는 미러링된 거래 결과에 차이를 초래할 수 있습니다.
  • 많은 지갑을 추적하면 API 부하가 증가하므로, 이에 따라 속도 제한을 조정하세요.

💬 FAQ

Q: 어떤 지갑이든 추적할 수 있나요?

예. tracking_addresses 아래에 공개 지갑 주소를 추가하면, 봇이 관련 거래 활동을 자동으로 감지합니다.

Q: 고래의 정확한 포지션 크기를 따라 하나요?

아니요. 설정된 order_amount 또는 follow_partial_fills가 활성화된 경우 비례 크기를 사용합니다.

Q: 고래가 여러 개의 소액 주문을 보내면 어떻게 되나요?

cooldown_secondsfollow_partial_fills를 사용하여 중복 거래를 방지하고 과도한 노출을 제어하세요.

공개 지갑 활동을 따르는 것은 온체인에서 투명하지만, 거래소 약관과 지역 규정을 준수해야 합니다. MagicTradeBot은 도구를 제공하며, 법적이고 윤리적인 사용에 대한 책임은 사용자에게 있습니다.

🛠️ 지원 및 문제 해결

  • completedorders.yaml 및 로그를 확인하여 오류를 점검하세요.
  • API 권한과 환경 변수 구성을 확인하세요.
  • 기술 지원을 위해 대시보드를 통해 공식 MagicTradeBot 지원에 문의하세요.