# Alpha Vantage MACD

> Alpha Vantage MACD 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 Moving Average Convergence/Divergence (MACD) technical indicator values for a given stock, forex pair, or crypto symbol over a specified time interval.

## Facts

- Endpoint: POST https://alphavantage.mpp.paywithlocus.com/alphavantage/macd?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-macd-3774b051
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MH277sF2BvYbsv6FySioc

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-macd-3774b051 -d '<json body>'
```

Example prompt: Can you pull the daily MACD values for AAPL using the default settings — fast period 12, slow period 26, signal period 9 — based on closing prices?

## When to prefer this

Use this endpoint when you need MACD technical indicator data for stocks, forex pairs, or crypto assets, particularly when building trading signals, momentum analysis, or chart overlays. Prefer this over SMA or EMA endpoints when you specifically need convergence/divergence momentum signals. Best suited when you need both MACD and signal line values together along with the histogram.

## Known failure modes

- Invalid or unsupported symbol returns an error or empty data
- Unsupported interval value causes a 400-level error
- Missing required fields (symbol, interval, series_type) returns a validation error
- Rate limit exceeded returns an error message
- Invalid month format for intraday requests causes a parsing error

## How this service works

Moving Average Convergence/Divergence — trend-following momentum indicator.

## Output

Returns a time-series of MACD indicator data points, each containing the MACD line value, the signal line value, and the MACD histogram value for the specified symbol and interval. The response is structured as a JSON object (or CSV if requested) with timestamps as keys.

## Example request

```json
{
 "symbol": "AAPL",
 "datatype": "json",
 "interval": "daily",
 "fastperiod": 12,
 "slowperiod": 26,
 "series_type": "close",
 "signalperiod": 9
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "symbol",
  "interval",
  "series_type"
 ],
 "properties": {
  "month": {
   "type": "string",
   "description": "Specific month (YYYY-MM) for intraday intervals"
  },
  "symbol": {
   "type": "string",
   "description": "Stock ticker symbol"
  },
  "datatype": {
   "type": "string",
   "description": "\"json\" (default) or \"csv\""
  },
  "interval": {
   "type": "string",
   "description": "Time interval: 1min, 5min, 15min, 30min, 60min, daily, weekly, monthly"
  },
  "fastperiod": {
   "type": "number",
   "description": "Fast period (default 12)"
  },
  "slowperiod": {
   "type": "number",
   "description": "Slow period (default 26)"
  },
  "series_type": {
   "type": "string",
   "description": "Price type: close, open, high, low"
  },
  "signalperiod": {
   "type": "number",
   "description": "Signal period (default 9)"
  }
 },
 "additionalProperties": true
}
```

## More

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