openbb-invest-api/openclaw-skills/trade-analyze/SKILL.md

name, description, user-invocable, metadata

name	description	user-invocable	metadata
trade-analyze	Deep trading analysis with multi-agent debate. Collects comprehensive data, spawns Bull/Bear/Hawk/Dove agents for debate, outputs final verdict. Use when user says /trade-analyze or wants deep analysis.	true	openclaw emoji requires ⚖️ bins curl

Trade Analysis — Multi-Agent Debate Pipeline

You are the judge. Debate agents work in the background via sessions_spawn. Only YOU post to Discord.

IMPORTANT: Use sessions_spawn (NOT sessions_send — it will timeout).

Step 1: Collect Data

Run these curl commands using exec. Combine into one command for speed:

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

# All-in-one summary (quote + profile + metrics + financials)
curl -sk "$BASE/api/v1/stock/{TICKER}/summary"

# Technical composite (RSI, MACD, SMA, EMA, Bollinger + signals)
curl -sk "$BASE/api/v1/stock/{TICKER}/technical"

# Composite sentiment (news + analysts + reddit + upgrades)
curl -sk "$BASE/api/v1/stock/{TICKER}/sentiment"

# Macro overview (Fed rate, yields, CPI, unemployment, GDP, VIX)
curl -sk "$BASE/api/v1/macro/overview"

# Analyst price targets and recent upgrades/downgrades
curl -sk "$BASE/api/v1/stock/{TICKER}/upgrades"

# Short selling pressure
curl -sk "$BASE/api/v1/stock/{TICKER}/shorts/volume"

# CAPM risk decomposition
curl -sk "$BASE/api/v1/stock/{TICKER}/capm"

# Sortino ratio (downside risk)
curl -sk "$BASE/api/v1/stock/{TICKER}/sortino?days=365"

Summarize key data points into a concise data package (under 600 words) covering:

• Price, PE, ROE, revenue growth, beta
• RSI, MACD, SMA alignment, Bollinger position
• Sentiment score, insider activity, analyst consensus
• Fed rate, yield curve, VIX
• Short interest, CAPM alpha
• Sortino ratio

Step 2: Bull Case

Use sessions_spawn:

{
  "task": "You are the Bull Researcher for {TICKER}. Build your bullish thesis with 3-5 data-backed arguments. Include entry price, target, and timeframe. Under 400 words.\n\nData:\n{data package}",
  "agentId": "invest-bull",
  "label": "bull-{TICKER}"
}

Wait for announce before proceeding.

Step 3: Bear Case

{
  "task": "You are the Bear Researcher for {TICKER}. Bull argued:\n\n{Bull's argument}\n\nCounter with 3-5 data-backed bearish points. Under 400 words.",
  "agentId": "invest-bear",
  "label": "bear-{TICKER}"
}

Wait for announce.

Step 4: Bull Rebuttal (FINAL)

{
  "task": "FINAL rebuttal for {TICKER}. Bear argued:\n\n{Bear's argument}\n\nCounter Bear's strongest point. State your final conviction. Under 300 words.",
  "agentId": "invest-bull",
  "label": "bull-final-{TICKER}"
}

STOP Bull/Bear after this. Maximum 3 spawns.

Step 5: Hawk Risk

Formulate a preliminary trading proposal based on the debate, then:

{
  "task": "Aggressive risk assessment for {TICKER}. Propose position size, entry, stop-loss, target with exact numbers.\n\nProposal: {BUY/SELL at $X, stop $Y, target $Z}\nBull case: {summary}\nBear case: {summary}",
  "agentId": "invest-hawk",
  "label": "hawk-{TICKER}"
}

Step 6: Dove Risk

{
  "task": "Conservative risk assessment for {TICKER}. Hawk proposed:\n\n{Hawk's response}\n\nPropose safer position sizing and entry strategy. Under 300 words.",
  "agentId": "invest-dove",
  "label": "dove-{TICKER}"
}

Step 7: Final Verdict

After ALL 5 spawns complete, synthesize and output this single message to Discord:

# ⚖️ Trading Verdict: {TICKER}

## Decision: [BUY / SELL / HOLD]
## Confidence: {1-10}/10

### Summary
{2-3 sentences — the core thesis}

### 📊 Data Snapshot
| Metric | Value | Signal |
|--------|-------|--------|
| Price | ${} | - |
| P/E | {} | {cheap/fair/rich} |
| RSI | {} | {OB/OS/neutral} |
| MACD | {} | {bull/bear cross} |
| Sentiment | {} | {bull/bear/neutral} |
| Short Interest | {}% | {low/mod/high} |
| VIX | {} | {fear level} |

### Entry Plan
| Item | Value |
|------|-------|
| Action | BUY/SELL/HOLD |
| Entry | ${price} |
| Stop-loss | ${price} ({%} risk) |
| Target | ${price} ({%} upside) |
| Position | {%} of portfolio |
| Timeframe | {weeks/months} |
| Risk:Reward | {ratio} |

### 🐂 Bull Case
1. {strongest data-backed point}
2. {second point}
3. {third point}

### 🐻 Bear Case
1. {strongest data-backed point}
2. {second point}
3. {third point}

### Risk Assessment
| Analyst | Position | Stop | Strategy |
|---------|----------|------|----------|
| 🦅 Hawk | {%} | ${} | {approach} |
| 🕊️ Dove | {%} | ${} | {approach} |
| **Adopted** | **{%}** | **${}** | **{rationale}** |

### ⚠️ Catalysts & Risks
- Upcoming: {earnings date, ex-div date, FOMC meeting if relevant}
- Key risk: {single biggest risk}
- Key catalyst: {single biggest upside trigger}

Step 8: Save to Memory

Write decision summary to today's memory log.

Rules

1. Use sessions_spawn with agentId — NOT sessions_send
2. Wait for each announce before spawning next
3. Only YOU post to Discord — spawn agents are silent
4. Max 5 spawns: Bull(2) + Bear(1) + Hawk(1) + Dove(1)
5. If spawn times out, note it and continue
6. Never use @ mentions
7. The verdict should be ONE comprehensive message, not multiple