hyperliquid-copy-trading-bot

HyperLiquid trading bots in TypeScript:

• copy-trading bot (hyperliquid_copy_bot.mts)
• DCA bot (hyperliquid_dca_bot.mts)

No UI. Runs as a Node process.

Requirements

• Node.js 18+
• npm
• HyperLiquid wallet + API private key

Install

npm install

Configure

Create env file:

Copy-Item .env.example .env

Minimum required keys:

• PRIVATE_KEY
• MAIN_WALLET
• Copy bot: TARGET_WALLET (or TARGET_WALLET_1)
• DCA bot: DCA_COINS

Build

npm run build

Run

Copy bot:

npm start

DCA bot:

node dist/hyperliquid_dca_bot.mjs

Recommended first run

Use safe settings first:

• TESTNET=true
• DRY_RUN=true

Check startup logs for:

• config validation success
• websocket connected
• subscriptions active
• trade logs being written

Then switch to live:

• TESTNET=false
• DRY_RUN=false

Runtime files

Generated/updated during runtime:

• dist/ (build output)
• logs/ (CSV logs)
• dca_state.json (DCA state persistence)

Core source:

• shared/ shared client/types/logger/utils
• dca/ DCA strategy modules

Key environment variables

Shared:

• PRIVATE_KEY, MAIN_WALLET
• TESTNET, DRY_RUN
• RETRY_ATTEMPTS, RETRY_DELAY_MS
• PRICE_MAX_AGE_MS, HEALTH_CHECK_INTERVAL_MS
• TRADE_LOG_DIR, LOG_LEVEL

Copy bot:

• TARGET_WALLET or TARGET_WALLET_1..10
• MIN_NOTIONAL
• MAX_POSITION_PCT
• MAX_CONCURRENT_TRADES
• MAX_LEVERAGE
• SLIPPAGE, AGGRESSIVE_SLIPPAGE
• BLOCKED_ASSETS

DCA bot:

• DCA_COINS, DCA_DIRECTION
• DCA_LEVERAGE
• DCA_BASE_MARGIN, DCA_ORDER_MARGIN
• DCA_MAX_ORDERS
• DCA_TAKE_PROFIT, DCA_STOP_LOSS
• DCA_PRICE_DEV, DCA_DEV_MULT
• DCA_SIZE_MULT, DCA_MAX_MARGIN
• DCA_COOLDOWN_MS, DCA_CYCLE_DELAY_MS

Scripts

• npm run build compile to dist/
• npm run typecheck type-check only
• npm start run copy bot from dist/

Notes

• Keep .env out of git.
• Start with small size and dry-run.
• You are responsible for risk when DRY_RUN=false.