"""Routes for sentiment, insider trades, and analyst data (Finnhub + Alpha Vantage).""" import asyncio from fastapi import APIRouter, Path, Query from models import ApiResponse from route_utils import safe, validate_symbol import alphavantage_service import finnhub_service import logging logger = logging.getLogger(__name__) router = APIRouter(prefix="/api/v1") # --- Sentiment & News --- @router.get("/stock/{symbol}/sentiment", response_model=ApiResponse) @safe async def stock_sentiment(symbol: str = Path(..., min_length=1, max_length=20)): """Get aggregated sentiment: Alpha Vantage news sentiment + Finnhub analyst data.""" symbol = validate_symbol(symbol) finnhub_data, av_data = await asyncio.gather( finnhub_service.get_sentiment_summary(symbol), alphavantage_service.get_news_sentiment(symbol, limit=20), return_exceptions=True, ) if isinstance(finnhub_data, BaseException): logger.exception("Finnhub error", exc_info=finnhub_data) finnhub_data = {} if isinstance(av_data, BaseException): logger.exception("Alpha Vantage error", exc_info=av_data) av_data = {} data = {**finnhub_data, "alpha_vantage_sentiment": av_data} return ApiResponse(data=data) @router.get("/stock/{symbol}/news-sentiment", response_model=ApiResponse) @safe async def stock_news_sentiment( symbol: str = Path(..., min_length=1, max_length=20), limit: int = Query(default=30, ge=1, le=200), ): """Get news articles with per-ticker sentiment scores (Alpha Vantage).""" symbol = validate_symbol(symbol) data = await alphavantage_service.get_news_sentiment(symbol, limit=limit) return ApiResponse(data=data) @router.get("/stock/{symbol}/insider-trades", response_model=ApiResponse) @safe async def stock_insider_trades(symbol: str = Path(..., min_length=1, max_length=20)): """Get insider transactions (CEO/CFO buys and sells).""" symbol = validate_symbol(symbol) raw = await finnhub_service.get_insider_transactions(symbol) trades = [ { "name": t.get("name"), "shares": t.get("share"), "change": t.get("change"), "transaction_date": t.get("transactionDate"), "transaction_code": t.get("transactionCode"), "transaction_price": t.get("transactionPrice"), "filing_date": t.get("filingDate"), } for t in raw[:20] ] return ApiResponse(data=trades) @router.get("/stock/{symbol}/recommendations", response_model=ApiResponse) @safe async def stock_recommendations(symbol: str = Path(..., min_length=1, max_length=20)): """Get analyst recommendation trends (monthly buy/hold/sell counts).""" symbol = validate_symbol(symbol) raw = await finnhub_service.get_recommendation_trends(symbol) recs = [ { "period": r.get("period"), "strong_buy": r.get("strongBuy"), "buy": r.get("buy"), "hold": r.get("hold"), "sell": r.get("sell"), "strong_sell": r.get("strongSell"), } for r in raw[:12] ] return ApiResponse(data=recs) @router.get("/stock/{symbol}/upgrades", response_model=ApiResponse) @safe async def stock_upgrades(symbol: str = Path(..., min_length=1, max_length=20)): """Get recent analyst upgrades and downgrades.""" symbol = validate_symbol(symbol) raw = await finnhub_service.get_upgrade_downgrade(symbol) upgrades = [ { "company": u.get("company"), "action": u.get("action"), "from_grade": u.get("fromGrade"), "to_grade": u.get("toGrade"), "date": u.get("gradeTime"), } for u in raw[:20] ] return ApiResponse(data=upgrades)