{"uid":"cap_zaQDzzq0wEM1d2kcUuyy_","slug":"otto-ai-analyst-ratings-b41b110e","name":"Otto AI Analyst Ratings","description":"Analyst consensus for a vendor-resolved equity: the latest buy/hold/sell distribution (strong buy · buy · hold · sell · strong sell counts, total, and a deterministic consensus label) plus up to six months of the same distribution so an agent can read the DRIFT — is the street moving toward or away from the name. Vendor counts (Finnhub), our label rule stated in the payload. No price targets and no per-analyst grade actions are served.","url":"https://x402.ottoai.services/analyst-ratings","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"Vendor-supported equity or ETF ticker (e.g. AAPL, NVDA, TSLA, SPY); returned monetary values use the vendor payload units and are not relabeled as USD."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status"],"properties":{"data":{},"meta":{"type":"object"},"reason":{"type":"string","description":"status=unavailable only; every >=400 is UNCHARGED"},"status":{"enum":["success","unavailable"],"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"drift":{"monthsCovered":4,"bullishSharePct":91.07,"netBullishDelta":1},"ticker":"AVGO","provider":"Finnhub","consensus":{"buy":34,"asOf":"2026-08-01","hold":5,"sell":0,"label":"Buy","strongBuy":17,"strongSell":0,"totalRatings":56},"methodology":"label = Buy when strongBuy+buy ≥ 60% of all ratings, upgraded to Strong Buy only when strongBuy alone is also ≥ 50% of all ratings; Sell / Strong Sell mirrored on the bearish side (sell+strongSell ≥ 60%, strongSell ≥ 50%); otherwise Hold — a Strong label always requires the 60% directional majority first. Counts are the vendor's (Finnhub monthly recommendation trends); drift compares (bullish − bearish) in the latest vs the oldest covered month.","consensusTrend":[{"buy":34,"hold":5,"sell":0,"period":"2026-08-01","strongBuy":17,"strongSell":0,"totalRatings":56}]},"meta":{"degraded":false,"validUntil":"","generatedAt":"","stalenessSec":0},"status":"success"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PYF4HsrGHpyEcPYq-gyxC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Wall Street analyst consensus ratings, price targets, and 90-day revision momentum for a given equity or ETF ticker","exampleAgentPrompt":"What's the current Wall Street analyst consensus on NVDA — is it a Buy, and what's the price target relative to where it's trading now?","exampleUseCases":[{"title":"Pre-trade analyst sentiment check","prompt":"Before I buy more TSLA, what do analysts think about it right now — Buy, Hold, or Sell — and how does their price target compare to the current price?"},{"title":"Earnings research briefing","prompt":"I'm preparing for AAPL earnings next week. What's the current analyst consensus rating, price target, and have there been more upgrades or downgrades in the past 90 days?"},{"title":"ETF analyst sentiment overview","prompt":"What do Wall Street analysts say about SPY right now — what's the consensus rating and target price versus where it's currently trading?"}],"resultDescription":"Returns a JSON object with the ticker symbol and provider name, a consensus object containing the rating label (e.g. 'Buy') and total number of analyst ratings, a priceTarget object with the consensus price target, a reference price, and the percentage difference between them, and a revisionMomentum90d object showing the count of upgrades, downgrades, and net upgrades over the past 90 days. Also includes metadata like data freshness timestamp and a degraded flag.","failureModes":["Unsupported or invalid ticker returns an error or empty data","Ticker not covered by the FMP vendor returns no ratings","Stale data if market data provider cache is not refreshed","Network or upstream FMP API outage causing degraded mode","Missing required 'ticker' query parameter returns a validation error"],"whenToPreferThis":"Use this endpoint when you need a quick, structured summary of Wall Street analyst sentiment for a specific US equity or ETF, including consensus rating, price target upside/downside, and whether analyst opinion has been improving or deteriorating over the past 90 days. Prefer this over raw financial news endpoints when you need quantified, aggregated analyst opinion rather than qualitative news sentiment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:55:40.859Z","isFirstParty":false}