Retrieve annual and quarterly cash flow statements for public companies via Alpha Vantage.
What it does
This MPP endpoint provides cash flow statement data for publicly traded companies through the Alpha Vantage financial data service, proxied via the Locus MPP (Micropayment Protocol) gateway. By sending a POST request with a stock ticker symbol, you receive annual and quarterly cash flow reports including operating cash flow, capital expenditures, financing activities, and other standard line items.
The endpoint is part of a broader Alpha Vantage suite hosted on the Locus MPP platform that includes 26+ financial data endpoints covering stock time series (intraday through monthly), fundamental data (income statements, balance sheets, earnings), forex and crypto exchange rates, commodity prices, economic indicators (GDP, CPI, unemployment), technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands), and news sentiment. 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 settled on Tempo. The endpoint accepts POST requests with a JSON body containing a required "symbol" field. The OpenAPI spec is available at the gateway and references Alpha Vantage's own documentation at https://www.alphavantage.co/documentation/ for detailed response schemas. Note that the probe returned 404 on HEAD/GET — this endpoint only responds to POST requests, which is consistent with the OpenAPI specification.
Capabilities
Use cases
- —Retrieving annual and quarterly cash flow statements for equity research
- —Building automated financial models that need operating and free cash flow data
- —Comparing cash flow metrics across multiple companies for screening
- —Feeding fundamental data into AI agents for investment analysis
- —Monitoring cash flow trends for portfolio management
Fit
Best for
- —AI agents needing pay-per-call access to company cash flow data without API key management
- —Automated financial analysis pipelines requiring structured cash flow statements
- —Developers who want micropayment-gated access to Alpha Vantage fundamentals
Not for
- —High-frequency or bulk data retrieval where per-call pricing adds up quickly
- —Users who need real-time streaming cash flow updates (this is a request-response endpoint)
- —Free-tier users — every call requires a micropayment
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/cash-flow \
-H "Content-Type: application/json" \
-d '{"symbol": "AAPL"}'Example
Request
{
"symbol": "AAPL"
}Endpoint
Quality
Full OpenAPI schema is available with clear request body definitions and payment info for all 26+ endpoints. However, the specific cash-flow endpoint returned 404 on HEAD/GET (expected since it's POST-only), no example response schema is documented, and the crawl pages all returned generic 404 JSON. Price is inferrable but the currency token address makes decimal confirmation uncertain.
Warnings
- —Probe returned 404 on HEAD and GET — endpoint is POST-only per the OpenAPI spec, not necessarily down, but liveness via POST was not confirmed
- —No response schema documented — the 200 response only says "Successful response" with no body definition
- —Currency is identified by contract address 0x20c000000000000000000000b9537d11c60e8b50 (likely pathUSD with 6 decimals), but decimals are not explicitly stated in the spec; the $0.008 price estimate assumes 6 decimals
- —All crawl pages returned 404 with no useful documentation content
Citations
- —The cash-flow endpoint accepts POST with a required 'symbol' field 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/,
- —Full API reference is available at Alpha Vantage documentationhttps://www.alphavantage.co/documentation/,
- —LLM-specific docs are referenced at the Locus MPP skill filehttps://beta.paywithlocus.com/mpp/alphavantage.md