{"uid":"cap_lTZTg2Q4Vg_8gBeiZt8z2","slug":"otto-ai-equity-news-ticker-news-sentiment-29fdc5ec","name":"Otto AI Equity News — Ticker News & Sentiment","description":"Latest company news for a vendor-resolved equity: licensed Finnhub headlines from the trailing seven days with publication time, source, and summary. Only articles that name the company are served — labelled `primary` when the headline names it, `mentioned` when only the summary does — so a symbol-tagged story about another company never fills the list. Redirect URLs withheld; no sentiment is fabricated.","url":"https://x402.ottoai.services/equity-news","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":{"ticker":"AAPL","articles":[{"source":"Publisher","headline":"Example company headline","relevance":"primary"}],"provider":"Finnhub","relevance":{"floor":"ticker-primacy","filteredOutCount":27,"candidatesConsidered":63},"sentiment":{"shift":null,"status":"unavailable"},"windowDays":7,"headlineCount":2},"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_z4K6PN9AGrSJjIHjAhOoS","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":"Fetches recent news headlines and sentiment data for a given equity or ETF ticker symbol, sourced from Finnhub, covering the past 7 days.","exampleAgentPrompt":"Can you pull the latest news headlines and sentiment for NVDA from the past week? I want to see what's been reported about Nvidia recently.","exampleUseCases":[{"title":"Pre-earnings news briefing for a stock","prompt":"Before AAPL reports earnings, pull me the latest news headlines for Apple stock so I can see what the market is talking about heading into the report."},{"title":"Monitoring ETF news for portfolio decisions","prompt":"What's been in the news about SPY this week? I want to catch up on any major headlines before I decide whether to add to my position."},{"title":"Researching a stock before a trade","prompt":"I'm thinking about buying TSLA — can you grab the most recent news articles and tell me if the sentiment is positive or negative?"}],"resultDescription":"Returns a JSON object with the ticker symbol, an array of recent news articles (each with source and headline), the data provider (Finnhub), sentiment status (or 'unavailable' if not computable), the number of headlines found, and a 7-day lookback window. Also includes metadata fields: generatedAt timestamp, validUntil, staleness in seconds, and a degraded flag indicating data quality.","failureModes":["Unsupported or invalid ticker symbol returns no articles or an error","Sentiment field may return status 'unavailable' if insufficient data exists","Stale data if the upstream Finnhub feed is delayed (check meta.stalenessSec)","Payment failure if USDC balance is insufficient or x402 protocol handshake fails","Empty article list for tickers with low news coverage"],"whenToPreferThis":"Use this endpoint when you need recent news headlines and basic sentiment for a specific publicly traded equity or ETF by ticker symbol. It is purpose-built for per-ticker financial news retrieval with a 7-day window, powered by Finnhub. Prefer this over general crypto or web news endpoints when the subject is a traditional equity (e.g. AAPL, NVDA, SPY). Not suitable for crypto tokens, private companies, or news searches without a known ticker.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:35.408Z","isFirstParty":false}