# 🐟 BIGGFISH Setup Guide

## Prerequisites
- Python 3.9+
- Alpaca account (free paper trading)

## Step 1: Get Alpaca API Keys

1. Go to [Alpaca](https://alpaca.markets/) 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

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

## Step 3: Configure BIGGFISH

```bash
# 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:
```json
{
  "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

```bash
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

```bash
python src/cli.py scan
```

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

## Step 6: Check Portfolio Status

```bash
python src/cli.py status
```

## Step 7: Start the Trading System

```bash
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

```bash
# 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.