A production-grade TypeScript bot that mirrors HTX (Huobi) human elite lead traders on USDT-margined linear swap futures. It watches configured elite traders, detects position changes in real time, and copies trades using Smart Copy (proportional to leader fund usage), Fixed Ratio, or Elite Sentiment strategies — with full risk controls and paper trading.

• Human Elite Copy Trading — Follow multiple HTX lead traders and mirror their futures positions automatically
• Smart Copy Mode — HTX Copy Trading 4.0–style proportional sizing based on leader AUM vs. exposure ratio
• Fixed Ratio Mode — Copy a fixed percentage of leader contract volume
• Elite Sentiment Mode — Trade using HTX public elite trader sentiment indices (swap_elite_account_ratio, swap_elite_position_ratio)
• Paper Trading — Full simulation engine with mock elite traders for risk-free testing
• Live Trading — Direct HTX USDT linear swap API integration with HMAC-SHA256 signing
• Risk Management — Stop loss, take profit, max position size, max daily loss, max open positions
• State Persistence — Resume leader snapshots and trade counts across restarts
• Graceful Shutdown — Persists state on SIGINT/SIGTERM
• Structured Logging — Pino-based logging with configurable levels
• Type-Safe Config — Zod schema validation for all environment variables

Elite Lead Trader                Copy Engine                    Your Account
─────────────────               ─────────────                  ──────────────
Opens BTC-USDT LONG    ──▶   Detect position change    ──▶   Mirror LONG
  20 contracts @ 5x           Calculate smart volume          (proportional)
Adjusts to 30 contracts ──▶  Delta = +10 contracts    ──▶   Add to position
Closes position        ──▶   Detect close event       ──▶   Close yours

Smart Copy calculates your order size so your exposure ratio matches the leader's fund usage — the same principle as HTX Smart Copy mode.

Elite Sentiment uses HTX's public top-trader sentiment API when you prefer aggregate elite bias over following a specific trader.

HTX-human-elite-copy-trading-bot/
├── src/
│   ├── cli/              # CLI entry (start, validate, leaders, sentiment, dry-run)
│   ├── config/           # Zod-validated environment configuration
│   ├── core/             # Copy engine — leader diffing and trade execution
│   ├── exchange/         # HTX API client, paper simulator, leader feed
│   ├── risk/             # Stop loss, take profit, position limits
│   ├── services/         # Bot orchestration and state persistence
│   ├── strategies/       # Smart copy, fixed ratio, elite sentiment logic
│   ├── types/            # Shared TypeScript interfaces
│   └── utils/            # Logger, retry, formatting helpers
├── tests/                # Unit and integration tests (Vitest)
├── .env.example          # Environment variable template
├── package.json
└── tsconfig.json

• Node.js 18 or higher
• npm 9 or higher
• HTX account with API key enabled for futures (for live trading)

cd HTX-human-elite-copy-trading-bot
npm install
cp .env.example .env

Edit .env with your configuration:

HTX_API_KEY=your_api_key_here
HTX_API_SECRET=your_api_secret_here
CONTRACT_CODE=BTC-USDT
LEAD_TRADER_IDS=elite_alpha,elite_beta
COPY_MODE=smart
LEVERAGE=5
PAPER_TRADING=true

npm run dev -- validate

npm run dev -- leaders

npm run dev -- sentiment

npm run dev -- dry-run

npm run dev -- start

Set PAPER_TRADING=false in .env, then:

npm run build
npm start -- start

# Run tests
npm test

# Type checking
npm run typecheck

# Lint
npm run lint

# Development mode
npm run dev -- start

Cryptocurrency futures trading involves substantial risk of loss, including the possibility of losing more than your initial investment through leverage. Copy trading does not guarantee the same results as elite lead traders. This bot is provided as-is with no guarantees of profitability. Always test thoroughly in paper trading mode before deploying real funds. Never invest more than you can afford to lose.

MIT