one key · JSON over HTTPS

Market signals
your product can ship.

Reddit, X, financial-news sentiment, and Polymarket probabilities under one versioned contract.

Try live JSON  →Create API key

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/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.