← Back to API

Changelog

All notable changes to the Stock Sentiment API.

Format: Keep a Changelog

Versioning: Semantic Versioning

[1.22.0] - 2026-03-23

Added

New GET /market-sentiment endpoint on all public platform namespaces:

- /reddit/stocks/v1/market-sentiment

- /x/stocks/v1/market-sentiment

- /news/stocks/v1/market-sentiment

- /polymarket/stocks/v1/market-sentiment

- /reddit/crypto/v1/market-sentiment

Service-level market sentiment responses now expose breadth/activity fields, service-wide sentiment counts, bullish/bearish percentages, trend_history, and top drivers ranked by current asset buzz_score.

Changed

market-sentiment uses a hybrid read path in V1: completed-day history comes from platform *_daily_stats, while the current live slot is computed from raw mentions/live snapshots for parity with existing trending endpoints.

[1.21.2] - 2026-03-23

Fixed

X and Polymarket trend_history now use the same calendar-day semantics as Reddit: completed UTC days stay intact and today's live buzz is appended in the final slot instead of overwriting the last completed day.
X and Polymarket schema/docs now describe trend_history consistently as completed UTC calendar days plus the current live-day value.

[1.21.1] - 2026-03-22

Fixed

Reddit V1 thread-context inheritance now only applies to single-ticker parent contexts, eliminating broad multi-ticker reply fan-out.
Low-signal acknowledgement replies like yes, yep, and ok now stay neutral instead of inheriting or drifting positive on their own.
Finance phrase overrides now still affect the ensemble path, while strategy-heavy phrases like covered calls, cash secured puts, and straddles are handled as contextual instead of blindly directional.
Weak bare-symbol detection is tighter for noisy finance acronyms and broker-style mentions, reducing false positives without weakening explicit cashtag handling.
X ticker validation now fails closed when the ticker reference cache is empty unless a caller explicitly opts into the fallback path.

[1.21.0] - 2026-03-19

Changed

Compare endpoint harmonization shipped across Reddit, News, Reddit Crypto, X, and Polymarket with richer watchlist fields such as trend, trend_history, sentiment percentages, and platform-specific volume metrics.
Public sentiment fields are now serialized consistently to 3 decimal places across API responses.
Legacy compare aliases are now explicitly marked as deprecated in OpenAPI and docs:

sentiment -> sentiment_score, upvotes -> total_upvotes.

Daily detail trend items now also expose canonical sentiment_score, while keeping

legacy sentiment as a deprecated /v1 alias.

Detail responses for Reddit, News, X, and Reddit Crypto now expose canonical

mentions, while keeping legacy total_mentions as a deprecated /v1 alias.

X compare docs/schema are now aligned with the intended compare contract: is_validated is not part of /x/stocks/v1/compare, while remaining available on X trending and X stock-detail responses.
Search endpoint harmonization shipped across Reddit, News, Reddit Crypto, X, and Polymarket with compact period-scoped summary blocks and explicit days / limit query parameters.
Search endpoints now require at least 2 non-$ query characters after trimming; results are limited to the top ranked matches for the query.

Breaking

Search endpoints no longer expose top-level mention_count or trade_count; platform activity metrics now live inside results[].summary.

[1.20.1] - 2026-03-16

Changed

Security: various hardening changes across authentication, trusted delivery handling, and production configuration.
Operations: hardened production news-worker Miniflux authentication handling.

[1.20.0] - 2026-03-12

Added

Internal backend support for newsletter unsubscribe links for API accounts.
Persistent newsletter opt-out state on API accounts via api_keys.newsletter_unsubscribed_at, preserved across recovery/key rotation flows.

Changed

Polymarket buzz_score was recalibrated to be activity-first: trade_count now carries the most weight, market_count stays the main breadth signal, and total_liquidity is treated as a secondary windowed depth signal instead of dominating the rank.
Polymarket schema/docs now define total_liquidity as a windowed aggregated liquidity signal over the selected days period, not a live snapshot.
Polymarket schema/docs now describe unique_traders as a best-effort participation signal that can overcount across markets and days.
Polymarket top_mentions on /polymarket/stocks/v1/stock/{ticker} now uses a hybrid relevance order: traded markets first, then trade_count, then volume_24h, then liquidity, so inactive but deep markets no longer dominate the detail view.

[1.19.2] - 2026-03-12

Fixed

Polymarket sentiment fields now return null instead of price-derived sentiment when no trades exist in the relevant period, day, or market snapshot.
Polymarket API docs and schema metadata now document the zero-trade null sentiment contract consistently.

[1.19.1] - 2026-03-07

Fixed

News endpoint contracts tightened: source is no longer accepted on stock, stock/{ticker}/explain, search, compare, and stats, and unsupported usage now returns 422 instead of being silently ignored.
SDKs and CLI aligned with the tightened News contract, removing unsupported source parameters from public helper methods and endpoint metadata.
API documentation pricing corrected: Professional now shows $249/mo.

