{"uid":"cap_wDrMUEBJJ_LIbE4UhIXDJ","slug":"2s-io-stock-analyst-recommendation-trends-1d0d1073","name":"2s.io Stock Analyst Recommendation Trends","description":"Analyst recommendation trend for a US-listed company — the number of analysts rating it strong buy, buy, hold, sell, and strong sell, snapshotted per month (newest first). Pass ticker. Use it to see the consensus and how sentiment is shifting over time. Data by Finnhub.","url":"https://2s.io/api/stocks/recommendations","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["ticker"],"properties":{"ticker":{"type":"string","description":"US-listed ticker, e.g. AAPL."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","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.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KfhGlD-WBVNlxyfmXyzIL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns monthly snapshots of analyst rating counts (strong buy, buy, hold, sell, strong sell) for a US-listed stock ticker, newest first.","exampleAgentPrompt":"What's the current analyst consensus on NVDA — show me how many analysts rate it strong buy, buy, hold, sell, or strong sell, and whether sentiment has been shifting over recent months.","exampleUseCases":null,"resultDescription":"An array of monthly snapshots ordered newest first, each containing the count of analysts rating the stock strong buy, buy, hold, sell, and strong sell, along with the month/period identifier.","failureModes":["Invalid or unknown ticker returns an empty result or error","Non-US-listed tickers may not be found in Finnhub data","Missing required ticker query parameter returns a 400 or validation error","Payment failure (x402) if USDC balance is insufficient","Finnhub data may have a lag of days to weeks for the most recent month"],"whenToPreferThis":"Use this endpoint when you need historical analyst rating counts and trend data by month for a US-listed equity. Prefer this over earnings or price endpoints when the user wants to understand Wall Street sentiment, consensus direction, or rating drift over time. It is specifically backed by Finnhub's professional analyst data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:14:08.819Z","isFirstParty":false}