# Alpha Vantage Bollinger Bands (BBANDS)

> Alpha Vantage Bollinger Bands (BBANDS) 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 Bollinger Bands technical indicator data (upper, middle, lower bands) for a given stock, forex, or crypto symbol over a specified interval and time period.

## Facts

- Endpoint: POST https://alphavantage.mpp.paywithlocus.com/alphavantage/bbands?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-bbands-509e1bcf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BYxJisImorwP38fGFcOcn

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-bbands-509e1bcf -d '<json body>'
```

Example prompt: Can you pull the 20-period Bollinger Bands for AAPL on the daily chart using closing prices and 2 standard deviations on both sides?

## When to prefer this

Use this endpoint when you need Bollinger Bands technical indicator data for stocks, forex, or crypto — especially when you need configurable band width (standard deviations), moving average type, and historical series output. Prefer over manual computation when time-series BBANDS across multiple intervals or symbols are needed quickly.

## Known failure modes

- Invalid or unsupported symbol returns empty or error response
- Unsupported interval string causes validation error
- time_period value too small or too large for available data
- Invalid series_type value causes parameter error
- Network timeout or upstream Alpha Vantage rate limit exceeded

## How this service works

Bollinger Bands — volatility bands placed above and below a moving average.

## Output

Returns a time series of Bollinger Band values (upper band, middle band, lower band) for each historical date/interval for the requested symbol, based on the chosen moving average type, time period, and standard deviation settings.

## Example request

```json
{
 "matype": 0,
 "symbol": "MSFT",
 "nbdevdn": 2,
 "nbdevup": 2,
 "datatype": "json",
 "interval": "daily",
 "series_type": "close",
 "time_period": 20
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "symbol",
  "interval",
  "time_period",
  "series_type"
 ],
 "properties": {
  "month": {
   "type": "string",
   "description": "Specific month (YYYY-MM) for intraday intervals"
  },
  "matype": {
   "type": "number",
   "description": "Moving average type: 0=SMA, 1=EMA, 2=WMA, 3=DEMA, 4=TEMA, 5=TRIMA, 6=T3, 7=KAMA, 8=MAMA (default 0)"
  },
  "symbol": {
   "type": "string",
   "description": "Stock ticker symbol"
  },
  "nbdevdn": {
   "type": "number",
   "description": "Standard deviations for lower band (default 2)"
  },
  "nbdevup": {
   "type": "number",
   "description": "Standard deviations for upper band (default 2)"
  },
  "datatype": {
   "type": "string",
   "description": "\"json\" (default) or \"csv\""
  },
  "interval": {
   "type": "string",
   "description": "Time interval: 1min, 5min, 15min, 30min, 60min, daily, weekly, monthly"
  },
  "series_type": {
   "type": "string",
   "description": "Price type: close, open, high, low"
  },
  "time_period": {
   "type": "number",
   "description": "Number of data points (e.g., 20)"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alpha-vantage-bbands-509e1bcf/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)