case/workspace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
workspace/projects/crypto-signals/scripts/COINEX_LIVE_TRADER.md

5.6 KiB
Raw Permalink Blame History

CoinEx Live Futures Trader

⚠️ REAL MONEY TRADING - EXTREME CAUTION REQUIRED ⚠️

This is a live futures trading bot that connects to CoinEx and trades real money based on the paper trading strategy. Multiple safety mechanisms are implemented.

🛡️ Safety Features

Kill Switch

  • Automatic Stop: Bot automatically stops if account drops below 50% of starting balance
  • Position Closure: Attempts to close all positions when kill switch triggers
  • Telegram Alert: Sends immediate notification when triggered
  • Cannot be bypassed: Checked before EVERY trading cycle

Position Management

  • Max 3 positions (down from 10 in paper trader)
  • Max 10x leverage (no 15x trades allowed)
  • 5% position sizing (of current equity, ~$7.30 on $146 balance)
  • Futures only - never touches spot trading

Risk Controls

  • Stop Loss: -3% on margin
  • Take Profit: +5% on margin
  • Trailing Stop: 2% from peak
  • Complete logging of every trade
  • Error handling - never crashes silently

📁 Files Created

  • coinex_live_trader.py - Main trading bot
  • test_coinex_api.py - API connection test
  • ~/.config/systemd/user/coinex-live-trader.service - Systemd service
  • ~/.config/systemd/user/coinex-live-trader.timer - 5-minute timer
  • COINEX_LIVE_TRADER.md - This documentation

🚀 Getting Started

1. Test API Connection First

cd /home/wdjones/.openclaw/workspace/projects/crypto-signals/scripts
python3 test_coinex_api.py

This verifies:

  • Credentials are loaded correctly
  • API authentication works
  • Balance, market data, and positions endpoints respond

2. Run Dry Run Mode

python3 coinex_live_trader.py --dry-run

Dry run mode does everything except place actual orders:

  • ✅ Runs scanners
  • ✅ Calculates position sizes
  • ✅ Checks kill switch
  • ✅ Logs all decisions
  • ❌ No real orders placed

3. Live Trading (REAL MONEY)

python3 coinex_live_trader.py

Only run this after thorough testing with dry-run mode!

🔧 Systemd Service (DISABLED by default)

Service files are created but NOT enabled. To enable:

# Reload systemd configuration
systemctl --user daemon-reload

# Enable and start the timer
systemctl --user enable coinex-live-trader.timer
systemctl --user start coinex-live-trader.timer

# Check status
systemctl --user status coinex-live-trader.timer

To disable:

systemctl --user stop coinex-live-trader.timer
systemctl --user disable coinex-live-trader.timer

📊 Monitoring & Logs

Log Files (in /home/wdjones/.openclaw/workspace/projects/crypto-signals/data/coinex-live/)

  • trades.log - All trading activity
  • errors.log - Error messages
  • trader_state.json - Bot state (peak PnL tracking, starting balance)

Systemd Logs

# View recent logs
journalctl --user -u coinex-live-trader.service -f

# View timer logs
journalctl --user -u coinex-live-trader.timer -f

Telegram Alerts

  • Position opens/closes
  • Kill switch triggers
  • Error notifications
  • Periodic summaries

⚙️ Configuration

Trading Parameters (in coinex_live_trader.py)

POSITION_SIZE_PCT = 5.0        # 5% of equity per position
MAX_OPEN_POSITIONS = 3         # Max simultaneous positions  
MAX_LEVERAGE = 10              # Leverage cap
SHORT_SCORE_THRESHOLD = 50     # Min score for shorts
LONG_SCORE_THRESHOLD = 45      # Min score for longs
TP_PCT = 5.0                   # Take profit %
SL_PCT = -3.0                  # Stop loss %
TRAILING_STOP_PCT = 2.0        # Trailing stop %
KILL_SWITCH_DRAWDOWN = 0.50    # 50% drawdown kill switch

Scanning Logic

Uses the same short_scanner and spot scanner logic as the paper trader:

  • Short signals: High RSI, above VWAP, overbought conditions
  • Long signals: Low RSI, below VWAP, oversold conditions
  • Same coin list as paper trader

🚨 Emergency Procedures

Stop the Bot Immediately

# Stop the timer
systemctl --user stop coinex-live-trader.timer

# Kill any running instance  
pkill -f coinex_live_trader.py

Manual Position Closure

If you need to manually close positions, use the CoinEx web interface or API directly.

🔍 Key Differences from Paper Trader

Feature Paper Trader Live Trader
Position Size Fixed $200 5% of equity (~$7.30)
Max Positions 10 3
Max Leverage 15x 10x
Kill Switch None 50% drawdown
Logging Basic Complete trade/error logs
Dry Run Mode N/A Available for testing

📋 Pre-Launch Checklist

  • API test passes (test_coinex_api.py)
  • Dry run mode tested extensively
  • Telegram alerts working
  • Starting balance recorded in state file
  • Log files created and writable
  • Kill switch drawdown level confirmed (50%)
  • Position sizing validated (5% = ~$7.30)
  • Max positions confirmed (3)
  • Leverage capped at 10x

⚠️ Important Warnings

  1. Real Money: This trades with real money on real markets
  2. No Guarantees: No strategy guarantees profits
  3. Monitor Closely: Especially during first days of operation
  4. Market Risk: Crypto futures are highly volatile
  5. API Risk: Exchange issues could affect trading
  6. Kill Switch: May not prevent all losses
  7. Test First: Always test thoroughly in dry-run mode

📞 Support

  • Check logs first: trades.log and errors.log
  • Telegram alerts for real-time issues
  • Systemd logs: journalctl --user -u coinex-live-trader.service
  • Kill switch info in state file: trader_state.json

Remember: This is real money trading. Start small, monitor closely, and never risk more than you can afford to lose.