Your strategy finds signals. Stock Trends puts them in context.
Add decades of structured market intelligence—including trend classification, relative performance, breadth, leadership, market regime, probabilistic outcomes, and portfolio evidence—to trading systems, investment workflows, and AI agents.
Use it to augment your own investment process, not replace it.
Four layers of context
Your strategy supplies the thesis. Stock Trends supplies the environment it is operating in.
What the record actually contains
- Since 1980 Historical Stock Trends classification record
- 16M+ Structured weekly market observations
- Since 1993 Systematic Stock Trends market analysis published weekly
- 1981–2026 Model-portfolio return histories and associated strategy provenance exposed through the API; part of the portfolio record predates the 1993 Stock Trends publication history.
These proof points describe three distinct historical records: the classification record, containing more than 16 million structured weekly observations; the weekly publication record; and the model-portfolio record. Their dates and methodologies should not be combined into a single performance claim. Stock Trends model portfolios are rule-based model records, not audited brokerage-account performance.
Your strategy sees what it was built to see
Most strategies are, by design, narrow. They resolve one view of the market extremely well and are largely blind to the conditions surrounding it. That narrowness is usually a strength — but it leaves a gap.
- A momentum strategy sees momentum. It measures the move. It does not measure how many other names are participating in it.
- A value strategy sees valuation. It measures the discount. It does not measure whether the market is currently rewarding that discount.
- A machine-learning model sees its features. It resolves the relationships it was trained on, within the regimes present in its training data.
- Stock Trends sees the surrounding environment. Trend state and maturity, relative performance, breadth, leadership concentration and rotation, and regime structure — classified the same way for decades.
None of these views is superior to the others; they answer different questions. The practical value of a consistent, long-horizon classification layer is comparability: the same market states, encoded the same way, across many different market environments. That is expensive for any single team to build and maintain alongside its own strategy.
Stock Trends does not replace your strategy. It helps your strategy understand the market in which it is operating.
How the context is built
-
Step 1 · Input
Weekly market observations
Price and volume across NYSE, NASDAQ, AMEX, TSX, and index data, recorded on a weekly cadence.
-
Step 2 · Encoding
Stock Trends classification framework
One consistent doctrine that turns raw observations into named, comparable market states — applied the same way across decades.
-
Step 3 · Context layers
- Instrument Trend classification, trend persistence, relative performance and direction, volume behaviour
- Breadth & leadership Market and sector breadth, leadership concentration, leadership rotation
- Market regime Regime structure and participation: bullish, bearish, transitional, or selective
- Portfolio Evaluation, construction, comparison, and alignment with broader conditions
-
Step 4 · Applications
- ST-IM Probabilistic forward-return distributions conditioned on classified states
- Systematic strategies Declared rules and long-running model-portfolio histories
- Portfolio workflows Evaluate, construct, and compare portfolios against market conditions
-
Step 5 · Delivery
Trading systems, portfolio managers, and AI agents
Structured, agent-native access over the Stock Trends API — the delivery mechanism for every layer above.
Applied evidence exposed through the API
The portal documents three evidence pillars: historical classification provenance, realized statistical outcomes, and strategy and model-portfolio evidence. The two applied evidence families below have dedicated API records that agents and researchers can inspect. The Evidence & Validation page sets out all three pillars in full, including the classification provenance that underpins them.
Stock Trends exposes its record as endpoints rather than as marketing claims, so the historical outcomes and the rules and provenance behind them can be read directly instead of treated as a black box. The two families answer different questions and should not be combined into a single performance number.
Realized statistical outcome evidence
Mature ST-IM Select realized outcomes — observations that have already completed their measurement window — reported across 4-week, 13-week, and 40-week forward horizons against base-period means. The default response covers a trailing ten-year window (2016-03-04 through 2026-02-27) and includes 156,868 mature 4-week, 156,889 mature 13-week, and 139,743 mature 40-week observations.
Average returns exceed the base-period mean at all three horizons, while the outperform-base rate at 13 and 40 weeks sits below 50% — the distribution is positively skewed rather than uniformly favourable. The Evidence page documents how to read that distribution and its limitations.
GET /v1/selections/stim-select/outcomes/summary— mature realized outcome summaryGET /v1/meta/stim— ST-IM base-period means and modelling assumptions
Strategy and model-portfolio evidence
Official Stock Trends model portfolios expose their metadata, declared strategy rules, return history, closed-position history, and portfolio-to-strategy provenance. Return histories for the longest-running model portfolios begin in 1981 and continue to the current week — a span that starts before the 1993 weekly publication record, so it should not be read as a contemporaneously published history.
GET /v1/stocktrends/portfolios— list official Stock Trends model portfoliosGET /v1/stocktrends/portfolios/{port_id}— portfolio metadataGET /v1/stocktrends/portfolios/{port_id}/returns— chronological return historyGET /v1/stocktrends/portfolios/{port_id}/summary— public history summary and annualized ROIGET /v1/stocktrends/portfolios/{port_id}/positions/history— closed-position historyGET /v1/stocktrends/strategies— strategy definitions and economic assumptionsGET /v1/stocktrends/strategies/{strategy_id}— declared buy/sell conditions and stop-loss settingsGET /v1/stocktrends/portfolios/{port_id}/strategy— portfolio-to-strategy provenancePOST /v1/portfolio/compare— compare two portfolios under the same evaluation logic
Stock Trends model portfolios are rule-based model records with declared transaction-cost and stop-loss assumptions; current live holdings are excluded from public history endpoints. They are not audited brokerage-account performance, and they are not the same evidence family as ST-IM realized outcomes or Monte Carlo process simulations. Historical evidence supports framework evaluation and research — not investment advice, guaranteed outcomes, or price targets.
Core intelligence capabilities
Each capability maps to one of the four context layers. Use them individually, or compose them into a single view of the environment your strategy is trading in.
Classified instrument signals
Read trend classification, trend persistence, relative performance and direction, and volume behaviour for individual instruments.
GET /v1/indicators/latest
GET /v1/indicators/history
Forward return distributions
Access probabilistic return distribution data for individual instruments and use it in screening, decision, and portfolio workflows.
GET /v1/stim/latest
GET /v1/stim/history
STIM Select candidates
Discover instruments meeting Stock Trends probability and confidence criteria across forward return periods.
GET /v1/selections/latest
GET /v1/selections/published/latest
Market regime structure
Establish whether conditions are bullish, bearish, transitional, or selective, and how participation has been changing.
GET /v1/market/regime/latest
GET /v1/market/regime/history
Breadth & leadership
Measure market and sector breadth, leadership concentration, and how leadership has been rotating between groups.
GET /v1/breadth/sector/latest
GET /v1/leadership/summary/latest
GET /v1/leadership/rotation/history
Portfolio workflows
Construct, evaluate, and compare portfolios using structured decision outputs and Stock Trends market context.
POST /v1/portfolio/construct
POST /v1/portfolio/evaluate
POST /v1/portfolio/compare
Access for these premium endpoints: Subscription · x402 · MPP.
Check GET /v1/pricing/catalog for current per-endpoint pricing before
execution — it is authoritative, and costs should not be hard-coded.
Access Stock Trends intelligence
There is one Stock Trends intelligence layer. Below are the surfaces that carry it into your systems, and the rails that pay for premium usage. They are complementary — not separate products.
REST API
Direct programmatic integration for applications, trading systems, portfolio processes, and agent workflows. The API is the authoritative intelligence contract.
MCP
Tool-oriented access for MCP-compatible agents. A local stdio server exposes Stock Trends discovery, methodology, pricing, and evidence resources, plus free workflow cost planning and separately gated premium tools.
Machine payments
Standard x402 V2 per-request payment on Base, or MPP funded sessions for repeated agent workflows. A conforming x402 V2 buyer needs no Stock Trends-specific payment integration.
Subscription
Managed API-key access with monthly quota and rate limits, for regular development and production workloads.
The agent journey, start to finish
A new agent should not have to reverse-engineer this sequence. Everything up to step 5 is public and credential-free, so an agent can understand the service and price the work before it spends anything.
-
Discover
GET /v1/ai/tools— capability and workflow discovery -
Understand
GET /v1/ai/context— indicator definitions and dataset grounding -
Inspect evidence
GET /v1/ai/proof/market-edge— signal structure before payment -
Resolve
GET /v1/workflowsandGET /v1/instruments/resolve -
Estimate cost
GET /v1/pricing/catalogandGET /v1/cost-estimate - Choose a surface REST API for services and systems, MCP for agent environments
- Choose a rail Subscription, standard x402 V2, or MPP funded sessions
-
Execute
GET /v1/agent/screener/top— a recommended first premium call
ST-IM in context
ST-IM is one application of the broader Stock Trends classification framework, not the whole of it. Its contribution is probabilistic forward-return context: return distributions conditioned on how an instrument is currently classified.
Like any single layer, it is most useful read alongside the others — breadth, leadership, regime, and portfolio context — rather than on its own. Detailed methodology, probability interpretation, strengths, and limitations are set out on the ST-IM page.
The Published History Behind the API
Stock Trends has published systematic equity market analysis every week since 1993. Its indicators first appeared in the Financial Times of Canada and were later published for twenty years in The Globe and Mail. Today, Stock Trends reports, methodology, and market research continue at stocktrends.com.
The API carries that analytical lineage into structured software. Weekly price and volume observations are processed through the Stock Trends classification framework to create repeatable, comparable signals for trend, relative performance, volume activity, market breadth, sector leadership, and regime structure.
The historical classification record reaches back to 1980 and includes 16M+ weekly observations. That depth gives developers and agents research provenance for probabilistic analysis across market cycles; it does not guarantee future performance.
Important disclosures
Stock Trends provides structured market context and probabilistic research intelligence. Its outputs are not investment advice, price targets, direct buy/sell commands, or guarantees of future performance, and they are not a substitute for your own investment process, risk controls, or professional advice.
Historical depth does not eliminate uncertainty. The three evidence pillars — historical classification provenance, realized statistical outcome evidence, and strategy and model-portfolio evidence — rest on different methodologies and cover different time spans, as do the supporting weekly publication record and Monte Carlo process simulations. None of them should be combined into a single performance claim. Historical relationships may weaken or change in future market regimes, and real-world implementation involves transaction costs, taxes, execution slippage, liquidity constraints, and market risk, including the risk of loss.
Stock Trends model portfolios are rule-based model records with declared cost and stop-loss assumptions. They are not audited brokerage-account performance.