Weekly adjusted stock time series via Alpha Vantage, pay-per-call over MPP/Tempo.
What it does
This endpoint returns weekly open, high, low, close, and volume data for a given stock ticker symbol, sourced from Alpha Vantage and served through the Locus MPP (Micropayment Protocol) gateway. Each call is charged $0.008 (8,000 base units of pathUSD with 6 decimals) settled on Tempo L2. The only required parameter is `symbol` (a stock ticker like "IBM" or "AAPL"); you can optionally request CSV output via the `datatype` parameter.
This endpoint is one of over 25 Alpha Vantage endpoints available through the same Locus MPP service, covering intraday/daily/monthly time series, fundamentals (income statement, balance sheet, cash flow, earnings), forex, crypto, commodities, economic indicators, technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands), news sentiment, and more. All share the same per-call price of $0.008 and use POST with a JSON body.
The endpoint is a POST-only route. The probe returned 404 on HEAD and GET, which is expected since the OpenAPI spec defines only POST. No example response schema is documented in the OpenAPI spec, but Alpha Vantage's own documentation at https://www.alphavantage.co/documentation/ describes the response format in detail. Weekly time series data typically includes a metadata header and a dictionary of weekly OHLCV entries keyed by date.
Capabilities
Use cases
- —Retrieving weekly historical stock prices for backtesting trading strategies
- —Building long-term equity price charts in dashboards or reports
- —Feeding weekly price data into portfolio analytics or risk models
- —Comparing weekly performance across multiple tickers programmatically
Fit
Best for
- —AI agents needing pay-per-call stock data without API key management
- —Automated workflows that need weekly-granularity equity prices
- —Developers who want crypto-settled micropayments for financial data
Not for
- —High-frequency or real-time tick-level trading data needs
- —Bulk historical downloads where a flat-rate subscription would be cheaper
- —Users who cannot settle payments via Tempo L2 / pathUSD
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/time-series-weekly \
-H "Content-Type: application/json" \
-d '{"symbol": "IBM"}'Example
Request
{
"symbol": "IBM",
"datatype": "json"
}Endpoint
Quality
Full OpenAPI schema with clear request parameters and pricing is available. However, the probe did not capture a 402 challenge (POST was not attempted; HEAD/GET returned 404 as expected for a POST-only route), no response schema is documented, and crawled pages returned only generic 404 JSON. The endpoint is likely live but liveness is not directly confirmed.
Warnings
- —Probe only tried HEAD and GET; the endpoint is POST-only per the OpenAPI spec, so the 404 responses do not indicate the endpoint is down, but liveness via 402 challenge was not confirmed.
- —No response schema is provided in the OpenAPI spec; response format must be inferred from Alpha Vantage's own documentation.
- —Currency token address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD (6 decimals) based on the Tempo settlement method; if decimals differ, the $0.008 price would be incorrect.
Citations
- —The endpoint is POST-only with required parameter 'symbol' and optional 'datatype', priced at 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://www.alphavantage.co/documentation/docs
- —LLM-oriented docs are available at https://beta.paywithlocus.com/mpp/alphavantage.mdhttps://beta.paywithlocus.com/mpp/alphavantage.md