시스템자가 보고크립토TypeScriptblockchaincryptocryptocurrencydefiethereum

Hyperliquid-Copy-Trading-Bot

hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot, hyperliquid copy bot

시스템 구조

활용 데이터
HyperliquidOHLCV/호가/체결 데이터
규칙 / 전략

저장소별 전략/실행 조건 확인 필요

실행

거래소 API 기반 자동 주문 실행

에디터 요약

저장소 설명과 공개 메타데이터 기준으로 암호화폐 거래 봇, 거래소 API/프레임워크, 백테스트 성격의 프로젝트로 파악했습니다. 확인 근거는 README, 저장소 토픽, 저장소 설명, GitHub 지표, 파이프라인 필드이며, 주요 데이터는 Hyperliquid, OHLCV/호가/체결 데이터입니다. 전략/실행 조건은 저장소별 문서와 코드 확인이 필요하며, 실행 방식은 "거래소 API 기반 자동 주문 실행"라고 보수적으로 기록했습니다. GitHub 지표는 별 321개, 포크 213개입니다.

저장소MarilynClarke/Hyperliquid-Copy-Trading-Bot
제작자MarilynClarke
스타 / 포크★ 321 / 213
라이선스MIT
최근 업데이트2026-06-13
스냅샷 시점2026-07-08 (아래 README는 이 시점의 사본입니다)

아래는 제3자가 작성·공개한 오픈소스 코드입니다. QuantField는 해당 코드의 동작과 안전성을 보증하지 않으며, 설치·실행 전 코드를 직접 검토하시기 바랍니다.

GitHub에서 보기 →

README

Hyperliquid Copy Trading Bot

Overview

A production-grade copy trading bot built in TypeScript (Node.js) that mirrors trades from a target Hyperliquid wallet in real-time. It listens for fills/trades, copies opens, reduces, and closes positions while applying configurable risk parameters, supports dry-run and testnet modes, and offers safety/resilience features.

Core Functionality

  • Real-time copying: Monitors a target wallet (public or vault address) for new fills/trades via WebSocket subscriptions, and mirrors opens, reduces, closes of positions immediately.
  • Smart risk management & sizing:
    • Position size = (ourAccountEquity / targetWalletEquity) * targetPositionSize * SIZE_MULTIPLIER
    • Configurable multiplier (e.g. 0.5×, 1×, 2×)
    • Minimum notional check (skip if too small) — Hyperliquid requires ~$10 per order
    • Maximum position size cap (as % of our equity)
    • Match leverage, but cap at MAX_LEVERAGE
    • Blocked assets support (skip certain assets)
    • Limit on max concurrent open trades

Safety & Resilience

  • Dry-run / simulation mode: Log actions without placing real orders
  • Testnet support: Toggleable via config
  • Graceful reconnects: Automatic WebSocket reconnection on disconnect with exponential backoff
  • Rate limiting: Respects API limits with extra safety layer
  • Error handling & retries: Automatic retry logic for failed orders

Configuration & Validation

  • .env + zod schema for strong typed config
  • Required: PRIVATE_KEY, TARGET_WALLET, TESTNET (boolean)
  • Optional: SIZE_MULTIPLIER, MAX_LEVERAGE, BLOCKED_ASSETS (array), DRY_RUN, LOG_LEVEL

Architecture & Code Quality

  • Modern TypeScript (ESM, strict mode)
  • Modular structure: separate modules for config, SDK init, monitoring, execution, logger, types, etc.
  • Async/await, concurrency where necessary
  • Comprehensive logging (info, warn, error) with timestamps via winston
  • Full type safety using SDK types
  • CLI script (e.g. npm start)
  • Comments & notes on Hyperliquid specifics (e.g. no trailing zeros in size/price, GTC orders, etc.)

Bonus Features

  • Basic PnL tracking: Compare our account vs target
  • Health checks: Periodically verify our positions (every 5 minutes by default)

Project Structure

hyperliquid-copy-bot/
├── package.json
├── tsconfig.json
├── .env.example
├── README.md
├── src/
│   ├── index.ts                 # Main entry point
│   ├── config.ts                # Configuration with zod validation
│   ├── hyperliquidClient.ts    # Hyperliquid SDK wrapper
│   ├── copyTrader.ts            # Core copy trading logic
│   ├── logger.ts                # Winston logger setup
│   ├── types.ts                 # TypeScript type definitions
│   ├── utils/
│   │   ├── risk.ts              # Risk management utilities
│   │   └── healthCheck.ts       # Health check utility
└── logs/                        # Log files (auto-created)

Setup & Installation

Prerequisites

Installation Steps

  1. Clone the repository

    git clone https://github.com/MarilynClarke/Hyperliquid-Copy-Trading-Bot
cd Hyperliquid-Copy-Trading-Bot

  2. Configure environment variables

    cp .env.example .env

    Edit .env and fill in your values:

    PRIVATE_KEY=0xYourPrivateKeyHere
TARGET_WALLET=0xTargetWall