API

Public JSON endpoints

Market Ahead exposes investor-oriented market data: ranked picks, stock trend signals, daily scan metrics, crypto trend snapshots, macro context, and prediction-market links. These are research signals, not investment advice. Routes return JSON with an error field when upstream data is unavailable.

GET/api/assets/picks

Ranked stock and crypto ideas.

curl -sS '/api/assets/picks'
Ready
{
  "status": "Select an endpoint, adjust params, and run the request."
}

Useful Investor Signals

Start here for endpoints that can power screeners, dashboards, alerts, or watchlist research.

Cross-asset picks

GET
/api/assets/picks

Ranked stock and crypto ideas with direction, confidence, reasons, risk flags, freshness, and links.

pickScoresignal.directionsignal.confidencereasonriskFlags

Stock signal snapshot

GET
/api/stocks/symbol?symbol=AAPL

Complete symbol-level stock payload: quote, profile, fundamentals, events, history, macro, scan metrics, and signals.

data.quotedata.timeseriessignals.computedsignals.cachedSummarysignals.assetSnapshot

Daily scan metrics

GET
/api/scan/metrics

Universe-wide technical grid for screening momentum, mean reversion, liquidity spikes, and earnings proximity.

rsi14volRatio20return21dpctFrom52wHighnextEarningsDate

Crypto trend snapshot

GET
/api/crypto/trend-snapshot

Trend and risk scores for crypto assets, built from cached market data and deterministic scoring rules.

trendmomentumrisklastRefreshed

Signal Scan

Daily technical snapshots across the curated U.S. stock universe.

GET/api/stocks/signals/snapshot

Latest deterministic signal summary by stock symbol.

GET/api/stocks/symbol

Complete stock data and all available signals for one ticker.

symbol·
Ticker symbol.
GET/api/scan/metrics

Latest signal grid with RSI, volume, trend, return, and earnings fields.

Stocks

Search, quotes, profiles, fundamentals, macro context, and price history.

GET/api/stocks/search

Ticker search by symbol or company name.

q·
Search query.
GET/api/stocks/quote

Latest quote for a single symbol.

symbols·
One ticker symbol.
GET/api/stocks/symbol

Complete get-by-symbol response with quote, company, fundamentals, earnings, recommendations, history, macro context, prediction links, scan metrics, computed trend signals, cached signal summary, and asset signal snapshot.

symbol·
Ticker symbol.
GET/api/stocks/quotes

Bulk quotes for one or more symbols.

symbols
Comma-separated ticker symbols.
GET/api/stocks/prices

Cached daily-close snapshot for every tracked symbol.

GET/api/stocks/snapshot

Cached company snapshot for the tracked stock universe.

GET/api/stocks/timeseries

Daily OHLCV bars used by the signal engine.

symbol·
Ticker symbol.
GET/api/stocks/company

Company profile (name, sector, market cap, description).

symbol·
Ticker symbol.
GET/api/stocks/fundamentals

Latest fundamentals snapshot (P/E, debt/equity, dividend yield, etc.).

symbol·
Ticker symbol.
GET/api/stocks/fundamentals/snapshot

Cached fundamentals snapshot for the tracked stock universe.

GET/api/stocks/earnings

Recent and upcoming earnings dates with EPS and revenue surprises.

symbol·
Ticker symbol.
GET/api/stocks/recommendations

Aggregated analyst recommendations (buy/hold/sell counts over time).

symbol·
Ticker symbol.
GET/api/stocks/macro

FRED macro series (rates, inflation, labor, curve, recession).

GET/api/stocks/related-events

Prediction-market events related to a stock symbol.

symbol·
Ticker symbol.

Crypto

Market snapshots, trend scores, and daily price history.

GET/api/crypto/markets

Cached prices, market caps, and 24h/7d/30d changes.

GET/api/crypto/timeseries

Daily price history for a single asset.

symbol·
Crypto symbol (e.g. BTC, ETH).
GET/api/crypto/trend-snapshot

Deterministic trend, momentum, and risk score per asset.

Asset Picks

Unified public picks combining stocks and crypto.

GET/api/assets/picks

Ranked picks with reasons, risk flags, freshness, and canonical links.