[1.19.0] - 2026-03-05

Added

New News Stocks API platform at /news/stocks/v1 with endpoint parity:

- GET /trending

- GET /trending/sectors

- GET /trending/countries

- GET /stock/{ticker}

- GET /stock/{ticker}/explain

- GET /search

- GET /compare

- GET /stats

- GET /health (public)

New News worker runtime (worker --mode=news) with dedicated heartbeat/job-state tracking.
New news data model tables:

- news_mentions

- news_daily_stats

New split OpenAPI spec at /openapi.news.yaml.
New SDK/CLI News integration:

- Python SDK namespace client.news.*

- TypeScript SDK client.news.*

- CLI platform news-stocks for trending, search, compare, stats, health

Changed

Root API discovery and health maps now include news-stocks.
News responses now use source-oriented fields (source_count, top_sources) instead of Reddit-only fields like unique_posts, total_upvotes, and top_subreddits.
News trend_history and daily buzz behavior now follow the Reddit daily-stats model, with the latest value computed live for parity.
Ops/deploy topology now includes worker-news, News volume in daily ops reporting, and a dedicated deploy workflow.

Fixed

News bootstrap now falls back across alternate feed candidates when Miniflux rejects the first feed URL.
Google News URL decoding hardened with 429-aware handling, bounded retry budget, and stable publisher-URL fallback.
Miniflux feed dedupe now removes obsolete/duplicate managed feeds and persists cleanup results in worker_job_state.

[1.18.0] - 2026-02-25

Added

New Reddit Crypto API platform at /reddit/crypto/v1 with endpoint parity:

- GET /trending

- GET /token/{symbol}

- GET /compare

- GET /search

- GET /stats

- GET /health (public)

New Crypto Reddit worker runtime (worker --mode=crypto-reddit) with dedicated heartbeat (worker_type='crypto_reddit').
New crypto data model tables:

- crypto_reddit_mentions

- crypto_reddit_daily_stats

- crypto_reference

- crypto_unknown_coins

New unknown-coin lifecycle for crypto mentions (collection + periodic maintenance/cleanup).

Changed

Deployment topology hardened for one shared API + independently deployable workers to avoid crawler interruptions during unrelated deploys.
API root and platform base landing responses standardized to expose public health paths and protected endpoint maps.

[1.17.0] - 2026-02-23

Changed

BREAKING (Polymarket API): normalized activity fields away from Reddit/X naming:

- /polymarket/stocks/v1/trending

- /polymarket/stocks/v1/trending/sectors

- /polymarket/stocks/v1/trending/countries

- /polymarket/stocks/v1/stock/{ticker}

- /polymarket/stocks/v1/compare

Replaced legacy Polymarket fields mentions, total_upvotes, total_mentions with:

- trade_count

- market_count

- unique_traders (nullable where source data is unavailable)

Removed Polymarket aggregate volume_24h from trending and compare responses.
Polymarket daily_trend[] now uses trade_count (instead of mentions).
Polymarket top_mentions[] now includes trade_count and sentiment_score while keeping market-level volume_24h.

Fixed

TypeScript SDK Polymarket response types aligned with the new Polymarket contract.
Python SDK generation path refreshed from current OpenAPI spec and Polymarket wrapper tests updated to the new field names.

[1.16.0] - 2026-02-18

Added

New Polymarket API platform at /polymarket/stocks/v1 with Reddit/X-parity endpoint set:

- GET /trending

- GET /trending/sectors

- GET /trending/countries

- GET /stock/{ticker}

- GET /search

- GET /compare

- GET /stats

- GET /health (public)

New worker mode --mode=polymarket with hourly ingest and daily maintenance window.
New database tables:

- polymarket_mentions (append-only snapshots)

- polymarket_daily_stats (daily API read model)

New Docker/Deploy worker service worker-polymarket.

Changed

Root API metadata and health maps now include polymarket.
Split OpenAPI generation now includes openapi.polymarket.yaml.
Worker heartbeat now supports worker_type='polymarket'.

[1.15.0] - 2026-02-09

Added

trend, bullish_pct, bearish_pct fields on /stock/{ticker} endpoint (Reddit + X)
buzz_score in daily_trend items for historical buzz visibility (Reddit + X)

[1.14.0] - 2026-02-07

Added

VADER + Twitter-RoBERTa ONNX ensemble for sentiment analysis (+6.4pp benchmark accuracy uplift)
Quantized INT8 ONNX model (126MB) baked into Docker image for deterministic builds
SENTIMENT_USE_ENSEMBLE config flag for runtime toggle (production compose: disabled for API only)
Batched RoBERTa inference support in analyze_sentiment_batch()

[1.13.0] - 2026-02-04

Added

