{"request_id":"3f97968e-e9b4-4e49-b292-b3dad4ccb701","provenance_summary":"Stock Trends indicators are part of a multi-decade classification framework with records extending back to 1980. Their value comes from consistent semantics across market history: trend state, trend persistence, relative performance, relative performance direction, and volume activity are encoded in a stable doctrine designed for longitudinal research.","data_provenance":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","update_frequency":"weekly","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","native_signal_domains":["trend classification","relative performance","relative performance direction","volume activity","market breadth","sector leadership","regime structure"],"research_value":["long-horizon signal validation","regime analysis","sector rotation research","portfolio construction research","causal and probabilistic market analysis","agentic market-intelligence workflows"],"important_limits":["Historical depth supports research and probabilistic interpretation but does not guarantee future performance.","Stock Trends outputs are not investment advice, price targets, or direct buy/sell commands.","Externally named market events are not native Stock Trends labels unless separately curated."]},"exchanges":{"allowed":["A","B","I","N","Q","T"],"meaning":{"T":"Toronto Stock Exchange (TSX)","N":"New York Stock Exchange (NYSE)","Q":"NASDAQ","A":"AMEX","B":"Other/alternate US listing bucket (if used in your DB)","I":"Index/indicator bucket (if used in your DB)"},"note":"Exact exchange meanings can be customized to your production mapping."},"fields":{"trend":{"type":"enum","allowed":["^+","^-","v^","v+","v-","^v","--","="],"meaning":{"^+":"Bullish (strong bullish trend)","^-":"Weak Bullish (bullish but weakening; often precedes bearish crossover)","v^":"Bullish Crossover (13wk MA crosses above 40wk MA)","v+":"Weak Bearish (bearish but recovering; often precedes bullish crossover)","v-":"Bearish (strong bearish trend)","^v":"Bearish Crossover (13wk MA crosses below 40wk MA)","--":"No trend / not classified","=":"Neutral / unchanged (if used)"},"note":"Trend is derived from price vs 13wk and 40wk moving averages per Stock Trends methodology."},"trend_cnt":{"type":"int","meaning":"Number of consecutive weeks the instrument has had the current trend code."},"mt_cnt":{"type":"int","meaning":"Number of consecutive weeks in the current major trend category (Bullish bucket vs Bearish bucket).","bullish_bucket":["^+","^-","v^"],"bearish_bucket":["v-","v+","^v"]},"prev_mtcnt":{"type":"int","meaning":"Previous week's mt_cnt (primarily meaningful on crossover weeks when mt_cnt resets)."},"rsi":{"type":"int","meaning":"13-week relative strength index vs benchmark (S&P 500) where >100 implies outperformance."},"rsi_updn":{"type":"enum","allowed":["+","-","0",""],"meaning":{"+":"Outperformed benchmark this week","-":"Underperformed benchmark this week","0":"Roughly flat vs benchmark this week","":"Not available / missing"}},"vol_tag":{"type":"enum","allowed":["","!","!!","*","**","~"],"meaning":{"":"No volume tag / normal","!":"Unusually low volume (low)","!!":"Unusually low volume (very low) — treated as low","*":"Unusually high volume (high)","**":"Unusually high volume (very high) — treated as high","~":"Special/other tag (if used in your dataset)"},"equivalences":{"low":["!","!!"],"high":["*","**"]}},"fpr_chg4/13/40":{"type":"float","meaning":"Forward price return (%) after subsequent 4/13/40-week periods (historical realized).","note":"Used for evaluating ST-IM distributions; may be NULL where forward window not available."}},"links":{"human_guides":["https://stocktrends.com/learn/stock-trends-guides","https://stocktrends.com/component/strategy/stdata_layout","https://stocktrends.com/learn/stock-trends-handbook"],"machine_guides":["/v1/openapi.json","/v1/meta/inference","/v1/meta/indicators"]},"cognition_context":{"signal_source_role":"Stock Trends classifications convert raw weekly market behavior into structured, repeatable signal states that can be consumed by multiple inference providers.","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"inference_contract":"/v1/meta/inference","current_baseline_provider":"/v1/meta/stim"}}