# Alpha Vantage Time Series Weekly

> Alpha Vantage Time Series Weekly is a paid API for AI agents from Alpha Vantage at alphavantage.mpp.paywithlocus.com, paid per call via MPP, $0.008/call, status unknown (last checked 2026-10-11).

Returns weekly open, high, low, close, and volume data for a given stock ticker symbol

## Facts

- Endpoint: POST https://alphavantage.mpp.paywithlocus.com/alphavantage/time-series-weekly?utm_source=zero.xyz
- Price: $0.008/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Alpha Vantage
- Docs: https://www.alphavantage.co/documentation/
- Website: https://www.alphavantage.co
- Tags: finance, stocks, forex, crypto, market-data, technical-analysis, data
- Canonical page: https://www.zero.xyz/c/alpha-vantage-time-series-weekly-7eb99bbf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sSbicIpK9FMg58a6xL7rJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability alpha-vantage-time-series-weekly-7eb99bbf -d '<json body>'
```

Example prompt: Can you pull the weekly price history for AAPL — I need the open, high, low, close, and volume for each week going back as far as available?

## When to prefer this

Use this endpoint when you need aggregated weekly candlestick (OHLCV) data for a stock — ideal for long-term trend analysis, backtesting weekly strategies, or charting weekly price movements. Prefer this over the daily or intraday endpoints when the granularity of weekly bars is sufficient and you want to reduce data volume. Choose over the daily endpoint when weekly aggregation is needed directly rather than computing it manually.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty data
- Missing required 'symbol' parameter returns a validation error
- Rate limit exceeded returns an error response
- Network timeout for large response payloads
- Incorrect datatype value results in unexpected format or error

## How this service works

Weekly OHLCV data for a given equity. Last trading day of each week, 20+ years.

## Output

A time series of weekly OHLCV (open, high, low, close, volume) data for the requested stock ticker, keyed by week-ending date, returned as JSON or CSV depending on the datatype parameter.

## Example request

```json
{
 "symbol": "GOOGL",
 "datatype": "json"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "symbol"
 ],
 "properties": {
  "symbol": {
   "type": "string",
   "description": "Stock ticker symbol"
  },
  "datatype": {
   "type": "string",
   "description": "\"json\" (default) or \"csv\""
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alpha-vantage-time-series-weekly-7eb99bbf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from alphavantage.mpp.paywithlocus.com](https://www.zero.xyz/host/alphavantage.mpp.paywithlocus.com/llms.txt)
