Data Sources
Data sources are how you bring market data into FORJ. A data source is a connection to an external feed — like TradingView alerts or a custom webhook — that delivers price data or custom signals to your strategies.
Once connected, FORJ maps the incoming data into a standard format and routes it to every strategy that subscribes to that stream.
How It Works
- You create a data source specifying the provider, series kind, and field mappings.
- FORJ generates a webhook URL for you to configure in your data provider.
- Data arrives via the webhook, gets validated and mapped.
- Strategies subscribed to that stream receive events and evaluate their transitions.
Provider and Venue
When creating a data source, you'll be asked to choose a provider and optionally specify a venue.
Provider
The provider identifies where your data comes from:
| Provider | Description |
|---|---|
| TradingView | Alerts fired from TradingView via webhooks. |
| Generic Webhook | Any service that can POST JSON to a URL. |
Choosing a provider does not change how data is processed — the series kind selection, schema generation, and field mapping work the same regardless. The provider selection helps FORJ point you to platform-specific setup instructions. For example, if you choose TradingView, the documentation can guide you through creating a TradingView alert, configuring the webhook URL, and formatting the alert message body.
If your data comes from a system that isn't listed, choose Generic Webhook.
Venue
The venue typically represents your broker or exchange — for example, OANDA, Forex.com, or Binance. Like the provider, the venue does not affect how data is processed. It helps FORJ gather context about your setup and may be used in the future to provide broker-specific guidance.
Series Kind
Each data source delivers one of two series kinds:
| Kind | What It Delivers | Example |
|---|---|---|
| Candle series | Standard OHLCV candle data at a regular interval | 5-minute BTCUSD candles from TradingView |
| Event series | Custom event payloads from a webhook | A signal from your own system |
The series kind determines the type of events your strategies receive — New Candle events for candle series, or named Custom Events for event series.
Source Lifecycle
Each data source has a status:
| Status | Meaning |
|---|---|
| Active | The source is live and processing incoming webhooks. Sources start in this state immediately after creation. |
| Disabled | Manually paused — incoming webhooks are ignored until you re-enable the source. |
Managing Data Sources
Access your data sources from the user menu at the bottom of the sidebar:
- Click your avatar/icon to open the user menu.
- Select Data Sources.
From here you can view all sources, their status, and manage them.