Retrieve annual and quarterly income statements for any public company via Alpha Vantage.
What it does
This MPP endpoint returns income statement data (annual and quarterly reports) for publicly traded companies, sourced from Alpha Vantage's fundamental data API. You POST a JSON body with a stock ticker symbol and receive structured financial data including revenue, gross profit, operating income, net income, EBITDA, and other line items.
The endpoint is part of a broader Alpha Vantage suite hosted on the Locus MPP gateway, which also exposes time-series price data, forex, crypto, commodities, economic indicators, technical analysis (SMA, EMA, MACD, RSI, Bollinger Bands), news sentiment, earnings call transcripts, and more — 26 endpoints in total. Each call costs 8,000 base units of pathUSD on Tempo L2, which equals $0.008 (less than one cent) per request.
The endpoint accepts POST requests with a JSON body containing a required "symbol" field (e.g., "IBM", "AAPL"). Payment is settled via the Tempo method (pathUSD on Tempo L2). The OpenAPI spec is available at the gateway and full Alpha Vantage documentation is at https://www.alphavantage.co/documentation/. Note: the probe returned 404 on HEAD/GET, which is expected since this endpoint only accepts POST requests as defined in the OpenAPI schema.
Capabilities
Use cases
- —Retrieving annual and quarterly income statements for equity research
- —Building automated financial models that ingest revenue, EBITDA, and net income data
- —Comparing income statements across multiple companies for screening
- —Feeding fundamental data into AI agents for investment analysis
- —Populating dashboards with up-to-date P&L figures
Fit
Best for
- —AI agents needing pay-per-call access to company income statements without API key management
- —Automated financial analysis pipelines requiring structured fundamental data
- —Developers building stock screening tools who want micropayment-based access
Not for
- —Real-time streaming financial data (this is a request-response endpoint)
- —Bulk downloading income statements for thousands of companies at once (per-call pricing adds up)
- —Non-US or private company financials not covered by Alpha Vantage
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/income-statement \
-H "Content-Type: application/json" \
-d '{"symbol": "IBM"}'Example
Request
{
"symbol": "IBM"
}Endpoint
Quality
Full OpenAPI schema with clear request body and payment info is available. However, the probe returned 404 (expected since it only accepts POST, not HEAD/GET), no example response is available, and crawled pages returned no useful documentation. Price and schema are well-defined but response format is undocumented in the probe bundle.
Warnings
- —Probe returned 404 on HEAD and GET — endpoint is POST-only; liveness via POST was not confirmed by the probe
- —No example response body available; response schema is not documented in the OpenAPI spec
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 assumed to be pathUSD with 6 decimals based on Tempo method context; exact token not independently verified
- —Full Alpha Vantage documentation is external at https://www.alphavantage.co/documentation/ and was not crawled
Citations
- —The endpoint accepts POST with a required 'symbol' field and costs 8000 base units via Tempo methodhttps://alphavantage.mpp.paywithlocus.com
- —Alpha Vantage provides financial market data including stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentimenthttps://alphavantage.mpp.paywithlocus.com
- —Full API reference is available at alphavantage.co/documentation/https://www.alphavantage.co/documentation/LLM-specific
- —LLM-specific docs referenced at https://beta.paywithlocus.com/mpp/alphavantage.mdhttps://beta.paywithlocus.com/mpp/alphavantage.md