---
name: market-analysis
description: Technical analysis report for a stock — trend, momentum, volatility, volume signals via openbb-invest-api
user-invocable: true
metadata: { "openclaw": { "emoji": "📊", "requires": { "bins": ["curl"] } } }
---

# Market Analysis

Generate a structured technical analysis report for a given stock ticker.

## Data Collection

Fetch the following endpoints using `exec` tool (all require `-sk` flag for self-signed TLS):

```bash
BASE=https://invest-api.k8s.home

# 1. Composite technical indicators (RSI, MACD, SMA, EMA, Bollinger Bands)
curl -sk "$BASE/api/v1/stock/{TICKER}/technical"

# 2. Ichimoku Cloud (trend system)
curl -sk "$BASE/api/v1/stock/{TICKER}/technical/ichimoku"

# 3. Historical prices (6 months for trend context)
curl -sk "$BASE/api/v1/stock/{TICKER}/historical?days=180"

# 4. ATR (volatility measure)
curl -sk "$BASE/api/v1/stock/{TICKER}/technical/atr"

# 5. OBV (volume confirmation)
curl -sk "$BASE/api/v1/stock/{TICKER}/technical/obv"
```

## Report Structure

Produce a concise report in this format:

```
## {TICKER} Technical Analysis — {date}

### Price Trend
- SMA 20/50/200 alignment: [golden cross / death cross / neutral]
- Price position: [above/below] 50-day SMA
- Ichimoku: price [above/below] cloud, [bullish/bearish] TK cross

### Momentum
- RSI(14): {value} — [overbought >70 / oversold <30 / neutral]
- MACD: signal line [bullish/bearish] crossover, histogram [expanding/contracting]

### Volatility
- Bollinger Bands: price at [upper/middle/lower] band, bandwidth [wide/narrow]
- ATR(14): {value} — trend [expanding/contracting] vs 20-day average

### Volume
- OBV: [confirming/diverging] from price trend
- Recent volume vs 20-day average: [above/below] by {%}

### Signal: [BULLISH / BEARISH / NEUTRAL]
### Confidence: {1-10}
### Key Risk: {one-line risk factor}
```

## Rules

- Use ONLY data from the API responses — never fabricate indicator values
- If an endpoint returns an error or empty data, note "Data unavailable" for that section
- Keep the report under 400 words
- End with a clear directional signal and confidence score