═══════════════════════════════════════════════════════════════
BTC-Trend KASPA Bot — Dashboard
═══════════════════════════════════════════════════════════════
Mode: sandbox | Exchange: kraken | Symbol: KAS/USD | Strategy: btc-regime
Updated: 2026-07-15 19:11:40 UTC (auto-refresh every 30s)

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

== Sandbox portfolio ==

Mark-to-market (portfolio value):
  Live price: 0.028880 USD
  Portfolio value: 10051.16 USD
  Profit/Loss vs seed: +51.16 USD

Trades executed: 1

Equity curve (mark-to-market over time, vs seed):
  seed             10000.00   +0.00
  2026-07-09        9974.10   -25.90
  now              10051.16   +51.16 (live)

═════════════════════════════════════════════════════════════════
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: 1 | Buys: 1 | Sells: 0
KAS volume: 347537.5000 | Notional: 9959.82 | Fees: 25.8955

== By mode ==
  sandbox   trades=1  kasVolume=347537.5000  notional=9959.82  fees=25.8955

== Recent trades ==
Period     Time (UTC)        Mode     Signal        Side        Qty KAS      Price    Notional       Fee  Status
2026-07-09 2026-07-13 00:05  sandbox  UP +1.9%      buy     347537.5000   0.028658     9959.82   25.8955  filled
2026-07-02 2026-07-06 00:05  sandbox  DOWN -3.0%    sell         0.0000   0.030940        0.00    0.0000  below_min_amount
2026-06-25 2026-06-29 00:05  sandbox  DOWN -3.9%    sell         0.0000   0.027690        0.00    0.0000  below_min_amount

Raw JSON: /metrics.json