Pay-per-call news sentiment analysis via Alpha Vantage, settled on Tempo L2.
What it does
This endpoint provides access to Alpha Vantage's News Sentiment API through the Locus MPP (Micropayment Protocol). It returns sentiment-scored news articles and headlines for specified stock tickers and/or topic categories. You can filter by ticker symbols, topics (e.g., blockchain, earnings, IPO, mergers_and_acquisitions, technology, etc.), time ranges, and sort order. Results include up to 1000 articles per request.
The news-sentiment endpoint is one of 26 Alpha Vantage endpoints available through this Locus MPP gateway. Each call costs 8,000 base units of pathUSD on Tempo L2 (approximately $0.008 per request, assuming pathUSD uses 6 decimals). Payment is handled via the MPP charge intent — each POST request requires a one-shot micropayment. The endpoint accepts POST requests with a JSON body; no fields are strictly required, but you can specify tickers, topics, time_from, time_to, sort, and limit parameters.
Note: The probe returned 404 on HEAD and GET methods, which is expected since the OpenAPI spec defines this as a POST-only endpoint. The OpenAPI schema is comprehensive and well-documented, listing all parameters with descriptions. The upstream Alpha Vantage API documentation is available at https://www.alphavantage.co/documentation/ and Locus-specific docs at https://beta.paywithlocus.com/mpp/alphavantage.md.
Capabilities
Use cases
- —Retrieve sentiment-scored news articles for a portfolio of stock tickers
- —Monitor news sentiment trends for specific market topics like earnings or IPOs
- —Build automated trading signals based on aggregated news sentiment
- —Feed financial news context into LLM-based investment research agents
- —Track sentiment shifts around specific companies over defined time windows
Fit
Best for
- —AI agents needing pay-per-call financial news sentiment without API key management
- —Automated trading systems that consume structured sentiment data
- —Research workflows requiring topic-filtered financial news with time-range precision
Not for
- —Real-time streaming news feeds (this is request-response, not streaming)
- —Non-financial news sentiment analysis
- —Users who need free or subscription-based access rather than per-call micropayments
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/news-sentiment \
-H "Content-Type: application/json" \
-d '{"tickers": "AAPL", "topics": "technology", "limit": 10, "sort": "LATEST"}'Example
Request
{
"sort": "RELEVANCE",
"limit": 50,
"topics": "technology,earnings",
"tickers": "AAPL,MSFT",
"time_to": "20240601T2359",
"time_from": "20240101T0000"
}Endpoint
Quality
The OpenAPI spec is comprehensive with full request schemas and payment info for all 26 endpoints. However, the probe did not capture a live 402 challenge (only 404 on HEAD/GET, which is expected for a POST-only endpoint), no response schema is documented, and no example response data is available. The crawl pages all returned generic 404 JSON. The currency address is opaque and decimals are not confirmed in the spec.
Warnings
- —Probe returned 404 on HEAD/GET — endpoint is POST-only; a POST probe was not attempted so liveness is not fully confirmed
- —Currency identified by address 0x20c000000000000000000000b9537d11c60e8b50 — assumed to be pathUSD with 6 decimals but not explicitly confirmed in the spec
- —No response schema documented in the OpenAPI spec — response structure must be inferred from Alpha Vantage upstream docs
- —Price of ~$0.008 per call is inferred assuming 6-decimal pathUSD; actual cost may differ if token decimals differ
Citations
- —The endpoint is defined as POST with the listed request parameters in the OpenAPI spechttps://alphavantage.mpp.paywithlocus.com
- —Alpha Vantage upstream API documentation is availablehttps://www.alphavantage.co/documentation/"
- —Locus-specific Alpha Vantage docs referenced in OpenAPIhttps://beta.paywithlocus.com/mpp/alphavantage.md
- —Payment amount is 8000 base units with intent=charge and method=tempohttps://alphavantage.mpp.paywithlocus.com