Pair analyze

Pair Analyze — Combination Command

Runs a fixed, ordered pipeline of specialist skills against one symbol and returns a single consolidated trade plan. Use this when you want "one command" to cover the full path from regime classification to an actionable entry with stops and targets.

Invocation

/tradecraft:pair-analyze <SYMBOL> [TIMEFRAME] [MODE]

# Examples
/tradecraft:pair-analyze XAUUSD H1
/tradecraft:pair-analyze US30 H4 conservative
/tradecraft:pair-analyze EURUSD M15 scalp
/tradecraft:pair-analyze BTCUSD D1 swing

• <SYMBOL> — any broker-recognized symbol (XAUUSD, US30, EURUSD, BTCUSD, ...)
• [TIMEFRAME] — M5, M15, H1, H4, D1 (defaults to H1)
• [MODE] — one of: conservative, standard (default), aggressive, scalp, swing

Arguments are exposed to the skill via $ARGUMENTS.

Pipeline (do not skip upstream steps)

#	Step	Skill invoked	Output expected
0	Data feed	fetch-quotes	OHLCV bars + latest quote (yfinance free by default, MT5 if available)
1	Regime classification	market-regime-classifier	Trend/range/volatility label; session state
2	Fundamentals filter	risk-calendar-trade-filter + trading-fundamentals	High-impact news gate; macro context
3	Structure	ict-smart-money	BOS/CHoCH, order blocks, fair value gaps
4	Liquidity map	liquidity-analysis	Pools, sweeps, equal highs/lows, inducement
5	Entry refinement	zone-refinement-sniper-entry	Precise entry zone inside the POI
6	Risk & sizing	risk-and-portfolio	Position size, SL, TP, R:R, max-daily-loss check
7	Synthesis	(this skill)	Single consolidated JSON trade plan

Every step gates the next. If regime fails (e.g., dead range on an M15 scalp mode), stop and report.

Mode Calibration

Mode	Per-trade risk	Min R:R	Setup grade	Timeframes
conservative	0.5%	3.0	A only	H4, D1
standard	1.0%	2.0	A, B	H1, H4
aggressive	2.0%	1.5	A, B, C	M15, H1
scalp	0.5%	1.5	A only	M5, M15
swing	1.0%	3.0	A, B	H4, D1

Symbol-specific wrappers (e.g., analyze-gold, analyze-us30) may lower the per-trade risk for a mode to reflect that symbol's volatility profile. They must never raise it above this parent table.

Output Contract

Return exactly one JSON block followed by a short human summary:

{
  "symbol": "XAUUSD",
  "timeframe": "H1",
  "mode": "standard",
  "regime": "trend-up | trend-down | range | high-vol",
  "bias": "long | short | flat",
  "setup_grade": "A | B | C",
  "confluence": ["ICT order block", "liquidity sweep", "H4 trend"],
  "entry": 2345.80,
  "stop_loss": 2340.50,
  "take_profit_1": 2356.40,
  "take_profit_2": 2367.00,
  "risk_reward": 2.2,
  "position_size": {"lots": 0.35, "risk_pct": 1.0},
  "invalidation": "Close below 2338.00 on H1",
  "news_gate": {"clear_until": "14:30 UTC", "next_event": "US CPI 14:30 UTC"},
  "confidence": 0.72,
  "notes": "Short summary of why this setup passed every gate"
}

Reject and explain (do NOT emit a trade plan) if:

• News gate blocks trading in the next 2 hours
• Regime is incompatible with mode (e.g., range + scalp = skip)
• Position sizing would breach daily loss limit
• Structure and liquidity disagree on direction

Anti-Patterns

• Running on a symbol the broker does not provide
• Skipping regime because "the setup looks nice"
• Forcing an entry outside the refined zone because the market moved
• Using aggressive mode on illiquid sessions (Asian session for US indices, US close for gold majors)
• Stacking multiple open positions without portfolio heat check (see risk-and-portfolio)

Worked Walkthrough: Gold (XAUUSD) H1, standard mode

1. Regime — H4 trend up, H1 pullback, London session, ATR(14) = 8.5 points. Trend-up.
2. News gate — no red-folder events next 3 hours. Clear.
3. Structure — H1 bullish order block at 2340-2343, prior BOS at 2348.
4. Liquidity — equal lows at 2341 swept 2 hours ago; next pool above at 2365.
5. Entry refinement — 50% of OB refined to 2341.50 entry.
6. Risk — 1% of $10k = $100. SL at 2338.00 (3.5 pts). Lot size = 0.28.
7. Synthesis — long 2341.50, SL 2338.00, TP1 2348.50 (2R), TP2 2355.00 (3.8R), grade B, confidence 0.68.

Worked Walkthrough: US30 H4, conservative mode

1. Regime — D1 uptrend, H4 consolidation. Range-in-trend.
2. News gate — FOMC minutes in 18 hours. Still clear for an H4 setup.
3. Structure — H4 CHoCH rejected; bearish order block at 42150-42220.
4. Liquidity — equal highs at 42200 untouched (target for sweep, not entry).
5. Entry refinement — short at 42180 after liquidity sweep of 42200.
6. Risk — 0.5% of $10k = $50. SL above equal highs at 42250 (70 pts). Assuming the common US30 CFD spec of $1 per index-point per 1.0 lot, lots = $50 / (70 × $1) = 0.71 (round DOWN to 0.71 to stay under the risk cap). For a $10-per-point broker spec, the same risk gives 0.07 lots — always check your symbol specification.
7. Synthesis — short 42180, SL 42250, TP1 41960 (3.1R), grade A, confidence 0.74.

Lot-Size Formula (universal)

lots = risk_usd / (sl_points × usd_per_point_per_lot)

• Gold (XAUUSD): usd_per_point_per_lot = $100 where 1 point = $1.00 move × 100 oz contract
• US30: usd_per_point_per_lot = $1 (most retail CFD) or $10 (some MT5 cash-CFD specs) — always verify from the broker's symbol info before sizing
• Round DOWN to the broker's lot step (typically 0.01) so actual risk stays ≤ the cap

Validation Test Cases

Use these to self-check the pipeline output before shipping a plan:

• Symbol is normalized (no broker suffix like XAUUSDm, US30.cash) — if suffix is present, strip it and proceed.
• Every numeric price field has at most 5 significant digits for gold, 1 decimal for indices, 5 for FX majors.
• risk_reward >= min_RR from the Mode Calibration table.
• invalidation cites a price level and condition, never "if price falls."
• position_size.lots respects the broker's min lot (usually 0.01) and step.

See Also

• analyze-gold — pre-configured wrapper for XAUUSD
• analyze-us30 — pre-configured wrapper for US30
• master-trading-workflow — full 18-phase workflow (this skill is its condensed form)