Finvera

Product

Docs

Features

News

Explore Docs

API Products

Analyst Ratings

Overview

Copy

The Analyst Ratings API provides structured, real-time and historical access to equity analyst upgrades, downgrades, initiations, and reiterations across U.S. publicly traded companies. Built for developers, quant researchers, and fintech platforms, the API surfaces granular rating activity from major sell-side firms, normalized into a consistent JSON format for easy integration.

Key Features

Copy

Normalized Ratings: Converts varied broker terminology (e.g., “Overweight,” “Outperform,” “Buy”) into a standardized rating scale: Buy, Hold, Sell.

Firm Attribution: Each rating includes the originating firm, analyst name (if available), and timestamp of publication.
Target Price Tracking: Captures both new and previous price targets for each rating event, enabling delta analysis.
Historical Ratings Data: Query by ticker, firm, or rating type to retrieve past analyst actions for backtesting or trend analysis.
Real-Time Feed: New rating actions are available in real time via push or polling endpoints — ideal for triggering alerts or updating frontend views.
Ticker-Level Aggregation: Ratings data can be aggregated at the company level to derive current sentiment or analyst consensus.

Coverage

Copy

Firms: Includes top-tier investment banks and independent research shops with consistent U.S. equity coverage.

Universe: Primarily U.S.-listed equities, including large-cap and small-cap tickers across all sectors.
Latency: Sub-minute delivery for new ratings published during market hours.

Use Cases

Copy

Build consensus rating modules for investor dashboards

Backtest price impact of analyst upgrades/downgrades
Identify coverage changes and shifts in sentiment ahead of earnings
Generate alerts when multiple firms revise targets or change recommendations
Push notificataions

The Analyst Ratings API is ideal for developers looking to integrate real-time sell-side sentiment into trading models, financial news feeds, or stock discovery tools. With consistent formatting and rich metadata, it offers a clean foundation for deeper analysis of analyst behavior over time.

Schema

Copy

Note: Some fields and objects are replaced with ... to improve the readability of the responses in this document.

Perform a search for securities using a symbol or other search criteria.

Copy

curl --request GET \
  --url https://api.finvera.news/rating/api/v1/ratings

Copy

curl --request GET \
  --url https://api.finvera.news/rating/api/v1/ratings

Copy

{
  "data": [
    {
      "id": 414353025,
      "firm": "pipersandler",
      "ticker": "XPOF",
      "exchange": "unknown",
      "company": "Xponential Fitness Inc",
      "action": "Downgrades",
      "rating": "None",
      "price_target": "9.00",
      "story": "{\"XPONENTIAL FITNESS INC <XPOF.N>: PIPER SANDLER CUTS TARGET PRICE TO $9 FROM $16\"}",
      "is_rating": true,
      "created_at": "2025-03-14T04:19:07.312874Z",
      "updated_at": "2025-03-14T04:19:07.312877Z"
    },
    {
      "id": 901957700,
      "firm": "stifel",
      "ticker": "XPOF",
      "exchange": "unknown",
      "company": "Xponential Fitness Inc",
      "action": "Downgrades",
      "rating": "Hold",
      "price_target": "12.00",
      "story": "{\"XPONENTIAL FITNESS INC <XPOF.N>: STIFEL CUTS TO HOLD FROM BUY; CUTS TARGET PRICE TO $12 FROM $20\"}",
      "is_rating": true,
      "created_at": "2025-03-14T04:19:07.311919Z",
      "updated_at": "2025-03-14T04:19:07.311924Z"
    },
    {
      "id": 1888719425,
      "firm": "bmocapital",
      "ticker": "EHMEF",
      "exchange": "unknown",
      "company": "Goeasy",
      "action": "Upgrades",
      "rating": "Outperform",
      "price_target": "C$200",
      "story": "{\"BMO Capital upgraded Goeasy to Outperform from Market Perform with a price target of C$200, down from C$207. Goeasy trades at trough multiples on tariff-scenario earnings, effectively fully pricing-in downside risk from a prolonged trade war, the analyst tells investors in a research note. The firm added that the risk/reward now looks highly favorable and notes the +46% return to the new price target already factors in margins of safety on valuation multiples and earnings.\"}",
      "is_rating": true,
      "created_at": "2025-03-14T04:19:07.291679Z",
      "updated_at": "2025-03-14T04:19:07.291682Z"
    }
  ],
  "message": "ratings fetched successfully"
}

Copy

{
  "data": [
    {
      "id": 414353025,
      "firm": "pipersandler",
      "ticker": "XPOF",
      "exchange": "unknown",
      "company": "Xponential Fitness Inc",
      "action": "Downgrades",
      "rating": "None",
      "price_target": "9.00",
      "story": "{\"XPONENTIAL FITNESS INC <XPOF.N>: PIPER SANDLER CUTS TARGET PRICE TO $9 FROM $16\"}",
      "is_rating": true,
      "created_at": "2025-03-14T04:19:07.312874Z",
      "updated_at": "2025-03-14T04:19:07.312877Z"
    },
    {
      "id": 901957700,
      "firm": "stifel",
      "ticker": "XPOF",
      "exchange": "unknown",
      "company": "Xponential Fitness Inc",
      "action": "Downgrades",
      "rating": "Hold",
      "price_target": "12.00",
      "story": "{\"XPONENTIAL FITNESS INC <XPOF.N>: STIFEL CUTS TO HOLD FROM BUY; CUTS TARGET PRICE TO $12 FROM $20\"}",
      "is_rating": true,
      "created_at": "2025-03-14T04:19:07.311919Z",
      "updated_at": "2025-03-14T04:19:07.311924Z"
    },
    {
      "id": 1888719425,
      "firm": "bmocapital",
      "ticker": "EHMEF",
      "exchange": "unknown",
      "company": "Goeasy",
      "action": "Upgrades",
      "rating": "Outperform",
      "price_target": "C$200",
      "story": "{\"BMO Capital upgraded Goeasy to Outperform from Market Perform with a price target of C$200, down from C$207. Goeasy trades at trough multiples on tariff-scenario earnings, effectively fully pricing-in downside risk from a prolonged trade war, the analyst tells investors in a research note. The firm added that the risk/reward now looks highly favorable and notes the +46% return to the new price target already factors in margins of safety on valuation multiples and earnings.\"}",
      "is_rating": true,
      "created_at": "2025-03-14T04:19:07.291679Z",
      "updated_at": "2025-03-14T04:19:07.291682Z"
    }
  ],
  "message": "ratings fetched successfully"
}