{"uid":"cap_1k3-_bOWp0dtT8z-B3YjA","slug":"alpha-vantage-news-sentiment-3fbebe6b","name":"Alpha Vantage News Sentiment","description":"Live and historical market news with AI-powered sentiment scores. Filter by tickers and topics.","url":"https://alphavantage.mpp.paywithlocus.com/alphavantage/news-sentiment?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"type":"string","description":"\"LATEST\", \"EARLIEST\", or \"RELEVANCE\" (default \"LATEST\")"},"limit":{"type":"number","description":"Number of results (default 50, max 1000)"},"topics":{"type":"string","description":"Comma-separated topics: blockchain, earnings, ipo, mergers_and_acquisitions, financial_markets, economy_fiscal, economy_monetary, economy_macro, energy_transportation, finance, life_sciences, manufacturing, real_estate, retail_wholesale, technology"},"tickers":{"type":"string","description":"Comma-separated ticker symbols (e.g., \"AAPL,MSFT\" or \"CRYPTO:BTC,CRYPTO:ETH\")"},"time_to":{"type":"string","description":"End time in YYYYMMDDTHHMM format"},"time_from":{"type":"string","description":"Start time in YYYYMMDDTHHMM format (e.g., \"20220410T0130\")"}},"additionalProperties":true},"responseSchema":null,"example":{"request":{"sort":"LATEST","limit":10,"tickers":"AAPL,MSFT","time_to":"20240131T2359","time_from":"20240101T0000"},"response":{"_truncated":true,"_originalSize":25668}},"exampleRequest":{"sort":"LATEST","limit":10,"tickers":"AAPL,MSFT","time_to":"20240131T2359","time_from":"20240101T0000"},"tags":["finance","stocks","forex","crypto","market-data","technical-analysis","data"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.50","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.008/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wy3zFo0J4SjEhlRq0DPmG","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Alpha Vantage","brandSlug":"alpha-vantage","brandBaseUrl":"https://www.alphavantage.co","brandDocsUrl":"https://www.alphavantage.co/documentation/","whatItDoes":"Retrieves news articles with sentiment scores for specific stock tickers and/or financial topics within a given time range","exampleAgentPrompt":"Pull the 20 most recent news articles for AAPL and MSFT from January 2024, sorted by latest, and give me the sentiment scores — I want to see if the coverage was mostly bullish or bearish going into earnings.","exampleUseCases":null,"resultDescription":"A list of news articles (up to 1000) each annotated with overall sentiment scores and labels (bullish/bearish/neutral), per-ticker relevance and sentiment, topic tags, source metadata, and publication timestamps — filtered by the specified tickers, topics, and time window.","failureModes":["Invalid ticker symbol returns empty or error response","Malformed time format (not YYYYMMDDTHHMM) causes a 400 error","Requesting limit above 1000 may be capped or rejected","Empty result set if no news exists for the given filters in the time range","Rate limiting if too many requests are made in quick succession"],"whenToPreferThis":"Use this endpoint when you need structured, sentiment-annotated financial news specifically tied to stock tickers or financial topics, as opposed to raw news feeds. Ideal for agents building trading signals, monitoring brand sentiment for public companies, or tracking macro themes like IPOs or monetary policy in the news.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":6,"lastUsedAt":"2026-06-16T00:00:13.902Z","lastSuccessfullyRanAt":"2026-06-16T00:00:13.902Z","lastHealthCheckAt":"2026-10-10T00:31:00.991Z","isFirstParty":false,"canonicalSlug":"alpha-vantage-news-sentiment-3fbebe6b"}