one key · JSON over HTTPS

Market signals
your product can ship.

Reddit, X, AlphaAI financial news, Polymarket probabilities, filings, insider trades, and congressional disclosures under one versioned contract.

1D, 3D, 7D, and 30D windows · CORS enabled · original social post text excluded

GET https://api.marketrelay.dev/v1/trending?days=1&limit=2200 OK
{
  "source": "x",
  "window_days": 1,
  "data": [{
    "ticker": "NVDA",
    "attention_score": 92.4,
    "mentions": 482,
    "unique_authors": 319,
    "mention_change_pct": 135,
    "chatter_tone": "mixed"
  }]
}
version 1

One contract. Every product.

GET/api/v1/trending

Rank stocks by attention score, author breadth, velocity, and concentration.

GET/api/v1/trending/sectors

Aggregate attention into curated market themes and their top tickers.

GET/api/v1/trending/countries

Aggregate attention by listing country.

GET/api/v1/market

Read the market-wide X activity snapshot and its top attention drivers.

GET/api/v1/tickers/{ticker}

Inspect one ticker's volume, tone mix, driver research, and evidence metadata.

GET/api/v1/tickers/{ticker}/explain

Explain why one ticker is drawing attention, with themes and counter-signals.

GET/api/v1/tickers/{ticker}/mentions

Audit aggregate evidence metadata without redistributed post text, IDs, or URLs.

GET/api/v1/compare

Compare up to ten tickers in the same event window.

GET/api/v1/search

Resolve a ticker or company name inside the active market map.

GET/api/v1/reddit/stocks/v1/trending

Rank stocks by sampled Reddit discussion and derived sentiment.

GET/api/v1/reddit/stocks/v1/trending/sectors

Rank curated market themes by Reddit activity.

GET/api/v1/reddit/stocks/v1/trending/countries

Aggregate Reddit activity by listing country.

GET/api/v1/reddit/stocks/v1/stock/{ticker}

Inspect Reddit mention, breadth, engagement, and sentiment metrics.

GET/api/v1/reddit/stocks/v1/stock/{ticker}/explain

Explain why a stock is drawing Reddit attention.

GET/api/v1/reddit/stocks/v1/stock/{ticker}/mentions

Audit privacy-safe Reddit evidence metadata without source content.

GET/api/v1/reddit/stocks/v1/compare

Compare Reddit sentiment for up to ten tickers.

GET/api/v1/reddit/stocks/v1/search

Search stocks active in the current Reddit snapshot.

GET/api/v1/reddit/stocks/v1/market-sentiment

Read the market-wide sampled Reddit sentiment snapshot.

GET/api/v1/news/stocks/v1/trending

Rank stocks by relevance-scored, publisher-weighted news coverage.

GET/api/v1/news/stocks/v1/trending/sectors

Rank market themes by financial-news coverage.

GET/api/v1/news/stocks/v1/trending/countries

Aggregate news coverage by listing country.

GET/api/v1/news/stocks/v1/stock/{ticker}

Inspect ticker-linked news breadth, velocity, and sentiment.

GET/api/v1/news/stocks/v1/stock/{ticker}/explain

Explain why a stock is active in the headline cycle.

GET/api/v1/news/stocks/v1/stock/{ticker}/mentions

Audit publisher and sentiment evidence without article bodies.

GET/api/v1/news/stocks/v1/compare

Compare news sentiment for up to ten tickers.

GET/api/v1/news/stocks/v1/search

Search stocks active in the current news snapshot.

GET/api/v1/news/stocks/v1/market-sentiment

Read the market-wide financial-news sentiment snapshot.

GET/api/v1/polymarket/stocks/v1/trending

Rank stocks by ticker-linked prediction-market activity.

GET/api/v1/polymarket/stocks/v1/trending/sectors

Rank market themes by prediction-market activity.

GET/api/v1/polymarket/stocks/v1/trending/countries

Aggregate prediction-market signals by listing country.

GET/api/v1/polymarket/stocks/v1/stock/{ticker}

Inspect implied probabilities, activity, and directional signals.

GET/api/v1/polymarket/stocks/v1/stock/{ticker}/mentions

Audit market-level probability and activity evidence.

GET/api/v1/polymarket/stocks/v1/compare

Compare prediction-market conviction across ten tickers.

GET/api/v1/polymarket/stocks/v1/search

Search stocks linked to active prediction markets.

GET/api/v1/polymarket/stocks/v1/market-sentiment

Read the market-wide prediction-market snapshot.

GET/api/v1/sources

Check which source integrations are live, syncing, or awaiting configuration.

GET/api/v1/events

Query normalized market events by ticker, source, type, or date.

GET/api/v1/insiders/trades

Read normalized SEC insider transactions.

GET/api/v1/politicians/trades

Read licensed political disclosures with reporting-lag context.

GET/api/v1/sec/filings

Query normalized SEC filings by ticker and filing date.

GET/api/v1/tickers/{ticker}/events

Retrieve every normalized event attached to one ticker.

GET/api/v1/tickers/{ticker}/signals

Combine social attention and normalized events for one symbol.

GET/api/v1/openapi.json

Load the public OpenAPI 3.1 contract.

authentication

One header. Seven days.

Create a key in the developer console. The trial starts with your first key and access stops automatically after seven days. Keys are stored as one-way hashes.

curl 'https://api.marketrelay.dev/v1/trending?days=1'   -H 'X-API-Key: sf_live_your_key'
Attention, not price direction

Trend status measures whether discussion is accelerating. Tone is reported separately so “popular” is never mistaken for “bullish.”

Harder to game

Unique-author breadth is rewarded and source concentration is penalized. Repeated posts from one loud account do not become a market trend.

Copyright-conscious

Aggregate endpoints do not reproduce original post text or media. Ticker detail returns derived research and limited evidence metadata.