POST /auth/v1/key-token - Create one-time token for secure API key delivery (Bearer auth)
GET /auth/v1/key-token/{token} - Redeem token to retrieve API key (no auth, token is auth)
Secure key delivery system: API keys never sent via email, only via one-time tokens
24-hour token expiration, single-use, rate-limited (5/min per IP)

[1.12.0] - 2026-02-04

Changed

BREAKING: Root endpoint (/) response docs.swagger and docs.redoc replaced with docs.api_reference
API documentation now uses Scalar instead of Swagger UI/ReDoc
Health endpoint tag renamed from "Public" to "Status" in OpenAPI schema

[1.11.0] - 2026-01-28

Changed

Buzz Score V5.4: Diversity now uses HHI (Herfindahl-Hirschman Index) internally
Echo chambers (e.g., 95% in one subreddit) get reduced diversity scores
No API changes - HHI calculation is internal to buzz score

[1.10.0] - 2026-01-27

Added

POST /auth/v1/provision - Internal API key provisioning (Bearer auth)
API key provisioning metadata: external_order_id, source

Changed

BREAKING: Auth endpoint moved to /auth/v1/register (old /reddit/stocks/v1/register removed)

[1.9.0] - 2026-01-21

Added

trend_history field in /reddit/stocks/v1/trending response - daily buzz scores (length = max(days, 7))

[1.8.0] - 2026-01-21

Added

type query parameter for /reddit/stocks/v1/trending - filter by stock, etf, or all

[1.7.0] - 2026-01-20

Changed

BREAKING: PostgreSQL-only - SQLite support removed (f915c0f)

[1.6.0] - 2026-01-17

Added

Thread-context sentiment analysis - comments inherit ticker from parent (6148ca4)
Weighted mentions: inherited mentions count at 0.1x in buzz score
Ticker alias resolution (GOOGL → GOOG) (fdaa403)

[1.5.0] - 2026-01-13

Added

GET /reddit/stocks/v1/trending/sectors - Trending by GICS sector (6876724)
GET /reddit/stocks/v1/trending/countries - Trending by country (6876724)
GET /reddit/stocks/v1/stock/{ticker}/explanation - AI trend explanations (a05d7be)
sector and country fields in /search response (48b5646)

[1.4.0] - 2026-01-12

Added

Buzz Score V5.2 with time-normalized formula (abc76df)
Zero-downtime blue-green deployment (bb37679)

[1.3.0] - 2026-01-09

Added

Cross-container worker heartbeat for health checks (5926828)
Bot content filtering (AutoModerator, stickied posts) (983fc55)

[1.2.0] - 2026-01-04

Added

offset parameter for pagination on /trending endpoints (5e8a300)

[1.1.0] - 2026-01-02

Added

Code-First OpenAPI documentation at /openapi.yaml (41be106)
Buzz Score V2 with quality metrics (c68946b)
Multi-factor trend calculation (6da430d)

Changed

BREAKING: X API response format aligned with Reddit API (4cb7866)
BREAKING: Database tables renamed stock_* → reddit_* (a3eb28b)

[1.0.0] - 2025-12-31

Added

X/Twitter API at /x/stocks/v1 (39c1735)

- GET /x/stocks/v1/trending - Trending stocks from Grok

- GET /x/stocks/v1/stock/{ticker} - X data for ticker

- GET /x/stocks/v1/stats - Service statistics

- GET /x/stocks/v1/health - Health check

[0.9.0] - 2025-12-30

Changed

BREAKING: API migrated to api.adanos.org/reddit/stocks/v1 (c1696c3)

Added

FinanceDatabase ticker validation with nightly sync (8c7ca64)

[0.8.0] - 2025-12-29

Added

Emoji and phrase detection in sentiment analysis (65beeb4)
Parallel workers for sentiment processing (6ee12df)

Changed

Free tier limit reduced: 1000 → 250 requests/month (177ca90)

[0.7.0] - 2025-12-28

Added

company_name field in API responses (958b4b0)
Separate API and Worker containers (617ee3f)
Cryptocurrency ticker exclusion (b28a79a)
Daily stats aggregation system (80c6a20)
Tiered API keys: free, premium (6021563)
Ticker database with 11,800+ symbols (4e261e9)
Dynamic $TICKER detection in posts (9b938a3)

[0.6.0] - 2025-12-27

Added

Initial Stock Sentiment API (c87a5ad)

- GET /reddit/stocks/v1/trending - Trending stocks by buzz score

- GET /reddit/stocks/v1/stock/{ticker} - Stock sentiment report

- GET /reddit/stocks/v1/search - Search by ticker/name

- POST /reddit/stocks/v1/register - Self-service API key registration

- GET /reddit/stocks/v1/health - Health check

Changed

BREAKING: Restructured from general Reddit scraper to Stock Sentiment API
Dashboard and CLI scraper deprecated