Skip to main content

Basic Configuration

Before creating triggers or trading groups, you need to populate the system's lookup dictionaries via the Basic Config page in the admin dashboard.

These dictionaries define the vocabulary the rest of the system uses.


Markets

A market defines the broad asset class. Examples:

NameDescription
cryptoCryptocurrency markets (Binance, etc.)
forexForeign exchange (OANDA, etc.)
stocksEquity markets

Symbols

A symbol is a specific tradeable instrument within a market. Examples: BTCUSDT, ETHUSDT, EURUSD.


Intervals

An interval sets the primary timeframe for the trading group's analysis. Examples: 1m, 5m, 15m, 1h, 4h, 1d.


Providers

A provider is an LLM API integration. You configure the provider name and the API key. Members of trading groups reference a provider + model combination.

Supported provider types include OpenRouter, LiteLLM-compatible endpoints, and gpt4free.


Roles

Roles define the function of each AI member inside a trading group.

Role CodeFunction
group_leaderSynthesizes opinions, makes the final BUY/SELL/NO_TRADE decision. At least one required.
technical_analystAnalyzes price action, chart patterns, and indicators
news_analystInterprets news events and macro impact
risk_analystEvaluates position sizing, risk/reward, and exposure
experience_retrieverSurfaces relevant past trade lessons (future capability)
important

Every trading group must have at least one member with the group_leader role. The service will refuse to process events if no leader is found in the group configuration.


  1. Add markets → Add symbols → Add intervals
  2. Add at least one provider (you'll need an API key)
  3. Add roles (group_leader is the minimum)
  4. Proceed to create Triggers and Trading Groups