TradingAgents/docs/roadmap.md

Roadmap — DEXAgents

Phase Status

Phase	Status	Description
Scenario 1 — DEX Data Layer	✅ Complete	DeFi-native data providers
Scenario 2 — On-Chain Execution	✅ Complete	Real swaps, portfolio tracking
Scenario 3 — Autonomous 24/7	🔄 Planned	Always-on trading loop

---

Scenario 1 — DEX Data Layer ✅

• CoinGecko provider (token OHLCV, market data)
• DeFiLlama provider (TVL, protocol analytics)
• Birdeye provider (Solana DEX analytics)
• DEX tool wrappers (get_token_ohlcv, get_pool_data, get_whale_transactions)
• Updated interface.py vendor routing for DEX providers
• Adapted analyst prompts for DeFi context
• Updated default_config.py with DEX settings
• End-to-end pipeline test with real token

---

Scenario 2 — On-Chain Execution ✅

• BaseExecutor abstract class (TradeOrder, TradeResult)
• JupiterExecutor — Solana swaps via Jupiter Aggregator V6
• OneInchExecutor — EVM swaps via 1inch V6 API
• OrderManager — signal → order conversion with risk limits
• PortfolioTracker — on-chain balance and P&L tracking
• WebResearchAnalyst — Google CSE search with quota guard
• GoogleSearchClient + QuotaManager — hard block at daily limit
• Devnet/testnet integration test with real wallet

---

Scenario 3 — Autonomous 24/7 🔄 Planned

Streaming Layer

• WebSocket connections for real-time price feeds
• Token alert subscriptions (Birdeye, Pyth)

Trading Loop

• Scheduler (APScheduler or Celery)
• Configurable intervals (e.g. every 15 min per token)
• Watchlist management

Persistent Memory

• PostgreSQL schema for trade history
• P&L tracking per position
• Agent memory persistence (LangGraph checkpointing)

Monitoring

• Telegram bot for trade alerts
• Dashboard (FastAPI + simple frontend)
• Error alerting and dead-man's switch

---

Technical Debt

Item	Priority	Notes
PortfolioTracker._fetch_token_balances	High	Stub — needs real Solana RPC + ERC20 calls
PortfolioTracker._fetch_token_prices	High	Stub — needs Pyth or Birdeye price oracle
JupiterExecutor._confirm_and_parse	Medium	Stub — needs real confirmation loop
OneInchExecutor._confirm_and_parse	Medium	Stub — needs eth_getTransactionReceipt polling
Devnet tests	High	Must test real transaction flow before mainnet
Uncomment pytest in CI	Medium	Currently skipped; add after devnet tests pass
Token decimals handling	High	Hardcoded 9 (Solana) / 18 (EVM) — need per-token lookup

---

Future Ideas

• Multi-chain portfolio: Track positions across Solana + EVM simultaneously
• MEV protection: Route through Jito (Solana) / Flashbots (EVM)
• Stop-loss automation: Autonomous sell triggers on drawdown
• Backtesting module: Replay historical DEX data against the agent pipeline
• Plugin system: Let users add custom analysts without modifying core