← Back to API

Changelog

All notable changes to the Stock Sentiment API.

Format: Keep a Changelog

Versioning: Semantic Versioning

---

[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