Data Sources
Data sources are how you bring external market data into FORJ. A data source defines how FORJ should accept, validate, map, and route an inbound webhook feed.
Once a source is configured, FORJ generates a webhook URL, maps inbound payloads into a canonical stream shape, and routes events to every subscribed strategy.
How it works
- You create a data source with a provider, series kind, and schema mapping.
- FORJ generates a webhook URL and secret token.
- Your external system sends JSON payloads to that URL.
- FORJ validates the payload, maps the fields, and routes the event to subscribed strategies.
Provider and venue
Provider
The provider identifies where the data originates:
| Provider | Description |
|---|---|
| TradingView | Alerts sent from TradingView via webhook. |
| Generic Webhook | Any system that can POST JSON to a URL. |
Provider selection does not change the engine's routing behavior. It mainly affects setup guidance and labeling.
Venue
Venue is usually the broker or exchange associated with the feed, such as OANDA or Binance. It helps describe the stream identity, but it is not a separate processing mode.
Series kind
Each data source produces one of two series kinds:
| Kind | What it delivers | Example |
|---|---|---|
| Candle series | OHLCV-style market data at regular intervals | 5m BTCUSD candles |
| Event series | Named custom events with arbitrary payloads | External signal events |
The series kind determines which event shapes your strategies can react to.
Source lifecycle
After creation, a data source is immediately ready to receive webhooks.
| Status | Meaning |
|---|---|
| Active | The source is accepting and processing incoming payloads. |
| Disabled | The source is paused. Incoming payloads are ignored until re-enabled. |
| Marked for Deletion | The source is scheduled for removal and no longer accepts new data. |
Data source vs data stream
These are related, but not identical:
- A data source is the webhook configuration you manage.
- A data stream is the canonical stream identity strategies subscribe to.
Multiple sources can map into the same canonical stream if they resolve to the same instrument, timeframe, venue, and schema identity.
Managing data sources
Open Data Sources from the user menu in the sidebar to:
- review configured sources
- inspect status and errors
- copy webhook details
- disable or delete a source