Forex
FXSource
The Forex node fetches OHLCV candle data for currency pairs from the Traderoid API and streams live tick updates via WebSocket. It supports 32 major, minor, and exotic pairs with configurable timespan, multiplier, and timezone alignment.
Parameters
| Parameter | Default | Description |
|---|---|---|
| symbol | EUR/USD | Currency pair to fetch in BASE/QUOTE notation. |
| multiplier | 1 | Number of base timespan units per candle. E.g. multiplier=4 with timespan=hour produces 4-hour bars. |
| timespan | minute | Base candle period: second, minute, hour, day, week, or month. |
| timezone | UTC | IANA timezone for candle boundary alignment and chart display. Important for session-based strategies. |
Timespan Options
| Value | Description |
|---|---|
| second | One candle per second. |
| minute | One candle per minute (default). |
| hour | One candle per hour. |
| day | One candle per trading day. |
| week | One candle per calendar week. |
| month | One candle per calendar month. |
Outputs
| Field | Type | Description |
|---|---|---|
| t | number[] | Unix timestamps (seconds, UTC) for each closed candle. |
| o | number[] | Open prices. |
| h | number[] | High prices. |
| l | number[] | Low prices. |
| c | number[] | Close prices. |
| v | number[] | Tick volume (proxy for trading activity) during each candle period. |
Supported Symbols
32 major, minor, and exotic currency pairs are available:
EUR/USDUSD/JPYGBP/USDUSD/CHFAUD/USDUSD/CADNZD/USDEUR/GBPEUR/JPYGBP/JPYEUR/CHFAUD/JPYGBP/CHFEUR/AUDEUR/CADGBP/CADAUD/CADAUD/NZDCAD/JPYCHF/JPYNZD/JPYGBP/AUDGBP/NZDEUR/NZDUSD/SGDUSD/HKDUSD/NOKUSD/SEKUSD/DKKUSD/ZARUSD/MXNUSD/TRY
Live Streaming
1
Historical load — On graph run, the node fetches the full candle history from the Traderoid REST API for the configured pair, multiplier, and timespan.
2
WebSocket subscription — After the historical load, the node subscribes to the forex WebSocket streamer for live tick data on the selected pair.
3
Candle aggregation — Incoming ticks are merged into the current candle. When a new period starts, a new candle is appended to the output arrays.
4
Downstream re-evaluation — All connected indicator, logic, and action nodes re-run automatically on each tick update.
Use Cases
Session strategies
Use timezone alignment to build London- or New York-session breakout strategies on EUR/USD, GBP/USD, and other major pairs.
Carry & correlation
Feed multiple Forex nodes into logic or math nodes to analyse cross-pair correlations or interest-rate carry trades.
FX brokerage routing
Connect to the Broker node with OANDA or FXCM selected to execute live forex orders directly from the strategy graph.
Tips
Session timezone — Set timezone to
Europe/London for the London session or America/New_York for the New York session to ensure daily candles open and close at the correct local time.Tick volume — Forex does not have centralised exchange volume. The
v output represents tick count (proxy for activity), not actual notional volume.Weekend gaps — Forex markets close Friday evening and re-open Sunday evening (UTC). Daily and weekly candles will reflect these gaps; intraday candles will simply have no data during the closure.