Banana Farmer

Stock momentum scanner and portfolio intelligence. Look up any ticker for momentum scores, RSI, coil breakout patterns, and AI analysis. Scan top signals across 6,500+ stocks and crypto. Track portfolio holdings with real-time alerts. Market pulse, sector trends, win/loss proof data, and risk assessment — all through natural conversation. Powered by 730 days of backtested data with an 80% 5-day win rate.

# Financial Intelligence Skill

Real-time momentum scoring and market intelligence for 6,500+ stocks and crypto assets. Powered by [Banana Farmer](https://bananafarmer.app) — an AI momentum scanner that combines technical analysis, price momentum, and social sentiment into a single 0-100 Ripeness Score.

Backed by 730 days of tracked data across 12,450+ signals with a verified 80% five-day win rate.

## Quick Start

**Option A — Self-provision a free key instantly (no account needed):**
```bash
curl -s -X POST "https://bananafarmer.app/api/bot/v1/keys/trial" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Agent", "email": "you@example.com"}'
```
Save the `key` from the response. One key per email, instant, no credit card.

**Option B — Sign up for a full account:** [bananafarmer.app/developers](https://bananafarmer.app/developers)

Then:
1. **Set your key**: `export BF_API_KEY=bf_bot_your_key_here` (or add to OpenClaw config)
2. **Try it**: `python3 scripts/bf-lookup.py AAPL` — you get score, badge, RSI, coil, price action, bull/bear case, and what to watch for

That is it. You are now scanning 6,500+ assets for momentum signals.

---

## Prompt Examples

### Single Ticker Analysis

Look up any stock or crypto symbol for a full momentum profile: score, badge, RSI, coil pattern, EMA alignment, price action, volatility, scoring breakdown, AI summary, and bull/bear cases.

**Example prompts:**
- "What's the momentum on AAPL?"
- "Look up TSLA for me"
- "How's Bitcoin looking?"
- "Check NVDA's score and technicals"
- "Is CRWV ripe?"
- "What's the coil score on AMD?"
- "Pull up the full analysis on SMCI"
- "Is PLTR overbought right now?"

**How to run:**
```bash
python3 scripts/bf-lookup.py AAPL
python3 scripts/bf-lookup.py TSLA NVDA AMD   # Multiple tickers at once
python3 scripts/bf-lookup.py BTC              # Crypto works too
```

**What you get back:** Score (0-100), badge (ripe/ripening/overripe/too-late/neutral), current price, 1d and 5d change, RSI with overbought/oversold labels, coil score with breakout flag, EMA 20/50 alignment, 52-week high proximity, volatility metrics, scoring breakdown (technical/momentum/social), key drivers, AI summary bullets, bull case, bear case, and what to watch for.

---

### Top Signals / Batch Analysis

See the highest-scoring momentum signals right now — the tickers showing the strongest alignment across technical, price action, and social indicators.

**Example prompts:**
- "What are the top signals right now?"
- "Show me the hottest momentum setups"
- "Any ripe signals today?"
- "Top 5 stocks by momentum score"
- "What's ripening that I should watch?"
- "Show me the top 20 signals"
- "Any ripe crypto signals?"

**How to run:**
```bash
python3 scripts/bf-market.py top                        # Default top 10, all badges
python3 scripts/bf-market.py top --limit 20             # Top 20
python3 scripts/bf-market.py top --badge ripe           # Only ripe signals
python3 scripts/bf-market.py top --badge ripening       # Only ripening (watchlist candidates)
python3 scripts/bf-market.py top --limit 5 --badge ripe # Top 5 ripe only
```

**What you get back:** Ranked table with symbol, score, badge, 1-day change, 5-day change, and key drivers for each signal. Results are deduplicated by symbol automatically.

---

### Portfolio Tracking

Track multiple holdings across accounts. Get a morning-brief-style intelligence report with alerts for RSI overbought/oversold, big daily moves, ripe/overripe signals, risk flags, and P&L calculations.

**Example prompts:**
- "Check my portfolio"
- "How are my holdings doing?"
- "Run a portfolio brief"
- "Any alerts on my positions?"
- "How's my aggressive account looking?"
- "What's the P&L on my tech holdings?"
- "Any of my holdings overbought?"
- "Which of my stocks are ripe right now?"

**How to run:**
```bash
python3 scripts/bf-portfolio.py portfolios.json                 # Full brief, all accounts
python3 scripts/bf-portfolio.py portfolios.json --account aaron  # Filter to one account
python3 scripts/bf-portfolio.py portfolios.json --json           # JSON output for piping
```

**Portfolio file format** (`portfolios.json`):
```json
{
  "accounts": [
    {
      "id": "personal",
      "name": "My Portfolio",
      "risk_profile": "aggressive",
      "holdings": [
        {"symbol": "AAPL", "shares": 50, "cost_basis": 185.00},
        {"symbol": "NVDA", "shares": 20, "cost_basis": 450.00},
        {"symbol": "TSLA", "shares": 10, "cost_basis": 210.00}
      ]
    },
    {
      "id": "retirement",
      "name": "IRA Account",
      "risk_profile": "conservative",
      "holdings": [
        {"symbol": "VOO", "shares": 100, "cost_basis": 430.00},
        {"symbol": "ABBV", "shares": 40, "cost_basis": 155.00}
      ]
    }
  ]
}
```

**What you get back:** Market status, data freshness, per-account sections with alerts (overbought, oversold, big moves, ripe/overripe signals, too-late warnings, risk-profile mismatches), and detailed holding lines showing price, score, badge, changes, RSI, shares, cost basis, and unrealized P&L with percentages.

**Alert types generated:**
- SIGNAL: holding is ripe or overripe
- CAUTION: holding is too-late (momentum exhausted)
- OVERBOUGHT: RSI above 70 (or 80 for strong warning)
- OVERSOLD: RSI below 30 (potential bounce zone)
- BIG MOVE: more than 5% daily change
- WEEKLY: more than 10% five-day change
- NOTE: high momentum in conservative account

---

### Market Overview

Get a bird's-eye view of the market: how many signals are firing by badge, what is trending, new ripe signals, and a narrative summary.

**Example prompts:**
- "What's the market doing today?"
- "Give me a market pulse"
- "How's the overall momentum landscape?"
- "How many ripe signals are there right now?"
- "What's trending in the market?"
- "Any new ripe signals today?"

**How to run:**
```bash
python3 scripts/bf-market.py pulse
```

**What you get back:** Narrative summary, signal counts broken down by badge (ripe, ripening, overripe, too-late, neutral), trending symbols, and newly ripe signals that just crossed the threshold.

---

### Performance Tracking / Proof Data

See which signals actually played out: winners and losers with real entry prices, current prices, percentage moves, and milestone returns over multiple time horizons.

**Example prompts:**
- "Which signals worked this week?"
- "Show me recent winners"
- "What's the track record look like?"
- "Any big movers from recent signals?"
- "Show me winners from the last 30 days"
- "What percentage of signals won this week?"
- "What were the biggest losers recently?"

**How to run:**
```bash
python3 scripts/bf-movers.py                       # Default: last 7 days, top 5
python3 scripts/bf-movers.py --days 30 --limit 10  # Last 30 days, top 10
python3 scripts/bf-movers.py --days 1 --limit 3    # Today's movers
```

**What you get back:** Winners and losers sections, each showing symbol, percentage change, entry price, current price, and milestone returns (1d, 3d, 5d, 10d). Summary line with calculated win rate for the period.

---

### Risk Assessment

Evaluate whether a stock is extended, overbought, or showing risk flags. Combine RSI, badge, coil, and volatility data into a risk picture.

**Example prompts:**
- "Is TSLA overbought?"
- "What's the risk on NVDA right now?"
- "Is AMD overripe?"
- "Should I be worried about my SMCI position?"
- "What's the max drawdown on CRWV?"
- "Is this too late to buy PLTR?"
- "Any of the top signals looking overextended?"

**How to run:**
```bash
python3 scripts/bf-lookup.py TSLA   # Check RSI, badge, volatility, and bear case
```

**What to look for in the output:**
- RSI above 70: overbought warning, watch for pullback
- RSI above 80: strongly overbought
- Badge "overripe": already extended, pullback likely
- Badge "too-late": chasing at this level carries elevated risk
- Max drawdown percentage: historical worst case from entry
- Average daily range: how volatile it t