Monthly OHLCV stock time series via Alpha Vantage, pay-per-call over MPP/Tempo.
What it does
This endpoint returns monthly open, high, low, close, and volume (OHLCV) data for a given stock ticker symbol, sourced from Alpha Vantage and served through the Locus MPP (Micropayment Protocol) gateway. It is one of 26 Alpha Vantage endpoints available on this gateway, covering equities, forex, crypto, commodities, economic indicators, technical analysis, and news sentiment.
The endpoint accepts a POST request with a JSON body containing a required `symbol` field (e.g., "IBM", "AAPL") and an optional `datatype` field ("json" or "csv"). 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 charge intent — the gateway issues a 402 challenge on unauthenticated requests, and a compliant agent settles the micropayment before receiving data.
Note: the probe returned 404 on HEAD and GET methods, but the OpenAPI spec declares this as a POST endpoint. The 404 is expected for non-POST methods and does not indicate the endpoint is down. The full OpenAPI schema is well-documented with clear request bodies and payment metadata for all sibling endpoints.
Capabilities
Use cases
- —Retrieving long-term monthly price history for portfolio backtesting
- —Building monthly candlestick charts for equity analysis
- —Feeding monthly stock data into financial models or LLM agents
- —Comparing multi-year performance of different tickers
Fit
Best for
- —Agents needing pay-per-call monthly stock data without API key management
- —Long-horizon equity analysis requiring full monthly OHLCV history
- —Automated financial research pipelines settling via crypto micropayments
Not for
- —Real-time or intraday trading signals (use the intraday endpoint instead)
- —High-frequency bulk data downloads where per-call pricing is inefficient
- —Users who cannot settle payments on Tempo L2
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/time-series-monthly \
-H "Content-Type: application/json" \
-d '{"symbol": "IBM"}'Example
Request
{
"symbol": "IBM",
"datatype": "json"
}Endpoint
Quality
Full OpenAPI schema with clear request body and payment metadata is available. However, the probe did not capture a live 402 challenge (only HEAD/GET were tried on a POST-only endpoint), no example response is available, and crawled pages returned only 404 JSON errors. Price and schema are well-documented but response format must be inferred from Alpha Vantage's own documentation.
Warnings
- —Probe returned 404 because HEAD/GET were used on a POST-only endpoint; liveness not confirmed via POST probe
- —No example response body available — response schema is undocumented in the OpenAPI spec
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 assumed to be pathUSD (6 decimals) based on Tempo L2 convention; not independently verified
Citations
- —The endpoint is declared as POST with payment amount 8000 in pathUSD on Tempo L2https://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/docs
- —LLM-oriented documentation is available at the Locus skill filehttps://beta.paywithlocus.com/mpp/alphavantage.md