Indicator reference
Technical details on reading types, chained readings, timeframe behavior, and system limits. For the beginner guide, see Indicators.
Reading types (full list)
Every indicator reading uses one of these types. The builder only offers types that make sense for each indicator.
Core readings
| Reading type | What it computes | Settings |
|---|---|---|
| Value | One reading at a specific bar | Bars ago (default: 0 = current) |
| Trend | Recent direction — rising, falling, or flat | Length (default: 4 bars) |
| Average | Mean value over a lookback period | Length (default: 24 bars) |
| Efficiency | How directly the value moved — net change ÷ total path (Kaufman ER) | Length, counted in changes (default: 20 changes, which reads 21 bars) |
| Largest share | Max ÷ sum over the lookback — "one spike or spread evenly?" | Length (default: 24 bars) |
Statistics
| Reading type | What it computes | Settings |
|---|---|---|
| Z-score | How many standard deviations the newest value sits from the window's mean (population σ); banded extreme low below −2, low, neutral −1 to 1, high, extreme high above 2 | Length (default: 20 bars) |
| Standard deviation | Population standard deviation over the window, in the input's unit | Length (default: 20 bars) |
| Slope | Least-squares slope per bar over the window, in the input's unit | Length (default: 20 bars) |
| Percentile | Percent of the prior bars at or below the newest value, 0–100 | Length, counted in prior bars (default: 20) |
| Rolling low / high | Lowest / highest value over the window | Length (default: 20 bars) |
Efficiency and the statistics read empty when the newest or the oldest bar of their window holds no value, or when there are fewer bars than the window.
Classification and events
| Reading type | What it computes | Settings |
|---|---|---|
| Zone | The indicator's own bands (overbought/oversold, etc.) | — |
| State | Discrete classification (bullish/bearish, etc.) | — |
| Cross | Crossover event (bullish cross / bearish cross) | — |
| Level interaction | What the bar did at a price level: touch, reject, or break | Buffer (how close counts as a touch, in basis points) |
Price-relative readings
| Reading type | What it computes | Settings |
|---|---|---|
| Distance to | % from current price to the indicator's level | — |
| Gap between | The indicator against another one in the same unit: the difference for a reading that means the same on every coin (RSI 60 vs 50 is 10 pts), the signed % gap for a price-like level | Second indicator (required) |
| Relative to coin | The indicator against the same indicator on another coin, bar by bar: the difference for a reading that means the same on every coin (SOL's RSI 62 vs BTC's 50 is 12 pts), the ratio for a price (SOL ÷ BTC, like TradingView's SOLUSDT/BTCUSDT) | Coin (default: BTC) |
Cross-sectional readings
| Reading type | What it computes | Settings |
|---|---|---|
| Rank | Where this coin stands among all tracked coins | Ordering: Highest, Lowest, Furthest from zero, Closest to zero |
Structure zone readings
These only work with the structure-zone indicator:
| Reading type | What it computes | Settings |
|---|---|---|
| Zone count | How many zones exist on a side | — |
| Nearest zone type | Type of the nearest zone | Side: support or resistance |
| Nearest zone range | The price range of that zone | Side: support or resistance |
| Nearest zone distance | % from price to the zone's near edge (its top for support, its bottom for resistance), 0 inside the zone | Side: support or resistance |
| Nearest zone age | Hours since the zone was detected | Side: support or resistance |
Zone labels by indicator
When you use the Zone reading type, each indicator has its own bands:
| Indicator | Zone labels |
|---|---|
| RSI (14), RSI (7), Stochastic %K/%D, CCI | Overbought · Oversold · Neutral |
| RSI (2) | Overbought · Oversold · Neutral (wider bands for the 2-period variant) |
| MFI | Overbought · Bullish · Neutral · Bearish · Oversold |
| ADX | Weak · Developing · Trending · Extreme (measures trend strength, not direction) |
Chained readings
Some readings can be chained — an inner reading feeds into an outer one. This lets you answer questions like "what's the trend of my distance-to-VWAP?"
How chains work
A Distance to, Gap between or Relative to coin reading produces a value for each bar. That per-bar series can then be consumed by:
- Trend — is the distance rising, falling, or flat?
- Average — what's the mean distance over N bars?
- Rank — where does this coin's distance rank vs others?
Example: Distance to SMA20 × Trend tells you whether price is getting closer to or further from the 20-bar moving average.
What can chain
| Inner reading | Can chain into |
|---|---|
| Distance to | Trend, Average, Efficiency, Largest share, Rank |
| Gap between | Trend, Average, Efficiency, Largest share, Rank |
| Relative to coin | Trend, Average, Efficiency, the statistics — never Rank: no ranked set exists for a coin pair |
The Efficiency and Largest share readings don't chain over Distance/Gap because a ratio of ratios loses meaning.
Chain settings
A chained reading uses settings from both parts:
- The inner reading's settings (e.g. which indicator for Gap between)
- The outer reading's settings (e.g. Length for Trend)
Closed vs live candles (detailed)
When to use each option
Every reading that looks at candle data lets you choose:
| Option | Internal name | Behavior |
|---|---|---|
| Closed candles only | Confirmed | Read only bars that have completed |
| Includes the live candle | Developing | Include the bar still forming |
The default rule
If you don't set this explicitly:
- Above your strategy timeframe → Closed candles only (a higher-TF bar is still forming when your strategy bar closes)
- At or below your strategy timeframe → Includes the live candle (at your bar's close, no bar is "in progress")
What each means for your agent
Closed candles only:
- Values are stable — once a bar closes, the reading is final
- Best for rules that need reliable values
- On the live display, the reading drops the forming bar
Includes the live candle:
- Shows the most current value, but it can change until the bar closes
- The reading "repaints" — it may look different in hindsight
- Cannot carry a deciding verdict on a rule
- Cannot be used as an exit rule
Trade-off
Use "Closed candles only" for rules your agent acts on. Use "Includes the live candle" sparingly, for context where repainting is acceptable.
Timeframe resolution
How relative timeframes resolve
When you pick a relative timeframe, the actual interval depends on your strategy's main candle:
| You select | What it means |
|---|---|
| Your timeframe | The strategy's own candle (e.g. 1h) |
| Lower timeframe | One step down on the platform's ladder |
| Higher timeframe | The shortest enabled timeframe at least three times your candle (the "regime" timeframe) |
| Fixed timeframe | Exactly the interval you specify |
Example resolution
If your strategy trades on 1h:
- Lower timeframe → 30m
- Higher timeframe → 4h
If your strategy trades on 4h:
- Lower timeframe → 2h
- Higher timeframe → 12h
The Higher timeframe is always used for regime context (the bigger-picture trend/volatility/momentum state).
Why this matters
Relative timeframes adapt when you change your strategy's main candle. A rule that reads "one step below" keeps that meaning — you don't have to update every indicator when you change timeframes.
Length and bars ago
How lookback works
| Setting | What it controls | Default |
|---|---|---|
| Length | How many bars the reading spans | Depends on reading type (4 for Trend, 24 for Average) |
| Bars ago | Read a past value instead of current | 0 (current bar) |
Length
Used by Trend, Average, Efficiency, and Largest share readings:
- Trend (4) — looks at the last 4 bars to decide direction
- Average (24) — computes the mean of the last 24 values
- Efficiency (21) — the classic Kaufman ER period
A bar with no value (missing data) stays empty — the reading doesn't pull in an older value to fill the gap.
Bars ago (offset)
Used by the Value reading to look at a past bar:
- Bars ago = 0 → the current bar
- Bars ago = 1 → the previous bar
- Bars ago = 5 → five bars back
Note: Indicators without a bar-by-bar history (like funding rate or regime state) only accept Bars ago = 0.
Lookback limit
The platform allows a maximum lookback of 64 bars per indicator. This includes the Length plus any reach the indicator itself needs (e.g. a 20-bar SMA needs 20 bars before it can produce a value).
Reference coin panels
Technical details
A Reference coin panel reads a different instrument's data — useful for checking BTC or ETH before trading altcoins.
How it works
- Set per panel, not per strategy — you can have BTC and ETH as separate reference panels
- The panel shows that instrument's values, not the coin you're evaluating
- Rules can reference the panel's indicators like any other
Restrictions
- Only custom panels can be reference panels (platform panels always read the evaluated coin)
- Rank readings don't work on reference panels (they need cross-coin comparison)
- The reference instrument must be actively traded on the platform
- If the reference has no data (market closed, stale), a rule reading it returns false
When to use
Use a reference panel when your strategy needs to check a second instrument's state:
- "Only trade altcoins when BTC RSI is above 40"
- "Skip trades when ETH funding is extremely negative"
For comparing the same coin against a level or another indicator, use Distance to or Gap between instead. To read one of the coin's own indicators against the same indicator on another coin — SOL's price in BTC, or its RSI minus BTC's — use Relative to coin in any section.
Limits
The platform enforces these caps when you save. Going over rejects the save — nothing is silently trimmed.
| What | Limit |
|---|---|
| Panels per strategy | 32 |
| Indicators per panel | 32 |
| Indicator lookback | 64 bars |
| Different timeframes | 8 |
| Panel notes (total) | 3,200 characters |
| Rules per strategy | Shown in the builder's rail (used / cap) |
| Clauses per rule | Shown on each rule's clauses meter |
How indicators connect to rules
Indicators populate the Agent briefing. Rules read those indicators to make decisions:
| Indicator side | Rule side |
|---|---|
| Panel with RSI reading | Rule: "RSI is below 30" |
| Panel with ATR% reading | Rule: "ATR% is at least 0.5" |
| Panel with Zone reading | Rule: "RSI zone is oversold" |
A rule can only reference indicators that exist in your strategy's panels. If you delete a panel, rules referencing its indicators break.