CLI Activation (< 5 seconds) - FASTEST
python emergency_kill_switch.py activate emergency
🚨 EMERGENCY KILL SWITCH (Priority #1)
⚠️ When to Use: Uncontrolled losses, API errors, suspicious activity, system malfunction, security breach
⚡ Fastest Activation Methods
🚀
📁 File System (< 10 seconds)
touch EMERGENCY_STOP
🌐 API (< 10 seconds)
curl -X POST http://localhost:5000/api/emergency/kill-switch/activate
📊 Check Status
python emergency_kill_switch.py status
curl http://localhost:5000/api/emergency/kill-switch/status
📊 STATUS COMMANDS
💰 Account & Balance Status
Overall Profit Status
python check_profit_status.py
Kraken + Coinbase P&L
Capital Capacity
python calculate_capital_capacity.py
Calculate available capital
All Accounts Capital
python calculate_all_accounts_capital.py
Multi-account overview
Safe Trade Size
python calculate_safe_trade_size.py
Position sizing calculator
🔧 Trading System Status
Diagnose Kraken Trading
python diagnose_kraken_trading.py
Diagnose Trading Logic
python diagnose_trading_logic.py
Profitability Analysis
python analyze_profitability.py
Heartbeat Verification
Set HEARTBEAT_TRADE=true in environment
📈 Analytics & Reports
# Analytics report
python generate_analytics_report.py --detailed
# Paper trading analytics
python paper_trading_manager.py --report
python paper_trading_manager.py --analyze
# Greenlight report
python generate_greenlight_report.py
# Profitability audit
python profitability_audit_report.py
🔔 ALERTS & MONITORING
⚠️ Critical Alert Thresholds
| Alert Type | Threshold | Auto Kill-Switch |
|---|---|---|
| Order Stuck | 5 minutes | Optional (15 min) |
| Adoption Rate | 80% | Configurable |
| Platform Exposure | 30% | Configurable (45%) |
| Daily Loss Limit | Per tier config | Yes |
| Position Limit | 7 positions | Blocked |
🧪 Run Safety Tests
Operational Safety
python test_operational_safety.py
Expected: 7/7 tests pass
Critical Safety
python test_critical_safety.py
Health Check System
python test_health_check_system.py
📸 SNAPSHOTS & METRICS
🎯 Command Center Metrics (8 Key Metrics)
Start Dashboard:
Access:
python bot/dashboard_server.pyAccess:
http://localhost:5001/command-center
Equity Curve
Portfolio Value
Risk Heat
0-100 Score
Trade Quality
Win Rate
Signal Accuracy
Success Rate
Slippage
bps & USD
Fee Impact
% of Profit
Strategy Efficiency
Trades/Day
Capital Growth
Annualized Rate
🌐 API Endpoints for Real-Time Data
Last Evaluated Trade
GET /api/last-trade
Health Check
GET /api/health
Dry-Run Status
GET /api/dry-run-status
Kill Switch Status
GET /api/emergency/kill-switch/status
Performance Status
GET /api/performance/status
Graduation Status
GET /api/graduation/status
🔍 MARKET FILTERS
🎛️ Filter Thresholds (Default)
🌊 ADX Threshold
< 20
Weak trend, choppy market
📊 Min Volume
50%
Of 20-period average
⏱️ Avoid First
30 seconds
Of new candle
💸 Max Spread
10 bps
Basis points
📉 Low Volatility
ATR < 0.1%
Of price
🧪 Market Quality Filters (Python)
from bot.market_filters import (
detect_choppy_market,
check_minimum_volume,
filter_recent_candle_start,
check_spread_and_slippage
)
# Detect choppy/ranging markets
chop_result = detect_choppy_market(df, adx_threshold=20)
# Returns: {'is_choppy': bool, 'reason': str, 'adx_value': float}
# Check volume sufficiency
vol_result = check_minimum_volume(df, min_volume_multiplier=0.5)
# Avoid trading first seconds of candle
early_candle = filter_recent_candle_start(df, avoid_seconds=30)
# Check spread/slippage
spread_result = check_spread_and_slippage(df, max_spread_bps=10)
🐛 TROUBLESHOOTING CHECKLIST
🚫 Bot Won't Start
- Check API keys are set
- Verify order permissions
- Check logs for errors
🚫 No Trades Executing
- Look for TRADE VETO messages
- Check veto reasons
- Verify LIVE_CAPITAL_VERIFIED=true
- Ensure minimum balance ($25+)
🚫 Heartbeat Trade Fails
- Account has $25+ balance
- API key has order permission
- Check logs for API error
🚫 API Not Responding
- Port 5001 is exposed
- API server started
- Firewall allows port 5001
⚡ RAPID FIRE COMMANDS
# Quick system health check
curl http://localhost:5001/api/health | jq
curl http://localhost:5000/api/emergency/kill-switch/status | jq
# Monitor last trade in real-time
watch -n 5 'curl -s http://localhost:5001/api/last-trade | jq .data'
# Check git status
git --no-pager status && git --no-pager diff
# View recent logs
tail -f logs/nija.log
# Run all safety tests
python test_operational_safety.py && \
python test_critical_safety.py && \
python test_health_check_system.py
🚨 REMEMBER: In any emergency, activate kill switch FIRST, investigate SECOND!
📞 Emergency Protocol:
- Activate kill switch immediately -
python emergency_kill_switch.py activate emergency - Review logs -
tail -f logs/nija.log - Check positions via broker UI
- Follow procedures in OPERATIONAL_SAFETY_PROCEDURES.md
- Only deactivate after issue is resolved and verified