ManualTrader/config/env.example

# ========================================
# Hyperliquid API Configuration (CCXT Style)
# ========================================
# Your Hyperliquid API Generator Secret Key (from https://app.hyperliquid.xyz/API)
# This is the SECRET KEY generated by the API panel - NOT your main wallet's private key!
HYPERLIQUID_SECRET_KEY=your_api_secret_key_here

# Your API Wallet Address (from https://app.hyperliquid.xyz/API)
# This is the NEW wallet address created by the API generator - NOT your main MetaMask address!
# It will be different from your main wallet address (0x...)
HYPERLIQUID_WALLET_ADDRESS=your_api_wallet_address_here

# Network selection: true for testnet (safe), false for mainnet (real money!)
HYPERLIQUID_TESTNET=true

# Trading
HYPERLIQUID_MARGIN_MODE=ISOLATED 

# ========================================
# Trading Bot Configuration
# ========================================
# Default token for market/price commands (when no token specified)
DEFAULT_TRADING_TOKEN=BTC

# Risk management settings
RISK_MANAGEMENT_ENABLED=true
# Stop loss threshold based on ROE (Return on Equity) percentage - matches Hyperliquid UI
# This is the percentage loss of your actual cash investment, not margin
STOP_LOSS_PERCENTAGE=10.0

# ========================================
# Telegram Bot Configuration
# ========================================
# Get these from @BotFather in Telegram
TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here

# Get this by running: python utils/get_telegram_chat_id.py
TELEGRAM_CHAT_ID=your_chat_id_here

# Enable/disable Telegram integration
TELEGRAM_ENABLED=true

# ========================================
# Custom Keyboard Configuration
# ========================================
# Enable/disable custom keyboard shortcuts (Freqtrade-style persistent buttons)
TELEGRAM_CUSTOM_KEYBOARD_ENABLED=true

# Custom keyboard layout - comma-separated commands per row, pipe-separated rows
# Format: "cmd1,cmd2,cmd3|cmd4,cmd5|cmd6,cmd7,cmd8,cmd9"
# Example: "/daily,/performance,/balance|/stats,/positions,/orders|/price,/market,/help,/commands"
TELEGRAM_CUSTOM_KEYBOARD_LAYOUT="/daily,/performance,/balance|/stats,/positions,/orders|/price,/market,/help,/commands"

# ========================================
# Bot Monitoring Configuration
# ========================================
# Heartbeat interval for monitoring orders, positions, and price alarms (in seconds)
# Default: 10 seconds - good balance between responsiveness and API usage
# Minimum recommended: 10 seconds (to avoid rate limiting)
# Maximum recommended: 300 seconds (5 minutes)
BOT_HEARTBEAT_SECONDS=10

# Interval (in heartbeats) for running less frequent cleanup tasks in MarketMonitor
# (e.g., orphaned stop loss cleanup, position synchronization)
# Default: 10 heartbeats (e.g., if BOT_HEARTBEAT_SECONDS is 10s, cleanup runs every 100s)
MARKET_MONITOR_CLEANUP_INTERVAL_HEARTBEATS=10

# ========================================
# Logging
# ========================================
# Options: DEBUG, INFO, WARNING, ERROR
LOG_LEVEL=INFO 

# Enable/disable logging to file (true/false)
LOG_TO_FILE=true

# Log file path (relative to project root)
LOG_FILE_PATH=logs/trading_bot.log

# Log rotation type: 'size' (rotate when file gets too big) or 'time' (rotate daily/hourly)
LOG_ROTATION_TYPE=size

# For size-based rotation: max file size in MB before rotation
LOG_MAX_SIZE_MB=10

# For time-based rotation: when to rotate ('midnight', 'H' for hourly, 'D' for daily)
LOG_ROTATION_INTERVAL=midnight

# Number of backup log files to keep (older files are automatically deleted)
LOG_BACKUP_COUNT=5