Profiles

A single ipda process can research and trade multiple quotes within one profile, and you can run forex and Deriv side by side from one clone via named profiles.

Multi-instrument via `SYMBOLS_FILE`

Set SYMBOLS_FILE in your env file to a JSON manifest; when present, QUOTE and MT5_SYMBOL are ignored.


cp symbols.example.forex.json symbols.forex.json   # XAUUSD + BTCUSD
# or
cp symbols.example.deriv.json symbols.deriv.json   # Vol indices, Crash/Boom, Step


SYMBOLS_FILE=symbols.forex.json

Manifest fields

Field	Required	Purpose
`quote`	yes	Market-data instrument (passed to `GET .../candles`)
`mt5_symbol`	no	Execution symbol (defaults to `quote`)
`pip_size`	no	Overrides profile `PIP_SIZE` for this instrument
`price_digits`	no	Overrides profile `PRICE_DIGITS`
`volume`	no	Overrides profile `VOLUME`
`deviation_points`	no	Overrides profile `DEVIATION_POINTS`
`stop_loss_pips`	no	Overrides profile `STOP_LOSS_PIPS`
`take_profit_pips`	no	Overrides profile `TAKE_PROFIT_PIPS`

Strategy, session, and notification settings remain profile-level. Only execution and risk calibration fields are per-instrument.

On each poll, ipda fetches candles for every instrument in parallel, evaluates each forming bar independently, and submits one POST /v1/signals per firing instrument in the same tick (when in session). Signal idempotency is per (symbol, bucket, direction).

Without SYMBOLS_FILE, set QUOTE and MT5_SYMBOL for a single instrument.

Profile ↔ mt5-trader pairing

Each profile loads a separate env file from the repository working directory and pairs with the matching mt5-trader instance:

Command	Env file	Example template	mt5-trader
`ipda`	`.env`	`.env.example.forex`	`mt5-signal-service` (:8000)
`ipda --profile forex`	`.env.forex`	`.env.example.forex`	`mt5-signal-service --profile forex`
`ipda --profile deriv`	`.env.deriv`	`.env.example.deriv`	`mt5-signal-service --profile deriv` (:8001)

Process environment variables still override file values.

Forex vs Deriv defaults

Setting	Forex	Deriv
Live trigger	RSI reversal 14 / 25 / 75	Same
`TARGET_TF_MINUTES`	5	5
`STOP_LOSS_PIPS` / `TAKE_PROFIT_PIPS`	40 / 50	50 / 80 (wider — see Hard Targets)
`TRADING_SESSIONS`	`tokyo,new_york`	empty (24/7 synthetics)
`PIP_SIZE`	`0.0001` (EURUSD)	`0.01` (Vol 75)

Synthetic indices trade continuously, so cash-session hours mean nothing for Deriv — leave TRADING_SESSIONS= empty. See Sessions.

Pairing checklist

ipda variable	Must match
`MT5_SIGNAL_API_URL`, `DATA_API_URL` host/port	mt5-trader `PORT` for that profile
`MT5_SIGNAL_API_KEY`, `DATA_API_KEY`	mt5-trader `API_KEY` for that profile
`MT5_SYMBOL`, `QUOTE`	Single instrument, or every `mt5_symbol` / `quote` in `SYMBOLS_FILE`


# Forex
cp .env.example.forex .env
ipda
 
# Deriv (start mt5-signal-service --profile deriv first)
cp .env.example.deriv .env.deriv
ipda --profile deriv

Run exactly one instance per profile to avoid duplicate trading decisions.

`source=ipda`

Payloads use source="ipda", which is accepted by mt5-trader’s SignalSource.IPDA. It becomes the broker order comment and reconciliation tag. Ensure the paired mt5-trader build includes this source.