AI Trading Research Agent
When to Use
- User wants an AI agent to do market research and present trade ideas — but user decides what to actually trade
- Building cron-driven market briefs, watchlist scanners, or trade journaling systems
- Evaluating free data APIs (Finnhub, Alpha Vantage, Alpaca) for trading agent use
- Designing the human-in-the-loop pattern: agent proposes, human disposes
Core Architecture
YOU (decide entry/exit/position size)
↑
AGENT (research + signals + tracking)
├── Cron: Pre-market scan (30 min before open)
├── Cron: Intraday alerts (price levels, news)
├── Cron: End-of-day journal + P&L
└── On-demand: "What do you think about X?"
The Five Pillars
- Pre-market research — news scan, economic calendar, earnings, sentiment
- Screening — filter watchlist by technical criteria (MA, volume, RSI, etc.)
- Signal generation — specific trade ideas with entry, stop, target, and reasoning
- Trade journaling — log every idea, entry/exit, P&L, and reasoning
- Post-trade analysis — review what worked, what didn't, adjust
Human-in-the-Loop Rules (Hard Constraints)
- Agent never places trades. Always present ideas as proposals.
- Always include: ticker, direction (long/short), entry level, stop loss, target, and 1-sentence reasoning.
- User must explicitly confirm before any trade is recorded as "entered."
- Track closed trades with actual P&L vs projected P&L.
- Agent's track record is always visible — no survivorship bias.
Data Sources (Free Tier)
See references/data-sources.md for detailed API comparison, rate limits, and setup.
Quick reference:
- Finnhub (60 calls/min free) — real-time quotes, news, earnings, economic calendar. Best all-rounder.
- Alpaca (paper trading free) — paper trading API + market data. Commission-free. Use paper keys for development.
- Alpha Vantage (25 calls/day free) — historical data, technical indicators. Good for backtesting.
- Yahoo Finance (unofficial) — backup for quotes and basic data.
Cron Pattern for Market Briefs
Three standard schedules for a US equities-focused trading agent:
| Job |
Time |
Purpose |
| Morning brief |
9:15 AM ET (pre-market) |
News, watchlist scan, levels, ideas |
| Intraday check |
12:00 PM ET |
Price alerts, breaking news, position updates |
| End-of-day |
4:30 PM ET |
Journal entries, P&L summary, tomorrow's watch |
For crypto (24/7): run every 4-6 hours instead of market-hours-based.
Bait vs Real (What to Ignore on X)
Red flags (probably bait):
- "I gave AI $150 and it made $XX,XXx" — no risk management shown, survivorship bias
- "Fully autonomous trader" — nobody serious runs fully autonomous without kill switches
- "Just connect ChatGPT to your broker" — that's gambling, not a strategy
- No mention of position sizing, stop losses, or track record over 50+ trades
Green flags (probably real):
- Starts with paper trading, shows actual track record
- Has explicit risk rules (max position size, stop losses, etc.)
- Shows the full workflow: data → analysis → decision → journal
- Acknowledges the human makes final decisions
Integration with Multi-Agent Discord
If the user runs a multi-agent Discord setup (reference: project-workspace skill), the trading researcher fits as:
- A dedicated profile (e.g.,
trader profile with its own Discord bot)
- Home channel like
#trading-ideas or #market-briefs
- Cron jobs deliver scheduled briefs to the channel
- User replies in-thread to confirm/decline trade ideas
- Writer agent can format trade reviews; Analyst agent can compute stats
Pitfalls
- Don't over-automate early. Start with morning brief cron only, add others after 2 weeks of use.
- Free API limits are real. Finnhub allows 60 calls/min — if scanning 50+ tickers, batch or sequence calls.
- Paper trade first. Even if the user plans real trades, run the agent on paper for 30+ trades to validate the workflow.
- Journal or die. The agent is useless without tracking which ideas played out. Make the journal cron non-negotiable.
- Timezone matters. Cron times should be in ET for US markets, UTC for crypto. Label all cron schedules with timezone.
1---2name: ai-trading-research3description: AI-assisted trading research agent — builds agents that research markets, generate trade signals, and track P&L, while the human makes all execution decisions. Covers architecture, data sources, cron scheduling, and the human-in-the-loop pattern.4---5
6# AI Trading Research Agent
7
8## When to Use
9
10- User wants an AI agent to do market research and present trade ideas — but user decides what to actually trade
11- Building cron-driven market briefs, watchlist scanners, or trade journaling systems
12- Evaluating free data APIs (Finnhub, Alpha Vantage, Alpaca) for trading agent use
13- Designing the human-in-the-loop pattern: agent proposes, human disposes
14
15## Core Architecture
16
17```
18YOU (decide entry/exit/position size)
19 ↑
20AGENT (research + signals + tracking)
21 ├── Cron: Pre-market scan (30 min before open)
22 ├── Cron: Intraday alerts (price levels, news)
23 ├── Cron: End-of-day journal + P&L
24 └── On-demand: "What do you think about X?"
25```
26
27### The Five Pillars
28
291. **Pre-market research** — news scan, economic calendar, earnings, sentiment
302. **Screening** — filter watchlist by technical criteria (MA, volume, RSI, etc.)
313. **Signal generation** — specific trade ideas with entry, stop, target, and reasoning
324. **Trade journaling** — log every idea, entry/exit, P&L, and reasoning
335. **Post-trade analysis** — review what worked, what didn't, adjust
34
35## Human-in-the-Loop Rules (Hard Constraints)
36
37- **Agent never places trades.** Always present ideas as proposals.
38- Always include: ticker, direction (long/short), entry level, stop loss, target, and 1-sentence reasoning.
39- User must explicitly confirm before any trade is recorded as "entered."
40- Track closed trades with actual P&L vs projected P&L.
41- Agent's track record is always visible — no survivorship bias.
42
43## Data Sources (Free Tier)
44
45See `references/data-sources.md` for detailed API comparison, rate limits, and setup.
46
47Quick reference:
48- **Finnhub** (60 calls/min free) — real-time quotes, news, earnings, economic calendar. Best all-rounder.
49- **Alpaca** (paper trading free) — paper trading API + market data. Commission-free. Use paper keys for development.
50- **Alpha Vantage** (25 calls/day free) — historical data, technical indicators. Good for backtesting.
51- **Yahoo Finance** (unofficial) — backup for quotes and basic data.
52
53## Cron Pattern for Market Briefs
54
55Three standard schedules for a US equities-focused trading agent:
56
57| Job | Time | Purpose |
58|-----|------|---------|
59| Morning brief | 9:15 AM ET (pre-market) | News, watchlist scan, levels, ideas |
60| Intraday check | 12:00 PM ET | Price alerts, breaking news, position updates |
61| End-of-day | 4:30 PM ET | Journal entries, P&L summary, tomorrow's watch |
62
63For crypto (24/7): run every 4-6 hours instead of market-hours-based.
64
65## Bait vs Real (What to Ignore on X)
66
67**Red flags (probably bait):**
68- "I gave AI $150 and it made $XX,XXx" — no risk management shown, survivorship bias
69- "Fully autonomous trader" — nobody serious runs fully autonomous without kill switches
70- "Just connect ChatGPT to your broker" — that's gambling, not a strategy
71- No mention of position sizing, stop losses, or track record over 50+ trades
72
73**Green flags (probably real):**
74- Starts with paper trading, shows actual track record
75- Has explicit risk rules (max position size, stop losses, etc.)
76- Shows the full workflow: data → analysis → decision → journal
77- Acknowledges the human makes final decisions
78
79## Integration with Multi-Agent Discord
80
81If the user runs a multi-agent Discord setup (reference: `project-workspace` skill), the trading researcher fits as:
82- A dedicated profile (e.g., `trader` profile with its own Discord bot)
83- Home channel like `#trading-ideas` or `#market-briefs`
84- Cron jobs deliver scheduled briefs to the channel
85- User replies in-thread to confirm/decline trade ideas
86- Writer agent can format trade reviews; Analyst agent can compute stats
87
88## Pitfalls
89
90- **Don't over-automate early.** Start with morning brief cron only, add others after 2 weeks of use.
91- **Free API limits are real.** Finnhub allows 60 calls/min — if scanning 50+ tickers, batch or sequence calls.
92- **Paper trade first.** Even if the user plans real trades, run the agent on paper for 30+ trades to validate the workflow.
93- **Journal or die.** The agent is useless without tracking which ideas played out. Make the journal cron non-negotiable.
94- **Timezone matters.** Cron times should be in ET for US markets, UTC for crypto. Label all cron schedules with timezone.