TradingAgents × OpenClaw — Workflow + PRD

⚠️

AVISO CRÍTICO: TradingAgents é um sistema de ANÁLISE e RECOMENDAÇÃO. NÃO executa ordens automaticamente. Toda decisão de compra/venda requer revisão humana de Diego. Nunca executar ordem baseada apenas nesta análise.

→

Pipeline de Execução

Input do usuário → 4 agentes paralelos → análise → risco → recomendação final

💬

Input

Diego / ASPIRA

ticker+period

⚡

Coleta

4 agentes paralelos

dados multi-fonte

🧠

Análise

LangGraph

analysis.json

⚖️

Risco

Risk Manager

risk_report

🎯

Decisão

Portfolio Mgr

recommendation

📤

Entrega

Telegram #450

⏱️

Tempo total

~5 min

4 agentes em paralelo na coleta

💰

Custo por run

~$0.20

Dominado por GPT-4o (~$0.15)

🤖

Agentes totais

4 coleta + 1 análise + 1 risco + 1 decisão

🔬

Framework

LangGraph

State machine para orquestração

⇄

Entrada → Saída

📥 Entrada

📊Ticker do ativo (ex: BTC, ETH, AAPL)obrigatório

📅Período de análise (ex: 30d, 90d)obrigatório

💬Contexto adicional (opcional)opcional

→

📤 Saída (análise apenas)

📈Análise técnica completa (suporte/resistência, sinais)#450

⚖️Relatório de risco (stop-loss, position sizing)#450

🎯Recomendação final com score de confiançasomente análise

⚠️

Regras Críticas

🚫

NUNCA executar ordem automaticamente

TradingAgents é análise + recomendação. A execução de ordens é SEMPRE manual por Diego ou via TRADER agent com aprovação explícita.

🔑

Alpha Vantage via 1Password

API key de dados de mercado armazenada no vault Aspira. Nunca hardcoded nos scripts.

📊

Score de confiança obrigatório

Toda recomendação deve incluir score de confiança (1-10) e lista explícita de riscos identificados.

✅

Revisão humana antes de qualquer ação

Diego analisa o relatório completo antes de tomar qualquer decisão de trade. Sem exceções.

Status

Em implementação

Versão

v0.9 beta

Agentes

6 (4 paralelos)

Framework

LangGraph

Última revisão

25/03/2026 BRT

Input do Usuário

Diego ou ASPIRA envia o ticker para análise

Input — Ticker + Período

Diego define o ativo e janela de análise

Agente responsável

🧑Diego / ASPIRA

LLM

n/a

Tools

message

Custo$0.00~2s

Diego informa o ativo

Ex: "Analisar BTC nos últimos 30 dias" ou "TradingAgents ETH 90d". ASPIRA extrai ticker e período.

Inicializar LangGraph state

Cria o estado inicial do grafo: {ticker, period, context, agents_results: {}}. Dispara os 4 agentes de coleta em paralelo.

Coleta Paralela — 4 Agentes Simultâneos

Dados de mercado, fundamentais, notícias e análise técnica rodando em paralelo via LangGraph

4 Agentes Paralelos — LangGraph

Todos rodam simultaneamente, resultados consolidados no estado

Agentes (4 paralelos)

⚡A + B + C + D

LLM cada

GPT-4o-mini

APIs

Alpha VantageNewsAPIFinancial APIs

Custo total (4×)~$0.044 × ~$0.01~60s paralelo

Agente A — Dados de Mercado

OHLCV histórico, volume, MACD, RSI, Bandas de Bollinger via Alpha Vantage API. Retorna: preços, indicadores técnicos calculados, volume profile.

Agente B — Dados Fundamentais

Para ativos tradicionais: earnings, P/L, receita, margens, balanço via Financial Modeling Prep. Para cripto: supply, holders, onchain metrics.

Agente C — Notícias & Sentimento

Últimas 48h de notícias relacionadas ao ativo via NewsAPI. Sentiment score por artigo. Fear & Greed index. Social mentions trend.

Agente D — Análise Técnica

Identifica suporte/resistência via pivôs, calcula níveis Fibonacci, detecta padrões gráficos (cabeça-ombros, bandeiras, cunhas), avalia tendência primária.

💡Os 4 agentes rodam em paralelo no LangGraph. O grafo aguarda todos completarem antes de passar para a fase de análise. Timeout individual: 90s.

Análise & Raciocínio — LangGraph

ANALYST consolida todos os dados e gera análise estruturada

ANALYST — Consolidação e Raciocínio

GPT-4o analisa outputs dos 4 agentes e gera visão integrada

Agente responsável

🧠ANALYST

LLM

GPT-4o

Framework

LangGraph state

Custo~$0.05~25k tokens GPT-4o~45s

Consolidar outputs dos 4 agentes

Lê o estado LangGraph com todos os resultados. Identifica confluências e divergências entre as 4 perspectivas (técnica, fundamental, sentimento, padrões).

Gerar structured_analysis.json

Análise integrada com: tendência principal, sinais confirmadores, sinais contrários, cenário base, cenário alternativo, score de confiança 1-10.

Gestão de Risco

RISK MANAGER calcula stop-loss, position sizing e risk/reward

RISK MANAGER — Parâmetros de Risco

Stop-loss, position sizing, risk/reward ratio

Agente responsável

⚖️RISK MANAGER

LLM

GPT-4o

Custo~$0.03~15k tokens GPT-4o~30s

Calcular níveis de stop e alvo

Baseado nos suportes/resistências e ATR. Stop-loss conservador, moderado e agressivo. Alvo de preço com probabilidade.

Position sizing sugerido

% do portfólio recomendado com base no risco identificado. Sempre inclui: max loss em $, risk/reward ratio.

