--- name: api.stocktrends.com description: api.stocktrends.com provides weekly trend-based stock selections and market regime data derived from quantitative models. It exposes four endpoints covering current stock picks with probability and return metrics, current market regime classification, and historical regime data. All data is published on a weekly cadence with no intraday or real-time feeds. host: api.stocktrends.com --- # api.stocktrends.com StockTrends is a quantitative signal provider focused on weekly trend analysis for equity markets. It serves agents and systems that need model-generated stock pick rankings and macro regime context for portfolio screening, watchlist construction, or strategy backtesting. Its outputs are statistical in nature — probability scores and expected return ranges — rather than fundamental or news-driven signals. ## When to use this host Use this host when an agent needs weekly quantitative stock pick rankings with probability scores or market regime classifications. It is appropriate for portfolio screening, watchlist generation, macro trend context, and regime-based strategy framing. Do not use this host for real-time or intraday price data, fundamental financial metrics (earnings, valuation ratios), news-driven signals, options data, or historical stock pick archives from prior weeks — the pick endpoints return only the most recently published batch. For real-time pricing or OHLCV data, route to a dedicated market data provider. For fundamental analysis, route to a financial data host with balance sheet and income statement coverage. ## Capabilities ### Weekly Stock Picks Retrieves the current week's model-selected stock picks with probability scores and expected return ranges across multiple horizons, suitable for screening and watchlist generation. - **`fetch-latest-stock-picks`** — Returns the latest published weekly stock selections from StockTrends, including per-symbol probability scores and expected return ranges across 4-week, 13-week, and 40-week horizons. - **`fetch-stock-trends-latest-picks`** — Returns the latest weekly stock selections from StockTrends, including ticker symbol, exchange, and 13-week probability score for each pick. ### Market Regime Intelligence Provides both the current market regime classification (bullish, bearish, mixed) with confidence metrics and a historical record of weekly regime transitions for trend context and backtesting. - **`fetch-market-regime-snapshot`** — Returns the latest stock market regime classification (bullish, bearish, or mixed) with confidence score, regime score, bullish/bearish percentages, average RSI, and signal count. - **`fetch-market-regime-history`** — Returns weekly historical market regime classifications (bullish, bearish, mixed) with confidence levels, regime scores, RSI averages, and signal counts for trend and cycle analysis. ## Workflows ### Regime-Filtered Stock Screening *Use when an agent needs to evaluate the current week's stock picks in the context of prevailing market conditions before acting on them.* 1. **`fetch-market-regime-snapshot`** — Retrieve the current market regime label and confidence score to establish macro context before evaluating individual picks. 2. **`fetch-latest-stock-picks`** — Retrieve the current week's ranked stock selections with probability and return metrics, then filter or weight picks based on the regime context obtained in the prior step. ### Historical Regime Backtest Context *Use when an agent needs to assess how current stock picks have historically performed across different regime periods.* 1. **`fetch-market-regime-history`** — Retrieve the historical weekly regime classifications to identify past bullish, bearish, and mixed periods for comparison. 2. **`fetch-market-regime-snapshot`** — Retrieve the current regime snapshot to anchor the historical analysis to the present market state. 3. **`fetch-latest-stock-picks`** — Retrieve the current picks and cross-reference them against the historical regime context to inform strategy decisions. ## Skill reference ### `fetch-latest-stock-picks` **Latest Stock Picks** — Returns the latest published weekly stock selections from StockTrends, including per-symbol probability scores and expected return ranges across 4-week, 13-week, and 40-week horizons. *Use when:* Use when an agent needs the current week's ranked stock selections with quantitative probability and return metrics (prob13wk, x4wk, x13wk, x40wk) to support trading decisions or portfolio screening. *Not for:* Do not use for historical selections from prior weeks, real-time price feeds, or intraday trading signals; this endpoint returns only the most recently published weekly batch. **Returns:** Returns a selections payload with request_id, weekdate, filter metadata, a count of 217, and a data array of stock symbols each with prob13wk probability score and expected return ranges (lower, mid, upper, stddev) for 4-week, 13-week, and 40-week horizons. **Example:** `GET https://api.stocktrends.com/v1/selections/published/latest` --- ### `fetch-market-regime-history` **Market Regime History** — Returns weekly historical market regime classifications (bullish, bearish, mixed) with confidence levels, regime scores, RSI averages, and signal counts for trend and cycle analysis. *Use when:* Use when an agent needs to analyze historical market regime transitions over time, assess current trend context, or backtest strategies against past bullish/bearish/mixed regime periods. *Not for:* Do not use for real-time intraday market data or individual stock analysis; this endpoint covers broad market regime aggregates on a weekly basis only. **Returns:** Returns a history array of weekly regime objects each containing weekdate, regime label, confidence, regime_score, bullish_pct, bearish_pct, avg_rsi, avg_mt_cnt, and signal_count, plus top-level count, limit, and start_date fields. **Example:** `GET https://api.stocktrends.com/v1/market/regime/history` --- ### `fetch-stock-trends-latest-picks` **Stock Trends Latest Picks** — Returns the latest weekly stock selections from StockTrends, including ticker symbol, exchange, and 13-week probability score for each pick. *Use when:* Use when an agent needs the current week's ranked stock selections with probability scores, such as for screening, portfolio research, or generating a watchlist based on trend-based model outputs. *Not for:* Do not use for historical selections from prior weeks, real-time price data, or fundamental financial metrics — this endpoint returns only the latest model-selected picks with probability scores. **Returns:** Returns a JSON object with request metadata, the selection weekdate, a count of 217 picks, and a data array where each entry contains a ticker symbol, exchange code, 13-week probability score, and a combined symbol_exchange identifier. **Example:** `GET https://api.stocktrends.com/v1/selections/latest` --- ### `fetch-market-regime-snapshot` **Market Regime Snapshot** — Returns the latest stock market regime classification (bullish, bearish, or mixed) with confidence score, regime score, bullish/bearish percentages, average RSI, and signal count. *Use when:* Use when an agent needs a current macro market regime label and supporting quantitative metrics to inform trading decisions, portfolio allocation, or risk assessment. *Not for:* Do not use for individual stock analysis or intraday price data; this endpoint reflects aggregate market-wide regime state only. **Returns:** Returns a single JSON object with regime label, confidence, regime_score, bullish_pct, bearish_pct, avg_rsi, avg_mt_cnt, weekdate, and signal_count for the latest market snapshot. **Example:** `GET https://api.stocktrends.com/v1/market/regime/latest` ---