Pay-per-call earnings data for public companies via Alpha Vantage, settled on Tempo L2.
What it does
This MPP endpoint provides quarterly and annual earnings data for publicly traded companies, sourced from Alpha Vantage. It is part of a broader Alpha Vantage proxy service hosted by Locus that exposes over 25 financial data endpoints — covering stock time series, forex, crypto, commodities, economic indicators, technical analysis, and news sentiment — all accessible via per-call micropayments.
The /alphavantage/earnings endpoint accepts a POST request with a JSON body containing a required "symbol" field (a stock ticker such as "IBM" or "AAPL") and returns earnings data including reported EPS, estimated EPS, and surprise metrics for recent quarters and fiscal years. Each call costs 8,000 base units of pathUSD on Tempo L2, which equals $0.008 (less than one cent) per request. Payment is handled via the MPP (Micropayment Protocol) challenge-response flow with intent "charge" and method "tempo".
The OpenAPI spec is well-documented with 26 total paths. However, the probe did not receive a 402 challenge on HEAD or GET for this specific endpoint — the endpoint returned 404, which is expected since the OpenAPI spec defines it as a POST-only route. The upstream Alpha Vantage API documentation at https://www.alphavantage.co/documentation/ provides full details on the earnings data format and fields. Additional LLM-oriented docs are referenced at https://beta.paywithlocus.com/mpp/alphavantage.md.
Capabilities
Use cases
- —Retrieve quarterly EPS and earnings surprise data for a given stock ticker
- —Build automated earnings tracking dashboards for portfolio monitoring
- —Feed earnings data into trading algorithms or financial models
- —Compare reported vs estimated EPS across multiple companies
- —Augment LLM-based financial research agents with real-time earnings data
Fit
Best for
- —AI agents needing pay-per-call access to earnings data without API key management
- —Developers building financial analysis tools with micropayment-based data access
- —Automated trading systems that need programmatic earnings data on demand
Not for
- —Bulk historical data downloads requiring thousands of calls (costs add up)
- —Real-time streaming earnings alerts (this is a request-response API)
- —Users who already have an Alpha Vantage API key and prefer direct access
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/earnings \
-H "Content-Type: application/json" \
-d '{"symbol": "IBM"}'Example
Request
{
"symbol": "IBM"
}Endpoint
Quality
The OpenAPI spec is comprehensive with full request schemas and payment info for 26 endpoints. However, the specific /earnings endpoint returned 404 on HEAD/GET (expected for POST-only), no example response is available, and the crawl pages all returned generic 404 JSON. Response schema is not documented.
Warnings
- —Probe returned 404 on HEAD and GET; endpoint is POST-only per OpenAPI spec — likely still live but not confirmed with a 402 challenge on POST
- —No response schema documented — the structure of earnings data returned is not specified in the OpenAPI spec
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals based on Tempo L2 convention; if decimals differ, the price calculation would change
- —All crawled pages returned 404; no additional documentation was retrievable from the provider origin
Citations
- —The /alphavantage/earnings endpoint is defined as a POST route with required 'symbol' parameter and costs 8000 base units via Tempohttps://alphavantage.mpp.paywithlocus.com
- —Alpha Vantage provides financial market data including stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentimenthttps://www.alphavantage.co/documentation/​
- —LLM-oriented documentation is available at the referenced skill filehttps://beta.paywithlocus.com/mpp/alphavantage.md