// getting_started

Categorical Bands

All indicator-derived data is expressed as categorical zones

TickerAPI never returns raw indicator values. Instead, all data is expressed as human-readable categorical bands that map directly to standard trading vocabulary.

RSI Zones

deep_oversold oversold neutral_low neutral neutral_high overbought deep_overbought

Stochastic Zones

deep_oversold oversold neutral_low neutral neutral_high overbought deep_overbought

Trend Direction

strong_uptrend uptrend neutral downtrend strong_downtrend

MA Alignment

aligned_bullish mixed aligned_bearish

MA Distance

far_above moderately_above slightly_above slightly_below moderately_below far_below

Volume Ratio

Today's volume vs. 50-day average:

extremely_low low normal above_average high extremely_high

Accumulation State

strong_accumulation accumulation neutral distribution strong_distribution

Volatility Regime

low normal above_normal high extreme

Support/Resistance Distance

at_level very_close near moderate far very_far

Support/Resistance Status

Whether the level is currently intact, being approached, or has been breached:

intact approaching breached

Volume Context Scans Only

Characterizes volume behaviour during overbought/oversold conditions:

spike above_average normal below_average

Breakout Type Scans Only

resistance_break resistance_test support_break support_test

Squeeze Context Scans Only

Bollinger squeeze state at time of breakout:

active_squeeze squeeze_released no_squeeze

Price Direction on Volume

Whether price moved up or down on the current bar:

up down flat

MACD State

expanding_positive contracting_positive expanding_negative contracting_negative

Momentum Direction

accelerating steady decelerating bullish_reversal bearish_reversal

Fundamental Bands Stocks Only

Fundamental fields are omitted entirely from crypto and ETF responses.

Valuation Zone

deep_value undervalued fair_value overvalued deeply_overvalued

Composite of P/E vs. 5-year history, P/E vs. sector median, P/B vs. history, and growth trajectory.

P/E vs. Historical

historic_low below_average average above_average historic_high

P/E vs. Sector

deep_discount discount aligned premium deep_premium

Growth Zone

high_growth moderate_growth stable slowing shrinking

Growth Direction

Applied to both revenue_growth_direction and eps_growth_direction:

accelerating steady decelerating deteriorating

Earnings Proximity

within_days this_week this_month next_month not_soon

Earnings Surprise

big_beat beat met missed big_miss

Analyst Consensus

strong_buy buy hold sell strong_sell

Analyst Consensus Direction

upgrading stable downgrading

Insider Activity Zone

heavy_buying moderate_buying neutral moderate_selling heavy_selling no_activity

Net Direction

Net insider transaction direction over the trailing quarter:

strong_buying buying neutral selling strong_selling

Performance

Used for the performance field on summary endpoints. Describes how the asset performed on the current candle relative to its own historical return distribution. Thresholds are per-ticker, so a sharp_decline on any asset means it is a notably large move for that asset, regardless of its typical volatility:

sharp_decline moderate_decline slight_decline flat slight_gain moderate_gain sharp_gain

Condition Rarity

Used for condition_rarity and valuation_rarity fields across scan and summary endpoints. Indicates how unusual the current condition is based on historical percentile:

extremely_rare very_rare rare uncommon occasional common

Band Stability

Every band field includes stability metadata describing how long the current value has been held and how frequently the field has changed recently. This helps distinguish a fresh flip from an established state.

fresh holding established volatile

fresh: Just entered this band (1-2 periods).

holding: Recently entered but starting to settle (3-7 days, or 2-3 weeks).

established: In this band for an extended period (8+ days, or 4+ weeks).

volatile: Frequent recent flips regardless of how long in the current state (4+ flips in 30 days, or 3+ flips in 12 weeks).

Stability metadata appears as _meta sibling objects next to each band field in summary, watchlist, and compare responses. Available on Plus and Pro tiers only. Includes stability label, periods_in_current_state, flips_recent, and flips_lookback. Not available on Free tier.