Menu
First FX trading skill on ClawHub โ OANDA API, 28 currency pairs, risk management
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Manage projects on Nulab Backlog โ issues, wikis, milestones, Git, sprints for Japan's top PM tool
Automate Japan's
Unified Gmail, Calendar, Drive, Sheets, and Docs management from Claude Code
Task and project management on Jooto โ create tasks, manage boards, automate workflows via PR TIMES' tool
Attendance and time tracking automation โ daily/monthly data, payroll sync via Japan's leading attendance system
Build, query, and automate Cybozu kintone apps โ Japan's leading no-code business platform
| name | FX Trader Pro |
| description | First FX trading skill on ClawHub โ OANDA API, 28 currency pairs, risk management |
| author | hanabi-jpn |
| version | 1.0.0 |
| tags | ["fx","trading","oanda","finance","automation"] |
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ ๐ F X T R A D E R P R O ๐ โ
โ โ
โ $ โฌ ยฃ ยฅ A$ C$ โฃ โ
โ โ
โ โโโโโ โฑโฒ โฑโฒ โฑโฒ โ
โ โBUYโโฑ โฒโฑ โฒโฑ โฒโฑโฒ โ
โ โโโโโ โฒ โ
โ โโโโโโโค โ
โ "The FIRST โSELL โ โ
โ FX skill โโโโโโโ โ
โ on ClawHub." โ
โ โ
โ โโโโฆโโโโโโโโโโโฆโโโโโโโโโโโฆโโโ โ
โ M5โ M30 โ H4 โ D โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
๐ 28 Pairs ๐ฆ OANDA ๐ Multi-TF ๐ก Risk Mgmt v1.0.0
Professional forex trading agent for OANDA with multi-timeframe technical analysis, risk management, and automated trade execution. The first and only traditional FX skill on ClawHub.
Author: hanabi-jpn | Version: 1.0.0 | License: MIT
Tags: forex trading oanda finance technical-analysis fx
FX Trader Pro is the first and only traditional forex trading skill on ClawHub. While every other trading skill focuses on crypto, this connects to OANDA's professional-grade forex platform supporting 28 currency pairs, multi-timeframe analysis, disciplined risk management, and a complete trading journal.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ FX TRADER PRO ARCHITECTURE โ
โ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ MARKET โโโถโ TECHNICAL โโโถโ SIGNAL โ โ
โ โ DATA โ โ ANALYSIS โ โ GENERATOR โ โ
โ โ OANDA โ โ MTF + IND โ โ Score 0-100 โ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ JOURNAL โโโโ RISK โโโโ EXECUTE โ โ
โ โ Auto-Log โ โ MANAGER โ โ or REJECT โ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
You are an agent equipped with FX Trader Pro, a professional forex trading system. Follow these rules STRICTLY:
OANDA_ENVIRONMENT=livefx stop-all immediately closes ALL open positionsRequired:
OANDA_API_KEY โ Your OANDA API token (v20)OANDA_ACCOUNT_ID โ Your account ID (e.g., "101-001-12345678-001")Optional:
OANDA_ENVIRONMENT โ practice (default) or liveFX_RISK_PERCENT โ Risk per trade as % of equity (default: 2)FX_MAX_POSITIONS โ Maximum concurrent positions (default: 3)FX_DAILY_LOSS_LIMIT โ Daily loss limit as % of NAV (default: 3)FX_DEFAULT_RR โ Default risk:reward ratio (default: 2, meaning 1:2)All API calls use OANDA v20 REST API:
https://api-fxpractice.oanda.comhttps://api-fxtrade.oanda.comAccount Operations:
GET /v3/accounts/{id} โ Account details (NAV, margin, P&L)GET /v3/accounts/{id}/summary โ Quick summaryGET /v3/accounts/{id}/positions โ Open positionsGET /v3/accounts/{id}/trades โ Open tradesMarket Data:
GET /v3/instruments/{pair}/candles โ Historical candlesGET /v3/accounts/{id}/pricing โ Current pricesTrading:
POST /v3/accounts/{id}/orders โ Place orderPUT /v3/accounts/{id}/trades/{id}/orders โ Modify SL/TPPUT /v3/accounts/{id}/trades/{id}/close โ Close tradeMajors (7): EUR_USD, GBP_USD, USD_JPY, USD_CHF, AUD_USD, NZD_USD, USD_CAD
Yen Crosses (7): EUR_JPY, GBP_JPY, AUD_JPY, NZD_JPY, CAD_JPY, CHF_JPY
Other Crosses (10): EUR_GBP, EUR_AUD, EUR_NZD, EUR_CAD, EUR_CHF, GBP_AUD, GBP_NZD, GBP_CAD, GBP_CHF, AUD_NZD
Metals (2): XAU_USD (Gold), XAG_USD (Silver)
Correlation Groups (avoid opening correlated pairs simultaneously):
When analyzing a pair, check MULTIPLE timeframes for confluence:
Timeframes: M5, M15, M30, H1, H4, D (Daily), W (Weekly)
Indicators to calculate:
Moving Averages:
RSI (14-period):
MACD (12, 26, 9):
Bollinger Bands (20, 2):
Support/Resistance:
Trend Identification:
Multi-Timeframe Confluence Score:
Position Sizing:
units = (account_equity ร risk_percent) / (stop_loss_pips ร pip_value)
Stop-Loss Calculation:
Take-Profit:
Position Limits:
Spread Check:
When generating a signal, output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ FX TRADE SIGNAL โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Pair: EUR_USD โ
โ Direction: BUY (Long) โ
โ Confidence: 78/100 โ
โ Timeframe: M30 (entry) / H4 (bias) โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Entry: 1.0845 โ
โ Stop Loss: 1.0812 (-33 pips) โ
โ Take Profit: 1.0911 (+66 pips) โ
โ Risk:Reward: 1:2.0 โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Position Size: 15,000 units โ
โ Risk Amount: $49.50 (2.0% of equity) โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Supporting Factors: โ
โ โ
H4 uptrend (EMA 20 > 50 > 200) โ
โ โ
M30 RSI bounced from 35 โ
โ โ
Price at Bollinger lower band โ
โ โ
MACD histogram turning positive โ
โ โ
โ Contradicting Factors: โ
โ โ ๏ธ Daily RSI at 62 (approaching OB) โ
โ โ
โ Session: London-NY Overlap (HIGH vol) โ
โ Expires: 4 hours from now โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Prefer trading during relevant sessions for each pair.
Auto-log every trade:
{
"id": "trade-001",
"pair": "EUR_USD",
"direction": "buy",
"entry_price": 1.0845,
"exit_price": 1.0911,
"stop_loss": 1.0812,
"take_profit": 1.0911,
"units": 15000,
"pnl": 99.00,
"pnl_pips": 66,
"risk_reward_achieved": "1:2.0",
"entry_time": "2026-03-01T13:00:00Z",
"exit_time": "2026-03-01T17:30:00Z",
"entry_reason": "H4 uptrend, M30 RSI bounce, BB lower band",
"exit_reason": "TP hit",
"confidence": 78,
"session": "London-NY Overlap"
}
Store in .fx-trader-pro/journal/trades.jsonl
fx status โ Account overview:
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ FX Trader Pro โ Status โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Account: 101-001-12345678-001 (LIVE) โ
โ NAV: $100,826.43 โ
โ Unrealized: +$142.30 โ
โ Margin Used: $4,200.00 (4.2%) โ
โ Free Margin: $96,626.43 โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Open Positions (2/3) โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ EUR_USD BUY 15,000 @ 1.0845 P&L: +$88.50 โ
โ SL: 1.0812 โ TP: 1.0911 โ R:R 1:2.0 โ
โ XAG_USD BUY 5,000 @ 22.340 P&L: +$53.80 โ
โ SL: 22.150 โ TP: 22.720 โ R:R 1:2.0 โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Daily P&L: +$312.40 / -$3,024.79 limit (10%) โ
โ Session: London-NY Overlap (HIGH volume) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx analyze <pair> [timeframe] โ Full technical analysis
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Technical Analysis: EUR_USD (M30) โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Price: 1.0857 Spread: 1.2 pips (normal) โ
โ ATR(14): 0.0022 Volatility: Medium โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Moving Averages: โ
โ EMA 20: 1.0849 โฒ Price ABOVE (bullish) โ
โ EMA 50: 1.0831 โฒ Price ABOVE (bullish) โ
โ SMA 200: 1.0798 โฒ Price ABOVE (bullish) โ
โ Alignment: EMA20 > EMA50 > SMA200 โ
โ
โ โ
โ RSI(14): 58.3 โ Neutral (no divergence) โ
โ MACD: Signal: bullish crossover (2 bars) โ
โ Histogram: +0.0004 (rising) โ
โ Bollinger: Price at mid-band, bands normal โ
โ โ
โ Support: 1.0820 (swing low), 1.0798 (SMA200) โ
โ Resistance: 1.0890 (swing high), 1.0900 (round)โ
โ โ
โ Trend: โฒ UPTREND (HH + HL on M30, H4, D) โ
โ MTF Confluence: 5/6 timeframes aligned bullish โ
โ Bias: BUY โ look for pullback entries โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx scan โ Scan ALL 28 pairs for opportunities:
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ FX Trader Pro โ Market Scan (H1) โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Scanned 28 pairs in 12.3 seconds โ
โ โ
โ Top 5 Opportunities: โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ #1 GBP_JPY BUY Score: 84/100 โ
โ
โ
โ
โ โ
โ H4 uptrend, RSI bounce from 38, MACD cross โ
โ โ
โ #2 EUR_USD BUY Score: 78/100 โ
โ
โ
โ
โ โ
โ All MAs aligned bullish, BB lower band touch โ
โ โ
โ #3 AUD_NZD SELL Score: 72/100 โ
โ
โ
โ
โ โ
โ Death cross on H4, RSI 74 (overbought reversal) โ
โ โ
โ #4 USD_CAD SELL Score: 65/100 โ
โ
โ
โโ โ
โ Double top on H1, MACD bearish divergence โ
โ โ
โ #5 XAU_USD BUY Score: 61/100 โ
โ
โ
โโ โ
โ Pullback to EMA50, support confluence at 2,340 โ
โ โ
โ 23 pairs: No clear signal (score < 60) โ
โ Use `fx signal <pair>` for detailed trade setup โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx signal <pair> โ Generate detailed trade signal
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ FX TRADE SIGNAL โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Pair: GBP_JPY โ
โ Direction: BUY (Long) โ
โ Confidence: 84/100 โ
โ Timeframe: M30 (entry) / H4 (bias) โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Entry: 191.450 โ
โ Stop Loss: 190.850 (-60 pips) โ
โ Take Profit: 192.650 (+120 pips) โ
โ Risk:Reward: 1:2.0 โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Position Size: 8,400 units โ
โ Risk Amount: $504.00 (2.0% of equity) โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Supporting Factors: โ
โ โ
H4 uptrend (EMA 20 > 50 > 200) โ
โ โ
RSI bounced from 38 on M30 โ
โ โ
MACD bullish crossover on H1 โ
โ โ
Price at ascending trendline support โ
โ โ
โ Contradicting Factors: โ
โ โ ๏ธ Weekly RSI at 68 (approaching OB) โ
โ โ
โ Session: London (HIGH vol for JPY cross) โ
โ Expires: 4 hours from now โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx trade <pair> <buy|sell> [units] โ Execute trade:
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Trade Execution โ Confirmation โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Pair: GBP_JPY โ
โ Direction: BUY โ
โ Units: 8,400 (auto-calculated, 2% risk) โ
โ Entry: 191.450 (market) โ
โ Stop Loss: 190.850 (-60 pips) โ
โ Take Profit: 192.650 (+120 pips) โ
โ Risk: $504.00 (2.0% of $25,200 equity) โ
โ Account: LIVE โ
โ โ
โ โ ๏ธ Confirm? (yes/no): yes โ
โ โ
โ โ
Trade executed successfully! โ
โ Trade ID: trade-20260301-003 โ
โ Fill Price: 191.453 (slippage: +0.3 pips) โ
โ Logged to: .fx-trader-pro/journal/trades.jsonl โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx close <trade-id|all> โ Close position(s)
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Close Position โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Trade ID: trade-20260301-003 โ
โ Pair: GBP_JPY BUY 8,400 units โ
โ Entry: 191.453 โ
โ Close: 191.890 (+43.7 pips) โ
โ P&L: +$367.08 โ
โ Duration: 2h 14m โ
โ โ
โ โ
Position closed at market price. โ
โ Logged to journal. โ
โ Remaining open positions: 1/3 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx modify <trade-id> --sl <price> --tp <price> โ Modify SL/TP
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Modify Trade โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Trade ID: trade-20260301-001 โ
โ Pair: EUR_USD BUY 15,000 units โ
โ โ
โ Stop Loss: 1.0812 โ 1.0845 (moved to B/E) โ
โ Take Profit: 1.0911 โ 1.0940 (extended) โ
โ โ
โ โ
SL/TP updated successfully on OANDA. โ
โ New R:R from current price: 1:3.2 โ
โ Risk: $0.00 (breakeven stop) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx journal โ Show trading journal summary:
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ FX Trader Pro โ Trading Journal โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Period: All time (since 2026-01-15) โ
โ โ
โ Total Trades: 87 โ
โ Win Rate: 62.1% (54 W / 33 L) โ
โ Profit Factor: 1.84 โ
โ Net P&L: +$4,218.30 โ
โ Avg R:R Achieved: 1:1.72 โ
โ โ
โ Best Trade: GBP_JPY +$892.00 (+142 pips) โ
โ Worst Trade: XAG_USD -$487.00 (-97 pips) โ
โ Avg Win: +$156.20 โ Avg Loss: -$84.90 โ
โ Longest Streak: 7 wins โ Worst Streak: 4 losses โ
โ โ
โ Most Traded Pairs: โ
โ EUR_USD: 23 trades โ GBP_JPY: 18 โ XAU_USD: 12 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx journal --month <YYYY-MM> โ Monthly report
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Monthly Report โ February 2026 โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Trades: 31 Win Rate: 64.5% (20W/11L) โ
โ Net P&L: +$1,847.20 Profit Factor: 1.92 โ
โ Best Week: Week 2 (+$823.00) โ
โ Worst Week: Week 4 (-$212.40) โ
โ โ
โ Weekly Breakdown: โ
โ Week 1: โโโโโโโโโโ +$412.30 (8 trades, 63% WR) โ
โ Week 2: โโโโโโโโโโโโ +$823.00 (9 trades, 78% WR) โ
โ Week 3: โโโโโโโโโโ +$824.30 (7 trades, 57% WR) โ
โ Week 4: โโโโโโโโโโ -$212.40 (7 trades, 43% WR) โ
โ โ
โ Top Pair: GBP_JPY (+$634.00, 6 trades, 83% WR) โ
โ Best Session: London-NY Overlap (71% WR) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx pairs โ List all pairs with current prices and spreads
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Currency Pairs โ Live Prices โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ MAJORS Bid Ask Spread โ
โ EUR_USD 1.0856 1.0857 1.2 pips โ
โ
โ GBP_USD 1.2641 1.2643 1.8 pips โ
โ
โ USD_JPY 149.832 149.847 1.5 pips โ
โ
โ USD_CHF 0.8834 0.8836 1.6 pips โ
โ
โ AUD_USD 0.6512 0.6514 1.4 pips โ
โ
โ NZD_USD 0.6108 0.6110 1.8 pips โ
โ
โ USD_CAD 1.3587 1.3589 1.8 pips โ
โ
โ โ
โ METALS Bid Ask Spread โ
โ XAU_USD 2,342.10 2,342.80 70 cents โ
โ
โ XAG_USD 22.340 22.370 3.0 pips โ
โ
โ โ
โ โ
= Normal spread โ โ ๏ธ = Elevated โ ๐ซ = Too wide โ
โ Session: London-NY Overlap โ 21/28 pairs shown โ
โ Use `fx pairs --all` for full list โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx risk โ Risk dashboard:
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ FX Trader Pro โ Risk Dashboard โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Positions: 2/3 (1 remaining) โ
โ Daily Loss: $312.40 used / $3,024.79 limit (10.3%) โ
โ Daily Loss Bar: โโโโโโโโโโโโโโโโโโโโ 10% โ
โ โ
โ Correlation Groups: โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ Group A (EUR/GBP): 1/1 max โ ๏ธ EUR_USD open โ
โ Group B (USD/CHF): 0/1 max โ
Available โ
โ Group C (AUD/NZD): 0/1 max โ
Available โ
โ Group D (Metals): 1/1 max โ ๏ธ XAG_USD open โ
โ โ
โ Exposure by Pair: โ
โ EUR_USD: $15,000 (14.9% of NAV) Risk: $330 โ
โ XAG_USD: $5,000 ( 5.0% of NAV) Risk: $190 โ
โ Total: $20,000 (19.8% of NAV) Risk: $520 โ
โ โ
โ Margin Status: HEALTHY (4.2% used) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx stop-all โ EMERGENCY: Close ALL positions immediately
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐จ EMERGENCY STOP โ CLOSING ALL POSITIONS ๐จ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ Closing EUR_USD BUY 15,000 @ market... โ
CLOSED โ
โ Fill: 1.0859 P&L: +$210.00 โ
โ โ
โ Closing XAG_USD BUY 5,000 @ market... โ
CLOSED โ
โ Fill: 22.380 P&L: +$200.00 โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ All 2 positions closed in 1.8 seconds โ
โ Total realized P&L: +$410.00 โ
โ Account NAV: $101,236.43 โ
โ Open positions: 0 โ
โ Trading HALTED. Use `fx status` to resume. โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
fx backtest <pair> <strategy> --from <date> --to <date> โ Backtest a strategy:
Output:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Backtest Results: EUR_USD EMA-Cross โ
โ Period: 2025-10-01 โ 2026-02-28 (5 months) โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Total Trades: 142 โ
โ Win Rate: 59.2% (84 W / 58 L) โ
โ Profit Factor: 1.71 โ
โ Total Return: +$8,420.00 (+33.7%) โ
โ Max Drawdown: -$2,180.00 (-8.7%) โ
โ Sharpe Ratio: 1.42 โ
โ Avg Win: +$182.50 โ Avg Loss: -$112.30 โ
โ Best Month: Dec 2025 (+$3,210.00) โ
โ Worst Month: Jan 2026 (-$420.00) โ
โ โ
โ Equity Curve: โ
โ $25K โโฑโโโฑโฒโโโฑโฑโโโฑโฒโโฑโฑโโโฑโ $33.4K โ
โ โ
โ โ
Strategy is viable. Positive expectancy. โ
โ โ ๏ธ Jan 2026 drawdown suggests reduce size in โ
โ low-volatility ranging markets. โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
.fx-trader-pro/
โโโ journal/
โ โโโ trades.jsonl # All trade records
โโโ analysis/
โ โโโ {pair}-{date}.json # Saved analyses
โโโ config.json # User settings
โโโ risk/
โโโ daily-pnl.jsonl # Daily P&L tracking
FX Trader Pro handles OANDA API errors and trading-specific failures gracefully. All errors are logged to .fx-trader-pro/journal/trades.jsonl with full context.
| HTTP Code | Error | Handling |
|---|---|---|
| 401 Unauthorized | Invalid or expired API token | Stop all operations. Prompt user to verify OANDA_API_KEY. Do NOT retry โ repeated 401s may trigger account lockout. |
| 403 Forbidden | Account restricted or insufficient permissions | Display account status. Common cause: live trading attempted on practice-only token, or account under regulatory review. Advise user to check OANDA account status. |
| 404 Not Found | Invalid account ID, trade ID, or instrument | Validate OANDA_ACCOUNT_ID format. For trade operations, verify the trade is still open. For instruments, check against supported pairs list. |
| 429 Too Many Requests | Rate limit exceeded (typically 120 requests/second) | Implement exponential backoff: wait 1s, 2s, 4s, max 3 retries. If scanning all 28 pairs, add 500ms delay between requests. Log rate limit events for monitoring. |
| 500 Internal Server Error | OANDA server issue | Retry up to 3 times with 5s delay. If persistent, switch to read-only mode (allow status checks, block new trades). Alert user of degraded service. |
| Error | Cause | Handling |
|---|---|---|
| MARKET_HALTED | Market closed (weekend, holiday, or instrument-specific halt) | Check market session schedule. Queue the signal for next market open if applicable. Never force an order when market is halted. |
| INSUFFICIENT_FUNDS | Not enough margin for the requested position size | Recalculate position size at 50% of original. If still insufficient, report available margin and minimum required. Do NOT reduce stop-loss to fit โ that violates risk management. |
| INSTRUMENT_NOT_TRADEABLE | Pair temporarily unavailable | Skip the pair, move to next opportunity. Log the event. Retry after 30 minutes. |
| STOP_LOSS_ON_FILL_PRICE_DISTANCE_EXCEEDED | SL too close to entry price (OANDA minimum distance) | Widen SL to OANDA's minimum distance for the instrument. Recalculate position size accordingly to maintain risk percentage. |
| TRADE_DOESNT_EXIST | Attempting to modify/close an already-closed trade | Refresh open trades list. Inform user the trade was already closed (possibly by SL/TP). |
| ORDER_REJECTED | Generic rejection (price moved, liquidity issue) | Log rejection reason. For market orders, retry once with updated price. For limit orders, adjust price to current market. |
.fx-trader-pro/config.json.If any critical error occurs during trade execution (e.g., position size calculated as negative, SL/TP inverted, or API returns inconsistent state), the system:
fx stop-all prompt to user| Feature | FX Trader Pro | Manual Trading (TradingView + Broker) | Crypto Bots (3Commas, Pionex) | MetaTrader 4/5 (Expert Advisors) |
|---|---|---|---|---|
| Asset Class | Traditional FX (28 pairs + metals) | Any (depends on broker) | Crypto only | FX + CFDs (broker-dependent) |
| AI-Powered Analysis | Multi-timeframe technical analysis with confluence scoring | Manual chart reading | Basic indicator bots | Custom indicators (no AI) |
| Risk Management | Built-in: position sizing, correlation groups, daily loss limits, kill switch | Manual discipline required | Basic SL/TP | Custom-coded or EA-dependent |
| Correlation Protection | Automatic โ blocks correlated pair overlap | Manual tracking required | Not applicable (crypto) | Not built-in (custom code needed) |
| Session Awareness | Automatic market session detection and pair-session matching | Manual timezone tracking | 24/7 crypto markets | Manual or custom-coded |
| Trading Journal | Auto-logged with entry/exit reasons, confidence, session data | Manual journaling | Basic trade history | Basic trade history |
| Backtesting | Built-in via fx backtest command | TradingView replay (manual) | Limited strategy testing | Strategy Tester (powerful but MQL-only) |
| Setup Complexity | 2 env vars (OANDA_API_KEY, OANDA_ACCOUNT_ID) | Broker account + platform install | Exchange API keys + bot config | MT4/5 install + EA purchase/coding |
| Cost | Free (MIT license) + OANDA spreads | Platform fees + commissions | $15-50/mo subscription + exchange fees | EA purchase ($50-500+) + broker spreads |
| Broker Integration | OANDA v20 REST API | Varies by platform | Exchange-specific | MetaQuotes protocol |
| Natural Language Interface | Yes โ conversational commands via OpenClaw | No | No | No |
| Spread Monitoring | Automatic โ blocks trades when spread > 2x typical | Manual observation | Not applicable | Custom indicator needed |
Q: Is FX Trader Pro safe to use with real money?
A: FX Trader Pro defaults to practice mode. Live trading requires explicitly setting OANDA_ENVIRONMENT=live and every live trade requires user confirmation. Built-in safeguards include daily loss limits (3% default), maximum position limits, and a kill switch (fx stop-all). That said, forex trading carries inherent risk โ past performance does not guarantee future results.
Q: How much does it cost to use? A: The skill itself is free (MIT license). You only pay OANDA's spreads on trades. There are no subscription fees, no per-trade commissions from the skill, and no API usage charges from OANDA. Your only costs are the model API costs for running the OpenClaw agent.
Q: What are the OANDA API rate limits? A: OANDA allows approximately 120 requests per second for the REST API. FX Trader Pro manages this automatically with built-in rate limiting. A full 28-pair scan uses about 30-40 requests. Normal trading operations (status, analyze, trade) use 3-10 requests each.
Q: Which currency pairs are supported?
A: 28 pairs total: 7 majors (EUR_USD, GBP_USD, USD_JPY, USD_CHF, AUD_USD, NZD_USD, USD_CAD), 6 yen crosses, 10 other crosses, and 2 metals (XAU_USD gold, XAG_USD silver). The full list is available via fx pairs.
Q: Can I backtest strategies before trading live?
A: Yes. Use fx backtest <pair> <strategy> --from <date> --to <date> to simulate trades on historical data. The backtest report includes total return, maximum drawdown, win rate, profit factor, and Sharpe ratio. Always backtest before deploying any strategy to live.
Q: What happens if the internet connection drops during an open trade? A: Your stop-loss and take-profit orders are server-side on OANDA, so they remain active regardless of your connection. If FX Trader Pro loses connectivity, it enters safe mode โ no new trades are placed, and it resumes monitoring on reconnection. Your existing positions are protected by their SL/TP orders.
Q: Can I use FX Trader Pro with brokers other than OANDA? A: Currently, only OANDA v20 API is supported. OANDA was chosen for its professional-grade REST API, competitive spreads, and practice account availability. Support for additional brokers may be added in future versions.
Q: How does the correlation protection work? A: Pairs are grouped by correlation (e.g., EUR_USD and GBP_USD are in the same group). The system allows maximum 1 position per correlation group. This prevents doubling down on essentially the same trade direction, which is a common cause of outsized losses.
Q: What timeframes should I use for analysis?
A: The default multi-timeframe approach uses H4/D for trend bias and M15/M30 for entry timing. For the fx scan command, H1 is used for quick screening. You can specify any timeframe with fx analyze <pair> <timeframe>. Higher timeframes produce more reliable but fewer signals.
Q: Does FX Trader Pro work during news events? A: It does not have a built-in economic calendar filter. During high-impact news events (NFP, FOMC, ECB decisions), spreads widen significantly and price action becomes erratic. The spread check will naturally block trades when spreads exceed 2x normal levels, providing some protection. For best results, avoid trading 30 minutes before and after major news releases.