2025-08-13 19:40:04 -04:00
|
|
|
# Policy JSON Schema (DualEA)
|
|
|
|
|
|
2026-02-05 01:22:42 -05:00
|
|
|
This document defines the expected structure of `policy.json` consumed by both `PaperEA_v2` and `LiveEA`.
|
|
|
|
|
|
|
|
|
|
> **Implementation Note:** LiveEA has full per-slice policy parsing with scaling support. PaperEA_v2 has minimal policy parsing (checks `min_confidence` string presence only).
|
2025-08-13 19:40:04 -04:00
|
|
|
|
|
|
|
|
## Location
|
|
|
|
|
- MT5 Common Files: typically `C:\Users\<you>\AppData\Roaming\MetaQuotes\Terminal\Common\Files\DualEA\policy.json`
|
2026-02-05 01:22:42 -05:00
|
|
|
- Reload signal: `Common\Files\DualEA\policy.reload`
|
|
|
|
|
- **PaperEA_v2**: Hot-reload supported via timer polling + optional HTTP
|
|
|
|
|
- **LiveEA**: Policy loaded on init only; restart required for updates
|
2025-08-13 19:40:04 -04:00
|
|
|
|
|
|
|
|
## Top-level Fields
|
|
|
|
|
- `min_confidence` (number): gating threshold; trades require `p_win >= min_confidence` unless a fallback path is taken.
|
|
|
|
|
- Note: Policy is considered "loaded" when there is at least one slice (`slices.length > 0`). `min_confidence` does not determine loaded state.
|
|
|
|
|
- `slices` (array of objects): per-slice policy entries.
|
|
|
|
|
|
|
|
|
|
## Slice Fields
|
|
|
|
|
Each slice object supports:
|
|
|
|
|
- `strategy` (string): strategy identifier matching EA strategies.
|
|
|
|
|
- `symbol` (string): normalized symbol, e.g. `"EURUSD"`. Special case: `"*"` to indicate strategy-only aggregate.
|
|
|
|
|
- `timeframe` (integer): MT5 timeframe constant number; `-1` indicates aggregate across timeframes for a symbol.
|
|
|
|
|
- `p_win` (number): probability/confidence used by gating.
|
|
|
|
|
- `sl_scale` (number): stop-loss scale multiplier.
|
|
|
|
|
- `tp_scale` (number): take-profit scale multiplier.
|
|
|
|
|
- `trail_atr_mult` (number): trailing policy multiplier (ATR-based or treated as generic trailing scale by the EA).
|
|
|
|
|
|
|
|
|
|
## Aggregation & Lookup
|
|
|
|
|
`PaperEA` uses the following lookup order (see `GetPolicyProb()`):
|
|
|
|
|
1. Exact match: `(strategy, symbol, timeframe)`
|
|
|
|
|
2. Strategy + symbol aggregate: `(strategy, symbol, timeframe=-1)`
|
|
|
|
|
3. Strategy-only aggregate: `(strategy, symbol="*", timeframe=-1)`
|
|
|
|
|
|
|
|
|
|
If no slice is found, `GetPolicyProb()` returns `-1.0` and the EA may use the default policy fallback path if enabled.
|
|
|
|
|
|
|
|
|
|
## Example
|
|
|
|
|
```json
|
|
|
|
|
{
|
|
|
|
|
"min_confidence": 0.45,
|
|
|
|
|
"slices": [
|
|
|
|
|
{ "strategy": "BollAverages", "symbol": "EURUSD", "timeframe": 60, "p_win": 0.52, "sl_scale": 1.0, "tp_scale": 1.2, "trail_atr_mult": 1.0 },
|
|
|
|
|
{ "strategy": "BollAverages", "symbol": "EURUSD", "timeframe": -1, "p_win": 0.50, "sl_scale": 1.0, "tp_scale": 1.0, "trail_atr_mult": 1.0 },
|
|
|
|
|
{ "strategy": "BollAverages", "symbol": "*", "timeframe": -1, "p_win": 0.48, "sl_scale": 1.0, "tp_scale": 1.0, "trail_atr_mult": 1.0 }
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Notes
|
|
|
|
|
- Scaling is applied only when a valid slice is found and policy gating is active. Fallback trades (no policy or slice miss) use neutral scaling.
|
|
|
|
|
- Trainer/export scripts should ensure symbols/timeframes align with EA normalization and MT5 constants.
|
