Files
sami7777 82c68fa8b0 Scalping strategy overhaul: bidirectional trading, oil/JPY focus
- Switch to oil stocks (USO, XLE, OXY, CVX, XOM, SLB, HAL, DVN, MPC, VLO)
- Add JPY/USD forex pairs for Japan targeting
- 7-action RL space: long, short, close (was 5 long-only actions)
- Bollinger Band mean-reversion scalp entries both directions
- 5-minute candles with 60-second cycles for scalping
- 35 features (added VWAP, fast RSI, fast ROC for scalping)
- Short position support in backtest, executor, and RL environment
- GA tuned for scalping: tighter SL/TP, shorter hold times

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 16:45:19 -07:00

2.8 KiB

🐟 BIGGFISH Setup Guide

Prerequisites

  • Python 3.9+
  • Alpaca account (free paper trading)

Step 1: Get Alpaca API Keys

  1. Go to Alpaca and create a free account
  2. Navigate to your dashboard
  3. Generate Paper Trading API keys (NOT live trading!)
  4. Save your API Key and Secret Key

Step 2: Install Dependencies

cd /workspace/extra/repos/biggfish
pip install -r requirements.txt

Step 3: Configure BIGGFISH

# Copy example config
cp config/config.example.json config/config.json

# Edit config.json and add your Alpaca keys
nano config/config.json

Update these fields:

{
  "alpaca": {
    "api_key": "YOUR_ALPACA_PAPER_API_KEY",
    "secret_key": "YOUR_ALPACA_PAPER_SECRET_KEY",
    "base_url": "https://paper-api.alpaca.markets"
  }
}

Step 4: Test the Connection

python src/cli.py market

You should see market status. If you get an error, check your API keys.

Step 5: Run Your First Scan

python src/cli.py scan

This will scan for small cap opportunities and show you the top candidates.

Step 6: Check Portfolio Status

python src/cli.py status

Step 7: Start the Trading System

python src/main.py

The system will:

  • Scan for opportunities every 6 hours
  • Check news every 2 hours
  • Generate daily reports at 4:30 PM
  • Propose strategies for your approval
  • Execute approved trades

CLI Commands

# Show portfolio status
python src/cli.py status

# Scan for opportunities
python src/cli.py scan
python src/cli.py scan --focus mid_cap_mixed

# Generate strategies
python src/cli.py strategies

# Check market hours
python src/cli.py market

Next Steps

  1. Review Daily Reports - Check data/reports/ for performance tracking
  2. Approve Strategies - When strategies are proposed, review and approve them
  3. Monitor Performance - Track progress toward the $100 → $1,000 goal
  4. Adjust Configuration - Fine-tune risk parameters in config/config.json

Safety Features

  • Paper Trading Only - No real money at risk
  • Position Limits - Max 20% per position
  • Daily Loss Limits - Max 5% daily loss
  • Total Loss Limits - Max 15% total loss
  • Approval Required - All strategies need approval before execution

Troubleshooting

"Invalid API credentials"

  • Double-check your API keys in config.json
  • Make sure you're using PAPER trading keys, not live keys

"Market is closed"

  • Stock market is only open Mon-Fri, 9:30 AM - 4:00 PM ET
  • System will wait for market to open

No opportunities found

  • This is normal - the screener is selective
  • Try different focus modes (small_cap, mid_cap_mixed, balanced)
  • Market conditions may not be favorable

Support

Check the logs in logs/ for detailed error messages.