═══════════════════════════════════════════════════════════════
BTC-Trend KASPA Bot — Dashboard
═══════════════════════════════════════════════════════════════
Mode: sandbox | Exchange: kraken | Symbol: KAS/USD | Strategy: btc-macro-gated-bounce
Updated: 2026-07-19 17:57:05 UTC (auto-refresh every 30s)

CURRENT BALANCES (evolved from seed):
  USD: 10000.00 USDC (seed: 10000.00)
  KAS: 0.0000 (seed: 0.0000)

═════════════════════════════════════════════════════════════════
RUNNING THE BOT — Step by Step
═════════════════════════════════════════════════════════════════

1. DRY-RUN (testing, no exchange API calls):
   📋 Simulates trades using real data but fake prices.
   ✓ Use for: Verify the bot logic and schedule.
   ⚠️  Risk: None. No money involved.
   🚀 Command: BOT_MODE=dry-run npm start

2. SANDBOX (paper trading, real prices + virtual funds):
   💰 Real market prices. Virtual $10k portfolio. NO real orders.
   ✓ Use for: Test the strategy for 1-2 weeks, watch equity grow.
   ✓ Expected result: Portfolio shows +15-25% returns (same as backtest).
   ⚠️  Risk: None. Virtual funds only.
   🚀 Command: BOT_MODE=sandbox npm start
   📊 Monitor: npm run web (http://localhost:3000)
   📈 Check P&L: npm run report -- --since 2026-06-15

3. LIVE (real orders on Kraken):
   🔴 Real money at risk. Real orders placed.
   ✓ Use for: Only after sandbox validation shows profit.
   ⚠️  Risk: HIGH. Start with 10% position size, scale to 25% after week 1.
   🔐 Requirements:
      • BOT_API_KEY and BOT_API_SECRET configured in .env
      • BOT_CONFIRM_LIVE=true in .env
      • API key: Trade-only (withdrawals disabled), NOT your main account
   🚀 Command: BOT_MODE=live npm start
   📊 Monitor closely: Check dashboard every day, especially first week

Testing & Development:
   • Reset database: npm run reset
   • Test notifications: npm run reset && BOT_MODE=dry-run BOT_PERIOD=daily BOT_RUN_ONCE=true BOT_NOTIFY_ENABLED=true npm start
   • View live dashboard: npm run web (http://localhost:3000)
   • View trade report: npm run report --since 2026-01-01


== Notifications (Signal Messenger) ==

Receive instant alerts on your phone when trades execute and a weekly balance report.

Prerequisites:
  • Signal messenger app installed on your phone (https://signal.org).
  • signal-cli running locally to bridge messages (https://github.com/AsamK/signal-cli).
  • A dedicated Signal number (separate from your personal number).

Setup:
  1. Install and register signal-cli with a dedicated bot phone number.
  2. Start the signal-cli REST API bridge on localhost:8080:
     signal-cli --user +49-XXX-XXXXXXXX daemon --http localhost:8080
  3. Add the bot number to your Signal group (from your personal Signal app).
  4. Set these environment variables in your .env file:
     BOT_NOTIFY_ENABLED=true
     BOT_NOTIFY_SIGNAL_ENABLED=true
     BOT_SIGNAL_API_URL=http://localhost:8080
     BOT_SIGNAL_NUMBER=+49-XXX-XXXXXXXX  (your dedicated bot Signal number)
     BOT_SIGNAL_RECIPIENT=+49-XXX-XXXXXXXX,+49-YYY-YYYYYYYY  (comma-separated, no spaces)

  Each person in the RECIPIENT list receives an individual message notification.

Notification Types:
  • Trade Alert: Sent immediately when a trade executes (buy/sell, qty, price, fees, BTC move).
  • Weekly Report: Sent every Monday at 00:15 UTC with balances, volume, and P&L summary.
  • Failure Alert: Sent immediately if the cycle fails (error message included).

== Totals ==
Trades: 0 | Buys: 0 | Sells: 0
KAS volume: 0.0000 | Notional: 0.00 | Fees: 0.0000

== By mode ==
No filled trades yet.

== Recent trades ==
No trades recorded yet.

Raw JSON: /metrics.json