// getting_started

Categorical Bands

Canonical values and methodology notes for every public band

TickerDB expresses market state as categorical bands instead of raw indicator values. This page is the public reference for those labels, and the schema endpoint uses the same canonical value lists.

How To Read This Page

Use these labels as the exact allowed values for screening and interpretation. When a field includes stability metadata, the current label is still the primary state and the _meta object tells you whether that state is fresh, holding, established, or volatile.

RSI Zones

deep_oversoldoversoldneutral_lowneutralneutral_highoverboughtdeep_overbought

Methodology: Thresholds are fixed at <20, 20-30, 30-40, 40-60, 60-70, 70-80, and 80+.

Stochastic Zones

deep_oversoldoversoldneutral_lowneutralneutral_highoverboughtdeep_overbought

Methodology: Thresholds are fixed at <10, 10-20, 20-35, 35-65, 65-80, 80-90, and 90+.

Trend Direction

strong_uptrenduptrendneutraldowntrendstrong_downtrend

Methodology: Derived from price vs 20/50/200-day moving averages plus the recent 20-day slope.

MA Alignment

aligned_bullishmixedaligned_bearish

Methodology: Summarizes whether price is above or below the major moving averages as a stack.

MA Distance

far_abovemoderately_aboveslightly_aboveslightly_belowmoderately_belowfar_below

Methodology: Signed distance from a moving average, bucketed by magnitude.

Volume Ratio

Today's volume vs 50-day average volume.

extremely_lowlownormalabove_averagehighextremely_high

Methodology: Thresholds are <0.3, 0.3-0.7, 0.7-1.5, 1.5-2.5, 2.5-4.0, and 4.0+.

Accumulation State

strong_accumulationaccumulationneutraldistributionstrong_distribution

Methodology: Based on ADL slope percentile within the asset’s own history.

Volatility Regime

lownormalabove_normalhighextreme

Methodology: Based on ATR percentile within the asset’s own history, not an absolute ATR threshold.

Support/Resistance Distance

at_levelvery_closenearmoderatefarvery_far

Methodology: Distance as a percentage of current price: <=0.5%, <=1.5%, <=3%, <=7%, <=15%, or >15%.

Support/Resistance Status

intactapproachingbreached

Methodology: Status reflects whether the level remains intact, is being approached, or has been breached by recent closes.

Volume Context

Scans only.

spikeabove_averagenormalbelow_average

Methodology: Characterizes volume behavior during overbought or oversold conditions.

Breakout Type

Scans only.

resistance_breakresistance_testsupport_breaksupport_test

Squeeze Context

Scans only.

active_squeezesqueeze_releasedno_squeeze

Price Direction on Volume

updownflat

Methodology: Whether price moved up, down, or flat on the current bar.

MACD State

expanding_positivecontracting_positiveexpanding_negativecontracting_negative

Methodology: Classified by whether MACD is above or below signal and whether the absolute MACD value is expanding vs the prior bar.

Momentum Direction

acceleratingsteadydeceleratingbullish_reversalbearish_reversal

Methodology: Derived from the recent RSI trajectory over a short rolling lookback.

Valuation Zone

Stocks only.

deep_valueundervaluedfair_valueovervalueddeeply_overvalued

Methodology: Composite percentile of P/E vs history, P/E vs sector, P/B vs history, and growth context.

P/E vs Historical

historic_lowbelow_averageaverageabove_averagehistoric_high

P/E vs Sector

deep_discountdiscountalignedpremiumdeep_premium

Growth Zone

high_growthmoderate_growthstableslowingshrinking

Methodology: Based on the blended level of revenue and EPS year-over-year growth.

Growth Direction

acceleratingsteadydeceleratingdeteriorating

Methodology: Compares the most recent growth rate against the prior period to show acceleration or deterioration.

Earnings Proximity

within_daysthis_weekthis_monthnext_monthnot_soon

Methodology: Bucketed by days until the next earnings date.

Earnings Surprise

big_beatbeatmetmissedbig_miss

Methodology: Based on actual vs estimated earnings surprise percentage.

Analyst Consensus

strong_buybuyholdsellstrong_sell

Methodology: Mapped from the mean analyst rating on a 1-5 recommendation scale.

Analyst Consensus Direction

upgradingstabledowngrading

Methodology: Shows whether the aggregate recommendation trend is improving, stable, or worsening.

Insider Activity Zone

heavy_buyingmoderate_buyingneutralmoderate_sellingheavy_sellingno_activity

Methodology: Composite of insider transaction counts and share volume imbalance.

Insider Net Direction

strong_buyingbuyingneutralsellingstrong_selling

Methodology: Direction label derived from insider buy vs sell transaction mix.

Performance

sharp_declinemoderate_declineslight_declineflatslight_gainmoderate_gainsharp_gain

Methodology: Each band is relative to that asset’s own historical return distribution, not a universal percent move.

Condition Rarity

extremely_rarevery_rarerareuncommonoccasionalcommon

Methodology: Lower percentiles are translated into rarity labels so unusual states are easier to inspect conversationally.

Range Position

lower_thirdmid_rangeupper_third

Methodology: Position of price inside the active support/resistance range.

Band Stability

Band fields that expose stability metadata can include a sibling _meta object that helps you judge how durable the current label is. Endpoint defaults vary: for example, Summary keeps these objects off by default unless you request meta=true or explicit *_meta fields.

fresh holding established volatile

fresh: just entered this band, usually 1-2 periods.

holding: recently entered and starting to settle, typically 3-7 daily periods or 2-3 weekly periods.

established: held for an extended run, typically 8+ daily periods or 4+ weekly periods.

volatile: flipping frequently in the recent lookback, even if the current label is not brand new.

Stability metadata is available on Plus and Pro tiers and includes stability, periods_in_current_state, flips_recent, and flips_lookback.