Skip to main content

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 typeWhat it computesSettings
ValueOne reading at a specific barBars ago (default: 0 = current)
TrendRecent direction — rising, falling, or flatLength (default: 4 bars)
AverageMean value over a lookback periodLength (default: 24 bars)
EfficiencyHow directly the value moved — net change ÷ total path (Kaufman ER)Length, counted in changes (default: 20 changes, which reads 21 bars)
Largest shareMax ÷ sum over the lookback — "one spike or spread evenly?"Length (default: 24 bars)

Statistics​

Reading typeWhat it computesSettings
Z-scoreHow 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 2Length (default: 20 bars)
Standard deviationPopulation standard deviation over the window, in the input's unitLength (default: 20 bars)
SlopeLeast-squares slope per bar over the window, in the input's unitLength (default: 20 bars)
PercentilePercent of the prior bars at or below the newest value, 0–100Length, counted in prior bars (default: 20)
Rolling low / highLowest / highest value over the windowLength (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 typeWhat it computesSettings
ZoneThe indicator's own bands (overbought/oversold, etc.)—
StateDiscrete classification (bullish/bearish, etc.)—
CrossCrossover event (bullish cross / bearish cross)—
Level interactionWhat the bar did at a price level: touch, reject, or breakBuffer (how close counts as a touch, in basis points)

Price-relative readings​

Reading typeWhat it computesSettings
Distance to% from current price to the indicator's level—
Gap betweenThe 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 levelSecond indicator (required)
Relative to coinThe 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 typeWhat it computesSettings
RankWhere this coin stands among all tracked coinsOrdering: Highest, Lowest, Furthest from zero, Closest to zero

Structure zone readings​

These only work with the structure-zone indicator:

Reading typeWhat it computesSettings
Zone countHow many zones exist on a side—
Nearest zone typeType of the nearest zoneSide: support or resistance
Nearest zone rangeThe price range of that zoneSide: 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 zoneSide: support or resistance
Nearest zone ageHours since the zone was detectedSide: support or resistance

Zone labels by indicator​

When you use the Zone reading type, each indicator has its own bands:

IndicatorZone labels
RSI (14), RSI (7), Stochastic %K/%D, CCIOverbought · Oversold · Neutral
RSI (2)Overbought · Oversold · Neutral (wider bands for the 2-period variant)
MFIOverbought · Bullish · Neutral · Bearish · Oversold
ADXWeak · 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 readingCan chain into
Distance toTrend, Average, Efficiency, Largest share, Rank
Gap betweenTrend, Average, Efficiency, Largest share, Rank
Relative to coinTrend, 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:

OptionInternal nameBehavior
Closed candles onlyConfirmedRead only bars that have completed
Includes the live candleDevelopingInclude 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 selectWhat it means
Your timeframeThe strategy's own candle (e.g. 1h)
Lower timeframeOne step down on the platform's ladder
Higher timeframeThe shortest enabled timeframe at least three times your candle (the "regime" timeframe)
Fixed timeframeExactly 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
SettingWhat it controlsDefault
LengthHow many bars the reading spansDepends on reading type (4 for Trend, 24 for Average)
Bars agoRead a past value instead of current0 (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.

WhatLimit
Panels per strategy32
Indicators per panel32
Indicator lookback64 bars
Different timeframes8
Panel notes (total)3,200 characters
Rules per strategyShown in the builder's rail (used / cap)
Clauses per ruleShown on each rule's clauses meter

How indicators connect to rules​

Indicators populate the Agent briefing. Rules read those indicators to make decisions:

Indicator sideRule side
Panel with RSI readingRule: "RSI is below 30"
Panel with ATR% readingRule: "ATR% is at least 0.5"
Panel with Zone readingRule: "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.


← Indicators · Indicator examples · Rules