Portfólio Manager — Decisão Final

PM consolida tudo e emite recomendação: comprar / vender / manter

PORTFOLIO MANAGER — Recomendação Final

⚠️ Análise apenas — Diego decide a execução

Agente responsável

🎯PORTFOLIO MGR

LLM

GPT-4o

Custo~$0.03~15k tokens GPT-4o~20s

Decisão: comprar / vender / manter

Com base na análise + risco. Inclui horizonte de tempo recomendado, convicção (alta/média/baixa) e premissas que invalidam a tese.

⚠️AVISO: Esta recomendação é análise computacional, NÃO conselho financeiro. Diego revisa antes de qualquer ação.

Entrega — Telegram #450

Entrega no Telegram Tópico #450

DeFi / Trading — relatório formatado

Agente responsável

🫡ASPIRA

Tools

message

Custo~$0.001~5s

Formatar e enviar relatório

Relatório estruturado: análise técnica + fundamental + risco + recomendação + score de confiança → Telegram tópico #450 (DeFi/Trading).

⚙️

Matriz Técnica

#	Fase	Agente	LLM	Skills/APIs	Tools	Input	Output	Custo	Tempo
0	Input	🧑 Diego	n/a	—	message	Ticker + período	{ticker, period, context}	$0.00	~2s
1A	Dados Mercado	📈 Agente A	GPT-4o-mini	Alpha Vantage	web_fetch	ticker + period	OHLCV + indicadores	~$0.01	~60s ‖
1B	Fundamentais	🏢 Agente B	GPT-4o-mini	Financial APIs	web_fetch	ticker	P/L, receita, balanço	~$0.01	‖ paralelo
1C	Notícias	📰 Agente C	GPT-4o-mini	NewsAPI	web_fetch	ticker	news + sentiment	~$0.01	‖ paralelo
1D	Técnica	📊 Agente D	GPT-4o-mini	—	exec	OHLCV	suporte/resistência + padrões	~$0.01	‖ paralelo
2	Análise	🧠 ANALYST	GPT-4o	LangGraph state	—	4 outputs agentes	structured_analysis.json	~$0.05~25k tokens	~45s
3	Risco	⚖️ RISK MGR	GPT-4o	—	—	analysis.json	risk_report.json	~$0.03~15k tokens	~30s
4	Decisão PM	🎯 PORT. MGR	GPT-4o	—	—	analysis + risk	final_recommendation.json	~$0.03~15k tokens	~20s
5	Entrega	🫡 ASPIRA	Claude Sonnet	—	message	todos outputs	Telegram #450	~$0.001	~5s
TOTAL								~$0.20~70k tokens	~5 min

🧠

Fase 2 — ANALYST (Consolidação)

LLM: GPT-4o · max_tokens: 4096

ANALYST

🧩 PROMPT — ANALYST

system

Você é um analista de mercado sênior consolidando análise multi-perspectiva. ATIVO: {{ TICKER }} PERÍODO: {{ PERIOD }} DADOS COLETADOS PELOS 4 AGENTES: Mercado: {{ MARKET_DATA }} Fundamentais: {{ FUNDAMENTAL_DATA }} Notícias/Sentimento: {{ NEWS_DATA }} Técnica: {{ TECHNICAL_DATA }} RETORNAR JSON: { "ticker": "...", "tendencia_principal": "alta|baixa|lateral", "sinais_confirmadores": ["..."], "sinais_contrarios": ["..."], "cenario_base": "...", "cenario_alternativo": "...", "score_confianca": 1-10, "horizonte_recomendado": "curto|medio|longo prazo", "premissas_invalidacao": ["..."] }

⚖️

Fase 3 — RISK MANAGER

LLM: GPT-4o · max_tokens: 2048

RISK MGR

🧩 PROMPT — RISK MANAGER

Você é um gestor de risco especializado. ANÁLISE CONSOLIDADA: {{ STRUCTURED_ANALYSIS }} PREÇO ATUAL: {{ CURRENT_PRICE }} CALCULAR: 1. Stop-loss: conservador (-5%), moderado (-8%), agressivo (-12%) 2. Alvos de preço: curto (+10%), médio (+20%), longo (+40%) 3. Risk/reward ratio para cada cenário 4. Position sizing sugerido (% do portfólio) RETORNAR JSON com todos os cálculos e justificativas.

🧭

Visão Geral

O que é

Framework de análise de ativos financeiros usando múltiplos agentes LLM especializados rodando em paralelo via LangGraph. Cobre análise técnica, fundamental, sentimento e gestão de risco em um único pipeline integrado.

Limitação crítica

TradingAgents é ANÁLISE APENAS. Não executa ordens. Toda decisão de compra/venda é responsabilidade de Diego com revisão humana obrigatória.

🎯

Objetivos

~5 min

Análise completa

vs horas de pesquisa manual

Perspectivas

técnica + fundamental + sentimento + risco

~$0.20

Custo por análise

GPT-4o para análise sênior

1-10

Score confiança

sempre explícito no output

⚠️

Riscos & Mitigações

Risco: Alpha Vantage API rate limit
✅ Mitigação: Cache de dados por 15min. Fallback para Yahoo Finance scraping.
Risco: GPT-4o alucinações em dados de preço
✅ Mitigação: Agente A valida todos os números contra fonte primária antes de passar ao ANALYST.
Risco: Decisão de trade sem revisão
✅ Mitigação: Output sempre marcado como "ANÁLISE — NÃO EXECUTAR SEM REVISÃO". Integração com TRADER agent requer confirmação explícita.

Status

Beta v0.9

Framework

LangGraph

Agentes

6 (4 paralelos)

Última revisão

25/03/2026 BRT

Integração TRADER agent