hyperliquid-trading-bot/.env.example at main · chainstacklabs/hyperliquid-trading-bot · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# Hyperliquid Grid Trading Bot Configuration
# Copy this file to .env and configure with your actual values
#
# QUICK START:
# 1. Copy this file: cp .env.example .env
# 2. Set your private key in HYPERLIQUID_TESTNET_PRIVATE_KEY
# 3. Run the bot: uv run python src/run_bot.py bots/btc_conservative.yaml

# =============================================================================
# REQUIRED: PRIVATE KEYS
# =============================================================================

# Testnet (recommended for learning and testing - uses fake money)
HYPERLIQUID_TESTNET_PRIVATE_KEY=...

# Mainnet (real money - be very careful!)
# HYPERLIQUID_MAINNET_PRIVATE_KEY=0x...your_mainnet_private_key

# Alternative: File-based keys
# HYPERLIQUID_TESTNET_KEY_FILE=/path/to/testnet.key
# HYPERLIQUID_MAINNET_KEY_FILE=/path/to/mainnet.key
# HYPERLIQUID_PRIVATE_KEY_FILE=/path/to/legacy.key

# =============================================================================
# TRADING ENVIRONMENT
# =============================================================================

# Set to true for testnet, false for mainnet
HYPERLIQUID_TESTNET=true
TESTNET_WALLET_ADDRESS=...

# Paper trading mode (optional - for simulation without real orders)
# PAPER_TRADING=false

# =============================================================================
# ENDPOINT CONFIGURATION (Optional - uses defaults if not set)
# =============================================================================

# Testnet Endpoints
HYPERLIQUID_TESTNET_PUBLIC_BASE_URL=https://api.hyperliquid-testnet.xyz
HYPERLIQUID_TESTNET_PUBLIC_INFO_URL=https://api.hyperliquid-testnet.xyz/info
HYPERLIQUID_TESTNET_PUBLIC_EXCHANGE_URL=https://api.hyperliquid-testnet.xyz/exchange
HYPERLIQUID_TESTNET_PUBLIC_WS_URL=wss://api.hyperliquid-testnet.xyz/ws

# Mainnet Endpoints
# HYPERLIQUID_PUBLIC_BASE_URL=https://api.hyperliquid.xyz
# HYPERLIQUID_PUBLIC_INFO_URL=https://api.hyperliquid.xyz/info
# HYPERLIQUID_PUBLIC_EXCHANGE_URL=https://api.hyperliquid.xyz/exchange
# HYPERLIQUID_PUBLIC_WS_URL=wss://api.hyperliquid.xyz/ws

# Chainstack Endpoints (if you have Chainstack access)
# HYPERLIQUID_CHAINSTACK_BASE_URL=...
# HYPERLIQUID_TESTNET_CHAINSTACK_INFO_URL=https://...
# HYPERLIQUID_TESTNET_CHAINSTACK_EVM_URL=https://...
# HYPERLIQUID_TESTNET_CHAINSTACK_WS_URL=wss://...
# HYPERLIQUID_CHAINSTACK_BASE_URL=https://...
# HYPERLIQUID_CHAINSTACK_INFO_URL=https://...
# HYPERLIQUID_CHAINSTACK_EVM_URL=https://...
# HYPERLIQUID_CHAINSTACK_WS_URL=wss://...

# Endpoint Priorities (1 = highest priority)
# HYPERLIQUID_TESTNET_PUBLIC_INFO_PRIORITY=1
# HYPERLIQUID_TESTNET_PUBLIC_EXCHANGE_PRIORITY=1
# HYPERLIQUID_TESTNET_PUBLIC_WS_PRIORITY=1
# HYPERLIQUID_TESTNET_PUBLIC_EVM_PRIORITY=1

# =============================================================================
# MONITORING AND HEALTH CHECKS
# =============================================================================

# Endpoint health check settings
ENDPOINT_HEALTH_CHECK_INTERVAL=300
ENDPOINT_HEALTH_CHECK_TIMEOUT=10

# =============================================================================
# LOGGING AND DEBUGGING
# =============================================================================

# Log level (DEBUG, INFO, WARNING, ERROR)
LOG_LEVEL=INFO