Retrieve annual and quarterly balance sheet data for any publicly traded company via Alpha Vantage.
What it does
This MPP endpoint provides balance sheet financial statements for publicly traded companies, sourced from Alpha Vantage's fundamental data API. You send a POST request with a stock ticker symbol and receive structured balance sheet data including assets, liabilities, and shareholder equity figures for both annual and quarterly reporting periods.
The endpoint is part of a broader Alpha Vantage suite hosted on the Locus MPP gateway, which includes 25+ endpoints covering time series (intraday through monthly), fundamental data (income statement, cash flow, earnings), forex, crypto, commodities, economic indicators, technical analysis (SMA, EMA, MACD, RSI, Bollinger Bands), and news sentiment. Each call is priced at 8,000 base units of pathUSD on Tempo L2 (approximately $0.008 per request, assuming pathUSD uses 6 decimals). Payment is per-call (intent: charge).
The endpoint accepts POST requests with a JSON body containing a required "symbol" field (e.g., "IBM", "AAPL"). The OpenAPI spec is well-documented. Note that the probe returned 404 on HEAD and GET methods, which is expected since the endpoint only accepts POST. The upstream Alpha Vantage API documentation is available at https://www.alphavantage.co/documentation/ and LLM-specific docs at https://beta.paywithlocus.com/mpp/alphavantage.md.
Capabilities
Use cases
- —Retrieving annual and quarterly balance sheet data for equity research
- —Building automated financial screening tools that compare company fundamentals
- —Feeding balance sheet metrics into AI agents for investment analysis
- —Monitoring changes in a company's debt-to-equity ratio over time
- —Populating dashboards with up-to-date financial statement data
Fit
Best for
- —AI agents needing pay-per-call access to company balance sheets without API key management
- —Automated fundamental analysis pipelines
- —Quick lookups of assets, liabilities, and equity for any US-listed stock
Not for
- —Real-time or streaming balance sheet updates (data is periodic, not live)
- —Non-equity asset classes (use sibling endpoints for forex, crypto, commodities)
- —Bulk downloading balance sheets for thousands of companies in a single call
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/balance-sheet \
-H "Content-Type: application/json" \
-d '{"symbol": "IBM"}'Example
Request
{
"symbol": "IBM"
}Endpoint
Quality
The OpenAPI spec is complete with request schema and payment info for this endpoint, but no response schema or example response is provided. The probe returned 404 because HEAD/GET were used on a POST-only endpoint, so liveness is not confirmed but likely given the well-structured OpenAPI. The currency address for pathUSD decimals is assumed to be 6 (standard for USD stablecoins) but not explicitly confirmed.
Warnings
- —Endpoint liveness not directly confirmed — probe used HEAD/GET but endpoint only accepts POST
- —No response schema documented; response structure must be inferred from Alpha Vantage upstream docs
- —pathUSD decimal count assumed to be 6 (standard for USD stablecoins); price of ~$0.008 per call is an estimate
- —Root domain returns 404 for all non-endpoint paths; documentation lives at external URLs
Citations
- —The balance-sheet endpoint accepts POST with a required 'symbol' field and costs 8000 base units of pathUSD 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-specific documentation is available at the Locus beta docs URLhttps://beta.paywithlocus.com/mpp/alphavantage.md