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. Use sessions_spawn to delegate to invest-bull, invest-bear, invest-hawk, invest-dove. Triggered by /trade-analyze or deep analysis requests.	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). sessions_send will timeout due to gateway architecture.

Step 1: Collect Data

Run these curl commands using the exec tool:

curl -sk "https://invest-api.k8s.home/api/v1/stock/{TICKER}/technical"
curl -sk "https://invest-api.k8s.home/api/v1/stock/{TICKER}/metrics"
curl -sk "https://invest-api.k8s.home/api/v1/stock/{TICKER}/sentiment"
curl -sk "https://invest-api.k8s.home/api/v1/macro/overview"

Summarize key data points (under 500 words).

Step 2: Bull Case

Use the sessions_spawn tool:

{
  "task": "You are the Bull Researcher. Based on the following data for {TICKER}, build your bullish investment thesis with 3-5 specific data-backed arguments. Keep under 400 words.\n\nData:\n{data summary}",
  "agentId": "invest-bull",
  "label": "bull-{TICKER}"
}

sessions_spawn returns immediately with { status: "accepted", runId }. The result will be announced back to you automatically when Bull finishes. Wait for the announce before proceeding.

Step 3: Bear Case

After receiving Bull's result, use sessions_spawn:

{
  "task": "You are the Bear Researcher. For {TICKER}, Bull argued:\n\n{Bull's argument}\n\nBuild your bearish counter-argument with 3-5 specific data-backed points. Keep under 400 words.",
  "agentId": "invest-bear",
  "label": "bear-{TICKER}"
}

Wait for Bear's announce.

Step 4: Bull Rebuttal (FINAL)

{
  "task": "You are the Bull Researcher. Bear responded:\n\n{Bear's argument}\n\nThis is your FINAL rebuttal. Counter Bear's strongest point. Keep under 300 words.",
  "agentId": "invest-bull",
  "label": "bull-final-{TICKER}"
}

STOP Bull/Bear debate after this. Maximum 3 spawns for Bull/Bear.

Step 5: Hawk Risk

Formulate a trading proposal, then:

{
  "task": "You are the Hawk (aggressive) Risk Analyst. Evaluate this {TICKER} trading proposal. Propose position size, entry, stop-loss with specific numbers.\n\nProposal: {direction, entry, stop, target}",
  "agentId": "invest-hawk",
  "label": "hawk-{TICKER}"
}

Step 6: Dove Risk

{
  "task": "You are the Dove (conservative) Risk Analyst. Hawk proposed:\n\n{Hawk response}\n\nEvaluate from capital preservation perspective. Propose safer sizing.\n\nKeep under 300 words.",
  "agentId": "invest-dove",
  "label": "dove-{TICKER}"
}

Step 7: Final Verdict (ONLY output to Discord)

After all spawns complete, synthesize and output:

# ⚖️ Trading Verdict: {TICKER}

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

### Summary
{2-3 sentences}

### Entry Plan
| Item | Value |
|------|-------|
| Action | BUY/SELL/HOLD |
| Entry | ${price} |
| Stop-loss | ${price} ({%} risk) |
| Target | ${price} ({%} upside) |
| Position | {%} of portfolio |

### 🐂 Bull Case
1. {point}
2. {point}
3. {point}

### 🐻 Bear Case
1. {point}
2. {point}
3. {point}

### Risk Assessment
| Analyst | Position | Stop | View |
|---------|----------|------|------|
| 🦅 Hawk | {%} | ${} | {line} |
| 🕊️ Dove | {%} | ${} | {line} |
| **Final** | **{%}** | **${}** | **{why}** |

Step 8: Save to Memory

Write decision to today's memory log.

Rules

1. Use sessions_spawn with agentId — NOT sessions_send (it will timeout)
2. Wait for each announce before spawning the next agent
3. Only YOU post to Discord — spawn agents are silent
4. Max spawns: Bull(2) + Bear(1) + Hawk(1) + Dove(1) = 5 total
5. If spawn times out, skip and continue
6. Never use @ mentions