{"uid":"cap_Jk9dD_Ka1xIGDpW2M5Nx8","slug":"finnhub-analyst-recommendation-trends-971f3ca7","name":"Finnhub Analyst Recommendation Trends","description":"Latest analyst recommendation trends: buy/hold/sell counts per period.","url":"https://gateway.apiosk.com/finnhub/stock/recommendation","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.143","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.13/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.13","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.13","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ronXAy88V1NT2JcR452RH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.13","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the latest analyst recommendation trends for a stock, including buy, hold, and sell counts per period.","exampleAgentPrompt":"What are the latest analyst buy/hold/sell recommendation counts for AAPL according to Finnhub?","exampleUseCases":[{"title":"Pre-earnings analyst sentiment check","prompt":"Before NVDA reports earnings, pull the latest analyst recommendation breakdown — how many say buy, hold, or sell?"},{"title":"Stock screening by analyst consensus","prompt":"I'm comparing TSLA and F — can you get me the current analyst buy/hold/sell counts for both so I can see which has stronger Wall Street backing?"},{"title":"Portfolio review analyst alignment","prompt":"For my position in MSFT, what does the latest Finnhub analyst recommendation data look like — how many analysts are bullish versus bearish right now?"}],"resultDescription":"Returns a time-series array of analyst recommendation periods, each containing counts for strongBuy, buy, hold, sell, and strongSell ratings, along with the period date. Covers recent historical periods so you can see trends in consensus shifts.","failureModes":["Invalid or unrecognized ticker symbol returns empty array or error","Missing required symbol parameter returns 400 bad request","Payment failure via x402 returns HTTP 402 if USDC balance is insufficient","Rate limiting or gateway timeout if called too frequently","Ticker with no analyst coverage returns empty results"],"whenToPreferThis":"Choose this endpoint when you need quantitative analyst consensus data (buy/hold/sell counts) for a specific stock, especially when tracking how Wall Street sentiment has shifted over recent periods. It is ideal for portfolio monitoring, pre-trade research, or building dashboards that compare analyst sentiment across multiple equities. Prefer this over price-based endpoints when the question is about professional analyst opinion rather than market price movement.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:55:25.287Z","isFirstParty":false}