{"uid":"cap_xn720-E5RV1uOvbaRYiWo","slug":"alpha-vantage-news-sentiment-via-locus-x402-71a2fa5b","name":"Alpha Vantage News Sentiment via Locus x402","description":"Financial market data — stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentiment.","url":"https://alphavantage.x402.paywithlocus.com/alphavantage/news-sentiment","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"type":"string"},"limit":{"type":"number"},"topics":{"type":"string"},"tickers":{"type":"string"},"time_to":{"type":"string"},"time_from":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HZsK8TzdLfawrOyPKjp5D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches financial news articles with sentiment scores for specific stock tickers and/or topics, with filtering by time range and sorting options, billed per-call via USDC micropayment.","exampleAgentPrompt":"Pull the 50 most recent news articles for AAPL and MSFT from Alpha Vantage and include sentiment scores — sorted by latest, from the past week.","exampleUseCases":[{"title":"Earnings news sentiment monitoring","prompt":"Get me the latest 100 news articles tagged with 'earnings' from Alpha Vantage, sorted by most recent, and show me the sentiment scores for each one."},{"title":"Crypto market sentiment check","prompt":"Fetch the 50 most recent news articles about Bitcoin and Ethereum from Alpha Vantage with sentiment data — I want to see if the overall tone is bullish or bearish right now."},{"title":"Time-ranged M&A news research","prompt":"Pull all Alpha Vantage news articles covering mergers and acquisitions between January 1st 2024 and March 31st 2024, sorted by relevance, up to 200 results."}],"resultDescription":"Returns a JSON payload containing a list of news articles with their titles, sources, publication times, URLs, summary text, overall sentiment scores (positive/negative/neutral), topic relevance scores, and per-ticker sentiment breakdowns. Also includes payment confirmation details showing settled USDC amount.","failureModes":["Invalid ticker symbol returns empty or error result","Malformed time_from/time_to format (must be YYYYMMDDTHHMM) causes API rejection","Exceeding limit of 1000 results causes validation error","Payment failure or insufficient USDC balance prevents call from completing","No results returned for very narrow time windows or obscure tickers","Rate limiting from underlying Alpha Vantage API may cause intermittent failures"],"whenToPreferThis":"Choose this endpoint when you need structured news sentiment data tied to specific stock tickers or financial topics, with built-in NLP sentiment scoring from Alpha Vantage. Prefer it over generic news APIs when you need finance-specific topic classification (earnings, IPO, M&A, etc.) and per-ticker sentiment breakdowns. The pay-per-call USDC pricing via x402 makes it cost-effective for sporadic lookups without a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:47:23.090Z","isFirstParty":false}