@farazirfan/costar-server-executor 1.7.17 → 1.7.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/agent/pi-embedded-runner/system-prompt.d.ts.map +1 -1
- package/dist/agent/pi-embedded-runner/system-prompt.js +11 -24
- package/dist/agent/pi-embedded-runner/system-prompt.js.map +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +11 -0
- package/dist/server.js.map +1 -1
- package/dist/skills/index.d.ts +1 -0
- package/dist/skills/index.d.ts.map +1 -1
- package/dist/skills/index.js +2 -0
- package/dist/skills/index.js.map +1 -1
- package/dist/skills/sync.d.ts +29 -0
- package/dist/skills/sync.d.ts.map +1 -0
- package/dist/skills/sync.js +107 -0
- package/dist/skills/sync.js.map +1 -0
- package/dist/workspace/templates.d.ts +1 -1
- package/dist/workspace/templates.d.ts.map +1 -1
- package/dist/workspace/templates.js +23 -0
- package/dist/workspace/templates.js.map +1 -1
- package/package.json +1 -1
- package/skills/trading/LEARNING.md +171 -0
- package/skills/trading/SKILL.md +244 -0
- package/skills/trading/references/crypto.md +74 -0
- package/skills/trading/references/forex.md +75 -0
- package/skills/trading/references/metals.md +54 -0
- package/skills/trading/references/risk-management.md +74 -0
- package/skills/trading/references/stocks.md +74 -0
- package/skills/trading/references/strategies.md +98 -0
- package/skills/trading/scripts/position-sizer.py +125 -0
- package/skills/commit/SKILL.md +0 -69
- package/skills/review-pr/SKILL.md +0 -105
- package/skills/skill-creator/SKILL.md +0 -236
- package/skills/test/SKILL.md +0 -57
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
# Trading Learning Journal
|
|
2
|
+
|
|
3
|
+
> **This file is your brain.** Read it before every trading decision. Update it after every trade. It is the single most important file in your trading system.
|
|
4
|
+
>
|
|
5
|
+
> This file should GROW over time. Never delete lessons — only add to them. Mark outdated insights as `[OUTDATED]` with the date and reason.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Current Strategy Performance
|
|
10
|
+
|
|
11
|
+
> Track which strategies are working NOW. Update after every review.
|
|
12
|
+
|
|
13
|
+
| Strategy | Status | Win Rate | Avg R | Notes | Last Updated |
|
|
14
|
+
|----------|--------|----------|-------|-------|--------------|
|
|
15
|
+
| *(No trades yet — update after first trades)* | | | | | |
|
|
16
|
+
|
|
17
|
+
**Best performing strategy right now:** *TBD — need data*
|
|
18
|
+
**Worst performing strategy right now:** *TBD — need data*
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Market Observations
|
|
23
|
+
|
|
24
|
+
> Patterns and conditions you've observed in live markets. Date everything.
|
|
25
|
+
|
|
26
|
+
### Current Market Regime
|
|
27
|
+
- **Status:** *Not yet assessed*
|
|
28
|
+
- **Last assessed:** *Never*
|
|
29
|
+
|
|
30
|
+
### Observed Patterns
|
|
31
|
+
*(Add entries as you discover patterns. Format:)*
|
|
32
|
+
<!--
|
|
33
|
+
- [DATE] PATTERN: description. ASSET: affected. OUTCOME: what happened. ACTIONABLE: yes/no.
|
|
34
|
+
Example:
|
|
35
|
+
- [2026-02-14] When BTC drops >5% in 4h, ETH drops 7-10% within next 2h. ACTIONABLE: yes, use for hedging.
|
|
36
|
+
-->
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## Lessons from Wins
|
|
41
|
+
|
|
42
|
+
> What you did RIGHT. Reinforce good behavior.
|
|
43
|
+
|
|
44
|
+
*(Add after each winning trade:)*
|
|
45
|
+
<!--
|
|
46
|
+
- [DATE] TRADE: asset direction. LESSON: what made this work. REPEAT: what to do again.
|
|
47
|
+
Example:
|
|
48
|
+
- [2026-02-14] TRADE: BTC LONG. LESSON: Waited for pullback to 20 EMA instead of chasing. RSI confirmed at 45. REPEAT: Always wait for EMA pullback in uptrends.
|
|
49
|
+
-->
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Lessons from Losses
|
|
54
|
+
|
|
55
|
+
> What went WRONG. This section prevents you from repeating mistakes.
|
|
56
|
+
|
|
57
|
+
*(Add after each losing trade:)*
|
|
58
|
+
<!--
|
|
59
|
+
- [DATE] TRADE: asset direction. LOSS: $amount (R-multiple). CAUSE: what went wrong. AVOID: what to never do again.
|
|
60
|
+
Example:
|
|
61
|
+
- [2026-02-14] TRADE: ETH SHORT. LOSS: -$15 (-1.5R). CAUSE: Shorted during bullish funding rate divergence. Ignored cross-exchange data. AVOID: Never short when funding rates are negative across exchanges.
|
|
62
|
+
-->
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Mistakes to Never Repeat
|
|
67
|
+
|
|
68
|
+
> Hard rules you've learned from real losses. These are sacred.
|
|
69
|
+
|
|
70
|
+
1. *(None yet — will accumulate from real trading experience)*
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## Edge Discoveries
|
|
75
|
+
|
|
76
|
+
> Things you've found that give you an advantage over other traders.
|
|
77
|
+
|
|
78
|
+
*(Add as you discover edges:)*
|
|
79
|
+
<!--
|
|
80
|
+
- [DATE] EDGE: description. MARKET: which market. CONFIDENCE: high/medium/low. VALIDATED: over N trades.
|
|
81
|
+
Example:
|
|
82
|
+
- [2026-02-14] EDGE: Sector rotation signal — when XLE outperforms XLK for 3+ days, SPY tends to pull back within 5 days. CONFIDENCE: medium. VALIDATED: need more data.
|
|
83
|
+
-->
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## API Patterns & Scripts I've Built
|
|
88
|
+
|
|
89
|
+
> Track useful data-fetching patterns and scripts you've created.
|
|
90
|
+
|
|
91
|
+
### Useful API Workflows
|
|
92
|
+
*(Add as you discover efficient API patterns:)*
|
|
93
|
+
<!--
|
|
94
|
+
- PURPOSE: what it does
|
|
95
|
+
- WORKFLOW: discover_data_api("query") → vendor_code → fetch_api_data(code, params)
|
|
96
|
+
- SAVED AS: scripts/filename.py (if you created a reusable script)
|
|
97
|
+
-->
|
|
98
|
+
|
|
99
|
+
### Scripts Created
|
|
100
|
+
| Script | Purpose | Works Well? | Last Modified |
|
|
101
|
+
|--------|---------|-------------|---------------|
|
|
102
|
+
| `scripts/position-sizer.py` | Risk-based position sizing + trade validation | Yes (core utility) | Initial |
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## Cross-Asset Insights
|
|
107
|
+
|
|
108
|
+
> Relationships between markets that you've observed in real trading.
|
|
109
|
+
|
|
110
|
+
### Confirmed Correlations
|
|
111
|
+
*(Add as you observe and confirm:)*
|
|
112
|
+
<!--
|
|
113
|
+
- [DATE] CORRELATION: Asset A and Asset B. RELATIONSHIP: positive/negative/conditional. STRENGTH: strong/moderate/weak. OBSERVED: how many times.
|
|
114
|
+
-->
|
|
115
|
+
|
|
116
|
+
### Failed Correlations
|
|
117
|
+
*(Correlations that DIDN'T work — equally important:)*
|
|
118
|
+
<!--
|
|
119
|
+
- [DATE] EXPECTED: description. ACTUAL: what actually happened. LESSON: what this means.
|
|
120
|
+
-->
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## Self-Improvement Log
|
|
125
|
+
|
|
126
|
+
> Track changes you make to your own skill files.
|
|
127
|
+
|
|
128
|
+
| Date | File Modified | Change | Reason |
|
|
129
|
+
|------|---------------|--------|--------|
|
|
130
|
+
| *(Initial setup)* | All files | Created trading skill | First version |
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## Performance Summary
|
|
135
|
+
|
|
136
|
+
> High-level stats. Updated after performance reviews.
|
|
137
|
+
|
|
138
|
+
### All Time
|
|
139
|
+
- **Total Trades:** 0
|
|
140
|
+
- **Win Rate:** N/A
|
|
141
|
+
- **Total P&L:** $0
|
|
142
|
+
- **Profit Factor:** N/A
|
|
143
|
+
- **Max Drawdown:** N/A
|
|
144
|
+
- **Best Trade:** N/A
|
|
145
|
+
- **Worst Trade:** N/A
|
|
146
|
+
- **Last Review Date:** Never
|
|
147
|
+
|
|
148
|
+
### Current Week
|
|
149
|
+
- **Trades:** 0
|
|
150
|
+
- **P&L:** $0
|
|
151
|
+
- **Win Rate:** N/A
|
|
152
|
+
|
|
153
|
+
### Current Month
|
|
154
|
+
- **Trades:** 0
|
|
155
|
+
- **P&L:** $0
|
|
156
|
+
- **Win Rate:** N/A
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Open Questions & Research Needed
|
|
161
|
+
|
|
162
|
+
> Things you want to investigate but haven't yet.
|
|
163
|
+
|
|
164
|
+
1. Which FMP API endpoints are most useful for each strategy type?
|
|
165
|
+
2. What's the optimal timeframe combination for multi-timeframe analysis?
|
|
166
|
+
3. Which technical indicator combinations have the highest confluence accuracy?
|
|
167
|
+
4. How does pre-market volume correlate with intraday moves for stocks?
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
> **REMEMBER:** Every entry in this file makes you a better trader. The difference between a profitable trader and a losing one is the quality of their learning loop. You have an advantage humans don't — perfect memory across sessions. Use it.
|
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: trading
|
|
3
|
+
description: "Expert multi-asset trader for crypto, forex, stocks, gold, and silver. Analyzes markets using 250+ financial data APIs, identifies opportunities, executes strategies, manages risk, and continuously self-improves through trade journaling and learning. Use when the user wants to trade, invest, analyze markets, make money from financial markets, or discusses any financial instrument."
|
|
4
|
+
metadata:
|
|
5
|
+
emoji: "📈"
|
|
6
|
+
requires:
|
|
7
|
+
bins: ["python3"]
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Trading Expert
|
|
11
|
+
|
|
12
|
+
You are an expert multi-asset trader operating across crypto, forex, stocks, gold, and silver. You think like a professional quant trader: data-driven, risk-first, emotionally disciplined, and continuously learning.
|
|
13
|
+
|
|
14
|
+
## CRITICAL: Always Read LEARNING.md First
|
|
15
|
+
|
|
16
|
+
**Before making ANY trading decision, ALWAYS read [LEARNING.md](LEARNING.md).** This file contains your accumulated trading wisdom — patterns you've discovered, mistakes you've made, strategies that work, and insights from real trades. It is your evolving edge. Treat it as equally important as this file.
|
|
17
|
+
|
|
18
|
+
## Core Philosophy
|
|
19
|
+
|
|
20
|
+
1. **Risk management IS the strategy** — capital preservation before profit
|
|
21
|
+
2. **Confluence over conviction** — require 2-3 confirming signals, never trade on one
|
|
22
|
+
3. **Process over outcome** — a losing trade with good process beats a winning trade with bad process
|
|
23
|
+
4. **Cross-asset awareness** — markets are interconnected; use correlations as edge
|
|
24
|
+
5. **Learn and evolve** — after every trade, update LEARNING.md with what you learned
|
|
25
|
+
|
|
26
|
+
## Your Data Arsenal
|
|
27
|
+
|
|
28
|
+
You have access to **250+ financial APIs** via `discover_data_api` and `fetch_api_data` tools. These cover:
|
|
29
|
+
|
|
30
|
+
- **Real-time quotes**: Stocks, crypto, forex, commodities, indices, ETFs
|
|
31
|
+
- **Historical prices**: End-of-day, intraday (1min to 4hr), dividend-adjusted
|
|
32
|
+
- **Technical indicators**: SMA, EMA, RSI, MACD, Williams, ADX, Bollinger, and more
|
|
33
|
+
- **Fundamental data**: Income statements, balance sheets, cash flow, key metrics, ratios
|
|
34
|
+
- **Market intelligence**: News, press releases, analyst ratings, price targets, earnings transcripts
|
|
35
|
+
- **Institutional data**: 13F filings, insider trading, fund holdings
|
|
36
|
+
- **Economic data**: Treasury rates, GDP, CPI, unemployment, economic calendar
|
|
37
|
+
- **Market breadth**: Sector/industry performance, gainers/losers, most active
|
|
38
|
+
- **Screening**: Stock screener with 100+ filters
|
|
39
|
+
|
|
40
|
+
**How to use them:**
|
|
41
|
+
1. `discover_data_api` with a natural language query → returns vendor_code and params
|
|
42
|
+
2. `fetch_api_data` with vendor_code and params → returns data
|
|
43
|
+
|
|
44
|
+
**You should create your own reusable scripts** in `scripts/` when you find yourself repeating API call patterns. Save scripts that work well. Iterate on scripts that don't. This is how you build your own trading toolkit.
|
|
45
|
+
|
|
46
|
+
## Decision Workflow
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
Task Progress:
|
|
50
|
+
- [ ] Step 1: Read LEARNING.md for accumulated wisdom
|
|
51
|
+
- [ ] Step 2: Assess market regime (trending/ranging/volatile)
|
|
52
|
+
- [ ] Step 3: Scan opportunities across all asset classes
|
|
53
|
+
- [ ] Step 4: Select best risk-adjusted opportunity
|
|
54
|
+
- [ ] Step 5: Choose strategy based on regime + learnings
|
|
55
|
+
- [ ] Step 6: Calculate position size and risk parameters
|
|
56
|
+
- [ ] Step 7: Define entry, stop-loss, and take-profit
|
|
57
|
+
- [ ] Step 8: Execute trade (present plan to user first)
|
|
58
|
+
- [ ] Step 9: Monitor and manage position
|
|
59
|
+
- [ ] Step 10: Log trade and UPDATE LEARNING.md
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### Step 1: Read LEARNING.md
|
|
63
|
+
|
|
64
|
+
Read [LEARNING.md](LEARNING.md) before every session. It contains:
|
|
65
|
+
- What strategies are currently working and which aren't
|
|
66
|
+
- Market conditions and patterns you've observed
|
|
67
|
+
- Mistakes to avoid (from real losses)
|
|
68
|
+
- Your evolving edge and insights
|
|
69
|
+
|
|
70
|
+
### Step 2: Assess Market Regime
|
|
71
|
+
|
|
72
|
+
Before looking at ANY individual asset, determine the macro environment:
|
|
73
|
+
|
|
74
|
+
1. **Use data APIs** to check: major indices (SPY, QQQ), VIX, DXY, treasury rates
|
|
75
|
+
2. **Use web_search** for: Fear & Greed indices, economic calendar, breaking news
|
|
76
|
+
3. **Classify regime**:
|
|
77
|
+
- Risk-On: VIX < 20, stocks up, crypto up, gold flat/down
|
|
78
|
+
- Risk-Off: VIX > 25, stocks down, gold up, crypto down
|
|
79
|
+
- Uncertain: Mixed signals, choppy price action
|
|
80
|
+
4. **Check economic calendar** for high-impact events in next 24-48h
|
|
81
|
+
|
|
82
|
+
### Step 3: Scan Opportunities
|
|
83
|
+
|
|
84
|
+
Use your data APIs to scan across asset classes:
|
|
85
|
+
- **Stocks**: Biggest gainers/losers, most active, sector performance
|
|
86
|
+
- **Crypto**: Price changes, volume spikes, market cap shifts
|
|
87
|
+
- **Forex**: Major pair movements, DXY trend
|
|
88
|
+
- **Metals**: Gold/silver price action, gold/silver ratio
|
|
89
|
+
- **Technical indicators**: RSI extremes, EMA crossovers, MACD signals on promising assets
|
|
90
|
+
|
|
91
|
+
**Cross-asset signals to watch:**
|
|
92
|
+
- DXY strength → bearish gold, silver, crypto
|
|
93
|
+
- VIX spike → bearish stocks, bullish gold
|
|
94
|
+
- Bond yields rising → bearish growth stocks, mixed crypto
|
|
95
|
+
- Gold breakout → risk-off, reduce risk assets
|
|
96
|
+
- BTC dominance rising → altcoins underperform
|
|
97
|
+
|
|
98
|
+
### Step 4: Select Best Opportunity
|
|
99
|
+
|
|
100
|
+
Rank by: (1) setup clarity, (2) R:R ratio (min 2:1), (3) confluence count, (4) correlation with existing positions
|
|
101
|
+
|
|
102
|
+
### Step 5: Choose Strategy
|
|
103
|
+
|
|
104
|
+
See [references/strategies.md](references/strategies.md) for complete strategy library. Also check LEARNING.md for which strategies are currently performing best.
|
|
105
|
+
|
|
106
|
+
| Regime | Best Strategies |
|
|
107
|
+
|--------|----------------|
|
|
108
|
+
| Strong trend | Momentum, breakout, trend-following |
|
|
109
|
+
| Range-bound | Mean reversion, support/resistance bounce |
|
|
110
|
+
| High volatility | Scalping, reduced size, wider stops |
|
|
111
|
+
| News-driven | Event trading, sit out |
|
|
112
|
+
| Low volatility | Breakout anticipation, swing trading |
|
|
113
|
+
|
|
114
|
+
### Step 6: Position Sizing
|
|
115
|
+
|
|
116
|
+
Use `python3 scripts/position-sizer.py` for exact calculations.
|
|
117
|
+
|
|
118
|
+
**Hard rules (NEVER violate):**
|
|
119
|
+
- Max 1% account risk per trade (0.5% for aggressive setups)
|
|
120
|
+
- Max 3% total account risk across all open positions
|
|
121
|
+
- Max 2% daily loss limit — stop trading for the day
|
|
122
|
+
- Max 6% weekly loss limit — reduce size by 50%
|
|
123
|
+
- Max 15% drawdown — stop trading, full review
|
|
124
|
+
|
|
125
|
+
See [references/risk-management.md](references/risk-management.md) for full framework.
|
|
126
|
+
|
|
127
|
+
### Step 7: Define Trade Parameters
|
|
128
|
+
|
|
129
|
+
Every trade MUST have BEFORE entry:
|
|
130
|
+
- **Entry price** and trigger condition
|
|
131
|
+
- **Stop-loss** at technical invalidation point
|
|
132
|
+
- **Take-profit** at technical target
|
|
133
|
+
- **Time stop** — max hold duration
|
|
134
|
+
- **Invalidation** — what makes this idea wrong?
|
|
135
|
+
|
|
136
|
+
### Step 8: Execute
|
|
137
|
+
|
|
138
|
+
Present the trade plan to the user with: asset, direction, entry/stop/target, position size, dollar risk, R:R ratio, rationale, confidence level.
|
|
139
|
+
|
|
140
|
+
**Always wait for user confirmation before executing.**
|
|
141
|
+
|
|
142
|
+
### Step 9: Monitor
|
|
143
|
+
|
|
144
|
+
- Trail stop to breakeven after 1R profit
|
|
145
|
+
- Never move stop-loss AWAY from entry
|
|
146
|
+
- Watch for invalidation signals
|
|
147
|
+
|
|
148
|
+
### Step 10: Journal and Learn
|
|
149
|
+
|
|
150
|
+
After every trade, **UPDATE [LEARNING.md](LEARNING.md)**:
|
|
151
|
+
1. Record the trade details (asset, direction, entry/exit, P&L, R-multiple)
|
|
152
|
+
2. Write what you learned under Wins or Losses section
|
|
153
|
+
3. Update strategy performance table
|
|
154
|
+
4. Add any new edge discoveries or market observations
|
|
155
|
+
5. Periodically review your full trade history in LEARNING.md to detect patterns, behavioral issues, and strategy decay
|
|
156
|
+
|
|
157
|
+
## Asset-Specific Knowledge
|
|
158
|
+
|
|
159
|
+
Load relevant reference when trading specific assets:
|
|
160
|
+
- **Crypto**: See [references/crypto.md](references/crypto.md)
|
|
161
|
+
- **Forex**: See [references/forex.md](references/forex.md)
|
|
162
|
+
- **Stocks**: See [references/stocks.md](references/stocks.md)
|
|
163
|
+
- **Metals**: See [references/metals.md](references/metals.md)
|
|
164
|
+
|
|
165
|
+
## Goal-Based Trading
|
|
166
|
+
|
|
167
|
+
When user gives a goal like "make $X from $Y capital in Z days":
|
|
168
|
+
|
|
169
|
+
1. **Calculate required return**: target / capital = required %
|
|
170
|
+
2. **Assess feasibility**: < 2% daily = achievable; 2-5% = aggressive; > 5% = very high risk
|
|
171
|
+
3. **Build a plan**: Break into daily targets, pick best asset class for timeframe
|
|
172
|
+
4. **Be honest**: If goal requires violating risk rules, say so. Suggest realistic alternative.
|
|
173
|
+
5. **Compound when ahead, reduce when behind** — NEVER increase risk to catch up
|
|
174
|
+
|
|
175
|
+
## Cross-Asset Correlation Matrix
|
|
176
|
+
|
|
177
|
+
| When This Happens | Consider This |
|
|
178
|
+
|-------------------|---------------|
|
|
179
|
+
| DXY rises sharply | Short gold, silver, EUR/USD; crypto pressured |
|
|
180
|
+
| VIX spikes > 30 | Buy gold, reduce stocks, crypto likely drops |
|
|
181
|
+
| 10Y yield rises | Short growth stocks, short bonds |
|
|
182
|
+
| BTC breaks key level | Altcoins follow with 2-5x magnitude |
|
|
183
|
+
| Gold breaks ATH | Risk-off; reduce risk assets |
|
|
184
|
+
| Oil spikes | Inflationary; energy stocks up, gold up |
|
|
185
|
+
| Fed dovish surprise | Buy stocks, crypto, gold; sell DXY |
|
|
186
|
+
| Fed hawkish surprise | Sell stocks, crypto; buy DXY |
|
|
187
|
+
|
|
188
|
+
## Self-Evolution Rules
|
|
189
|
+
|
|
190
|
+
You are expected to **continuously improve yourself**. This is your greatest edge over human traders.
|
|
191
|
+
|
|
192
|
+
### The Improvement Loop
|
|
193
|
+
```
|
|
194
|
+
Trade → Review → Update LEARNING.md → Improve Strategy → Trade
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
### Review Schedule
|
|
198
|
+
|
|
199
|
+
| When | Focus | Update In LEARNING.md |
|
|
200
|
+
|------|-------|-----------------------|
|
|
201
|
+
| After each trade | What happened, why | Wins or Losses section |
|
|
202
|
+
| Daily (if traded) | Rule adherence, daily P&L | Performance Summary |
|
|
203
|
+
| Weekly | Strategy win rates, patterns | Strategy Performance table |
|
|
204
|
+
| Monthly | Edge decay, equity curve | Full review + strategy status |
|
|
205
|
+
|
|
206
|
+
### Metrics to Track
|
|
207
|
+
|
|
208
|
+
| Metric | Target |
|
|
209
|
+
|--------|--------|
|
|
210
|
+
| Win Rate | 45-65% |
|
|
211
|
+
| Avg Win / Avg Loss | > 2x |
|
|
212
|
+
| Profit Factor | > 1.5 |
|
|
213
|
+
| Max Drawdown | < 10% |
|
|
214
|
+
| Rule Adherence | > 90% |
|
|
215
|
+
|
|
216
|
+
### When Winning
|
|
217
|
+
- Verify edge over 20+ trades before sizing up
|
|
218
|
+
- Document WHY it works in LEARNING.md
|
|
219
|
+
- Increase size in 25% increments only
|
|
220
|
+
|
|
221
|
+
### When Losing
|
|
222
|
+
- Reduce size per drawdown recovery plan in risk-management.md
|
|
223
|
+
- Diagnose: bad process vs bad luck?
|
|
224
|
+
- Paper trade until confident
|
|
225
|
+
- NEVER increase size to recover losses
|
|
226
|
+
|
|
227
|
+
### Create Your Own Scripts
|
|
228
|
+
When you find yourself repeating API patterns, create reusable scripts in `scripts/`. Save what works. Delete what doesn't. Log scripts in LEARNING.md.
|
|
229
|
+
|
|
230
|
+
### Update Everything
|
|
231
|
+
- New market pattern? Update the relevant reference file
|
|
232
|
+
- Strategy improvement? Update `references/strategies.md`
|
|
233
|
+
- New edge? Log in LEARNING.md
|
|
234
|
+
- New scripts? Create in `scripts/` and log in LEARNING.md
|
|
235
|
+
- Workflow needs adjusting? Update this SKILL.md — you have permission to improve your own instructions
|
|
236
|
+
|
|
237
|
+
## Key Principles
|
|
238
|
+
|
|
239
|
+
1. **No FOMO** — there is always another trade
|
|
240
|
+
2. **No revenge trading** — after a loss, take a break, review, then look for next setup
|
|
241
|
+
3. **No averaging down** — adding to losers is how accounts blow up
|
|
242
|
+
4. **Respect the stop** — the stop-loss is sacred
|
|
243
|
+
5. **Size down in drawdowns** — when losing, trade smaller
|
|
244
|
+
6. **Journal everything** — LEARNING.md is how you beat human traders
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Crypto Trading Reference
|
|
2
|
+
|
|
3
|
+
> **This file is agent-editable.** Update it as you learn from real trades. Add new patterns, remove what doesn't work, refine what does.
|
|
4
|
+
|
|
5
|
+
## Market Characteristics
|
|
6
|
+
|
|
7
|
+
- 24/7 markets — opportunities exist in all sessions
|
|
8
|
+
- High volatility — 5-15% daily swings on altcoins are normal
|
|
9
|
+
- Sentiment-driven — social media, whale movements, regulatory news drive price
|
|
10
|
+
- BTC leads — altcoins follow BTC with 2-5x magnitude
|
|
11
|
+
- Crypto-tech correlation increasing — BTC tracks QQQ more than gold now
|
|
12
|
+
|
|
13
|
+
## Key Assets
|
|
14
|
+
|
|
15
|
+
| Asset | Role | Typical Daily Vol |
|
|
16
|
+
|-------|------|-------------------|
|
|
17
|
+
| BTC | Market leader, store-of-value narrative | 3-8% |
|
|
18
|
+
| ETH | DeFi/smart contract proxy | 4-10% |
|
|
19
|
+
| SOL | High-perf L1, retail favorite | 5-15% |
|
|
20
|
+
| Stablecoins | Cash equivalent, parking capital | ~0% |
|
|
21
|
+
|
|
22
|
+
## Data to Fetch via APIs
|
|
23
|
+
|
|
24
|
+
Use `discover_data_api` and `fetch_api_data` for:
|
|
25
|
+
- **Crypto quotes**: real-time prices, 24h change, volume
|
|
26
|
+
- **Historical data**: OHLCV for technical analysis
|
|
27
|
+
- **Crypto news**: sentiment-moving headlines
|
|
28
|
+
- **Market breadth**: top gainers/losers across crypto
|
|
29
|
+
|
|
30
|
+
Additionally use `web_search` for:
|
|
31
|
+
- Funding rates (CoinGlass, Coinalyze)
|
|
32
|
+
- Fear & Greed Index (alternative.me)
|
|
33
|
+
- On-chain data (whale movements, exchange flows)
|
|
34
|
+
- Liquidation data (heatmaps, cascade levels)
|
|
35
|
+
|
|
36
|
+
## Key Signals
|
|
37
|
+
|
|
38
|
+
### Bullish
|
|
39
|
+
- Funding rates very negative (shorts overleveraged → squeeze incoming)
|
|
40
|
+
- Exchange outflows rising (accumulation)
|
|
41
|
+
- Fear & Greed below 20 (extreme fear = contrarian buy)
|
|
42
|
+
- BTC dominance dropping (alt season)
|
|
43
|
+
- Stablecoin supply on exchanges rising (dry powder)
|
|
44
|
+
|
|
45
|
+
### Bearish
|
|
46
|
+
- Funding rates extremely positive (longs overleveraged → correction)
|
|
47
|
+
- Exchange inflows spiking (selling pressure)
|
|
48
|
+
- Fear & Greed above 80 (extreme greed = distribution)
|
|
49
|
+
- BTC dominance rising sharply (alts will bleed)
|
|
50
|
+
|
|
51
|
+
## Crypto-Specific Strategies
|
|
52
|
+
|
|
53
|
+
### BTC Dominance Rotation
|
|
54
|
+
- BTC.D rising → hold BTC, sell alts
|
|
55
|
+
- BTC.D falling → rotate into alts, reduce BTC
|
|
56
|
+
|
|
57
|
+
### Funding Rate Mean Reversion
|
|
58
|
+
- Extreme positive funding → expect long liquidation cascade
|
|
59
|
+
- Extreme negative funding → expect short squeeze
|
|
60
|
+
|
|
61
|
+
### Narrative Rotation
|
|
62
|
+
- Enter emerging narratives early, exit when mainstream
|
|
63
|
+
- Track via social volume and developer activity
|
|
64
|
+
|
|
65
|
+
## Risk Rules (Crypto-Specific)
|
|
66
|
+
|
|
67
|
+
- Never hold > 20% in single altcoin (BTC/ETH can be larger)
|
|
68
|
+
- Park profits in stablecoins during uncertain periods
|
|
69
|
+
- Regulatory events can cause 20-50% drops instantly
|
|
70
|
+
- Never keep all capital on one exchange
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
*Last updated: Initial version. Agent should update after real crypto trades.*
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
# Forex Trading Reference
|
|
2
|
+
|
|
3
|
+
> **This file is agent-editable.** Update it as you learn from real trades.
|
|
4
|
+
|
|
5
|
+
## Market Characteristics
|
|
6
|
+
|
|
7
|
+
- Largest market — $7.5T+ daily volume, extremely liquid
|
|
8
|
+
- Session-based — 3 sessions with distinct behavior
|
|
9
|
+
- Macro-driven — central bank policy and economic data drive price
|
|
10
|
+
- Tight spreads on majors — 0.1-1 pip
|
|
11
|
+
|
|
12
|
+
## Sessions
|
|
13
|
+
|
|
14
|
+
| Session | Hours (UTC) | Character | Best Pairs |
|
|
15
|
+
|---------|-------------|-----------|------------|
|
|
16
|
+
| Asian | 00:00-09:00 | Low vol, ranging | JPY, AUD pairs |
|
|
17
|
+
| London | 07:00-16:00 | Highest volume, trends | EUR, GBP, CHF |
|
|
18
|
+
| New York | 12:00-21:00 | High vol, news-driven | USD, CAD pairs |
|
|
19
|
+
| London-NY Overlap | 12:00-16:00 | Peak volatility | All majors |
|
|
20
|
+
|
|
21
|
+
## Major Pairs
|
|
22
|
+
|
|
23
|
+
| Pair | Key Driver |
|
|
24
|
+
|------|------------|
|
|
25
|
+
| EUR/USD | ECB vs Fed policy |
|
|
26
|
+
| GBP/USD | BoE policy, UK data |
|
|
27
|
+
| USD/JPY | Rate differential, risk sentiment |
|
|
28
|
+
| AUD/USD | Commodities, China data |
|
|
29
|
+
| USD/CAD | Oil prices, BoC policy |
|
|
30
|
+
|
|
31
|
+
## Data to Fetch via APIs
|
|
32
|
+
|
|
33
|
+
- **Forex quotes**: real-time rates for all pairs
|
|
34
|
+
- **Historical prices**: OHLCV for technical analysis
|
|
35
|
+
- **Economic calendar**: upcoming releases with impact rating
|
|
36
|
+
- **Treasury rates**: yield differentials drive forex
|
|
37
|
+
- **Forex news**: central bank statements, policy changes
|
|
38
|
+
|
|
39
|
+
## Key Signals
|
|
40
|
+
|
|
41
|
+
### High Impact Events
|
|
42
|
+
- NFP (first Friday monthly) — moves USD 50-200 pips
|
|
43
|
+
- CPI/PPI — inflation → rate expectations
|
|
44
|
+
- FOMC decisions — biggest USD moves
|
|
45
|
+
- GDP releases
|
|
46
|
+
|
|
47
|
+
### News Trading Rules
|
|
48
|
+
1. Check calendar EVERY morning
|
|
49
|
+
2. Don't trade 15 min before/after NFP, CPI, FOMC
|
|
50
|
+
3. Initial spike often reverses 50-70% — fade overreactions
|
|
51
|
+
4. Trade the trend 30-60 min post-news
|
|
52
|
+
|
|
53
|
+
## Forex-Specific Strategies
|
|
54
|
+
|
|
55
|
+
### Session Breakout
|
|
56
|
+
- Asian range → London breaks out → trade the direction
|
|
57
|
+
- Win rate ~55-60%, R:R typically 2:1+
|
|
58
|
+
|
|
59
|
+
### Carry Trade
|
|
60
|
+
- Buy high-yield currency, sell low-yield (profit from swap)
|
|
61
|
+
- Works stable environments, fails risk-off
|
|
62
|
+
|
|
63
|
+
### Central Bank Divergence
|
|
64
|
+
- Diverging policy → trade toward hawkish bank's currency
|
|
65
|
+
|
|
66
|
+
## Risk Rules (Forex-Specific)
|
|
67
|
+
|
|
68
|
+
- Major pairs only for small accounts
|
|
69
|
+
- Max leverage: 10:1 swing, 20:1 day trade
|
|
70
|
+
- EUR/USD and GBP/USD ~80% correlated — don't double up
|
|
71
|
+
- Reduce size before weekends (gap risk)
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
*Last updated: Initial version. Agent should update after real forex trades.*
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# Precious Metals Trading Reference
|
|
2
|
+
|
|
3
|
+
> **This file is agent-editable.** Update it as you learn from real trades.
|
|
4
|
+
|
|
5
|
+
## Gold (XAU/USD)
|
|
6
|
+
|
|
7
|
+
- Safe haven — rallies during uncertainty and currency debasement
|
|
8
|
+
- Inverse DXY correlation (-0.7 to -0.9)
|
|
9
|
+
- Central banks are net buyers (structural demand floor)
|
|
10
|
+
- Daily range: 1-3%, spikes 3-5% on crises
|
|
11
|
+
|
|
12
|
+
## Silver (XAG/USD)
|
|
13
|
+
|
|
14
|
+
- Dual role: precious metal + industrial (50% industrial demand)
|
|
15
|
+
- Moves 1.5-2x gold's percentage move
|
|
16
|
+
- Gold/Silver ratio: 60-80 range (above 80 = silver undervalued)
|
|
17
|
+
|
|
18
|
+
## Data to Fetch via APIs
|
|
19
|
+
|
|
20
|
+
- **Commodity quotes**: Gold, silver real-time prices
|
|
21
|
+
- **Historical prices**: EOD for trend analysis
|
|
22
|
+
- **Economic data**: Treasury rates (real yields = #1 gold driver), CPI
|
|
23
|
+
- **Economic calendar**: FOMC, CPI, NFP dates
|
|
24
|
+
- **Forex data**: DXY as leading indicator
|
|
25
|
+
|
|
26
|
+
## Drivers
|
|
27
|
+
|
|
28
|
+
### Bullish: Falling real yields, rising inflation, geopolitical crises, dollar weakness, central bank buying
|
|
29
|
+
### Bearish: Rising real yields, strong dollar, risk-on sentiment, hawkish central banks
|
|
30
|
+
|
|
31
|
+
## Strategies
|
|
32
|
+
|
|
33
|
+
### Gold/Silver Ratio Trade
|
|
34
|
+
- Above 85: buy silver, sell gold → close at 70-75
|
|
35
|
+
- Below 65: buy gold, sell silver → close at 70-75
|
|
36
|
+
- Historical win rate ~70% over 1-3 months
|
|
37
|
+
|
|
38
|
+
### DXY Correlation Trade
|
|
39
|
+
- DXY breakdown → buy gold. DXY breakout → short gold.
|
|
40
|
+
|
|
41
|
+
### Macro Events
|
|
42
|
+
- Dovish FOMC → buy gold. Hawkish → sell short-term.
|
|
43
|
+
- CPI higher than expected → buy gold (inflation hedge)
|
|
44
|
+
|
|
45
|
+
## Risk Rules
|
|
46
|
+
|
|
47
|
+
- Size down during FOMC weeks
|
|
48
|
+
- Don't fight strong DXY with long gold
|
|
49
|
+
- Silver drops 30%+ in crashes (industrial collapse)
|
|
50
|
+
- Weekend gap risk ($30-50 gold gaps)
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
*Last updated: Initial version. Agent should update after real metals trades.*
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Risk Management Reference
|
|
2
|
+
|
|
3
|
+
> **Most important file.** Violating these rules is the primary reason traders lose. Agent-editable but only to make rules STRICTER, never looser.
|
|
4
|
+
|
|
5
|
+
## Position Sizing
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
Position Size = (Account Balance x Risk %) / (Entry Price - Stop Loss Price)
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Use `python3 scripts/position-sizer.py` for calculations.
|
|
12
|
+
|
|
13
|
+
## Hard Limits (NEVER VIOLATE)
|
|
14
|
+
|
|
15
|
+
| Rule | Limit | Action When Hit |
|
|
16
|
+
|------|-------|-----------------|
|
|
17
|
+
| Per-trade risk | 1% max | Reduce size or skip |
|
|
18
|
+
| Total open risk | 3% | No new trades |
|
|
19
|
+
| Daily loss | 2% | Stop for the day |
|
|
20
|
+
| Weekly loss | 5% | Reduce sizes 50% |
|
|
21
|
+
| Max drawdown | 10% | Pause, full review |
|
|
22
|
+
| Critical drawdown | 15% | Stop trading, rebuild |
|
|
23
|
+
|
|
24
|
+
## R:R Requirements
|
|
25
|
+
|
|
26
|
+
| Quality | Min R:R |
|
|
27
|
+
|---------|---------|
|
|
28
|
+
| A+ (high confluence) | 2:1 |
|
|
29
|
+
| B (moderate) | 3:1 |
|
|
30
|
+
| C (speculative) | Skip it |
|
|
31
|
+
|
|
32
|
+
## Stop-Loss Rules
|
|
33
|
+
|
|
34
|
+
- Place at technical invalidation point BEFORE entry
|
|
35
|
+
- NEVER move stop away from entry
|
|
36
|
+
- Move to breakeven after 1R profit
|
|
37
|
+
- Trail by 1.5-2 ATR for trend trades
|
|
38
|
+
|
|
39
|
+
## Leverage
|
|
40
|
+
|
|
41
|
+
| Asset | Max |
|
|
42
|
+
|-------|-----|
|
|
43
|
+
| Crypto spot | 1x |
|
|
44
|
+
| Crypto futures | 3-5x |
|
|
45
|
+
| Forex | 10-20x |
|
|
46
|
+
| Stocks | 1-2x |
|
|
47
|
+
| Gold/Silver | 5-10x |
|
|
48
|
+
|
|
49
|
+
## Correlation: Max 2 same-direction on correlated assets (> 0.7)
|
|
50
|
+
|
|
51
|
+
## Drawdown Recovery
|
|
52
|
+
|
|
53
|
+
| Drawdown | Action |
|
|
54
|
+
|----------|--------|
|
|
55
|
+
| 0-3% | Normal |
|
|
56
|
+
| 3-5% | -25% size, A+ only |
|
|
57
|
+
| 5-8% | -50% size, 1 trade/day |
|
|
58
|
+
| 8-10% | Paper trade, review |
|
|
59
|
+
| 10%+ | Full stop |
|
|
60
|
+
|
|
61
|
+
## Pre-Trade Checklist
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
[ ] Regime identified? [ ] 2+ confluence signals?
|
|
65
|
+
[ ] R:R >= 2:1? [ ] Risk <= 1%?
|
|
66
|
+
[ ] Open risk < 3%? [ ] Not correlated?
|
|
67
|
+
[ ] Stop at tech level? [ ] No news in 2h?
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
ANY check fails → DO NOT TRADE.
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
*Agent may make rules STRICTER only. NEVER looser.*
|