---
title: "Moving Average Convergence/Divergence (MACD)"
method: GET
path: "/v1/indicators/macd/{optionsTicker}"
tags: ["options:aggregates"]
---

# Moving Average Convergence/Divergence (MACD)

`GET /v1/indicators/macd/{optionsTicker}`

Get moving average convergence/divergence (MACD) for a ticker symbol over a given time range.

## Path parameters

- `optionsTicker` string, required

## Query parameters

- `timestamp` string
- `timespan` 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year'
- `adjusted` boolean
- `short_window` integer
- `long_window` integer
- `signal_window` integer
- `series_type` 'open' | 'high' | 'low' | 'close'
- `expand_underlying` boolean
- `order` 'asc' | 'desc'
- `limit` integer
- `timestamp.gte` string
- `timestamp.gt` string
- `timestamp.lte` string
- `timestamp.lt` string

## Response `200`

Moving Average Convergence/Divergence (MACD) data for each period.

- object
  - `next_url` string — If present, this value can be used to fetch the next page of data.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object, required — The results of the MACD indicator calculation.
    - `underlying` object — The underlying aggregates used.
      - `aggregates` object[] — The array of aggregates used in the calculation of this indicator.
        - `c` number, float, required — The close price for the symbol in the given time period.
        - `h` number, float, required — The highest price for the symbol in the given time period.
        - `l` number, float, required — The lowest price for the symbol in the given time period.
        - `n` integer, required — The number of transactions in the aggregate window.
        - `o` number, float, required — The open price for the symbol in the given time period.
        - `otc` boolean — Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
        - `t` number, float, required — The Unix Msec timestamp for the start of the aggregate window.
        - `v` number, float, required — The trading volume of the symbol in the given time period.
        - `vw` number, float, required — The volume weighted average price.
      - `url` string — The URL which can be used to request the underlying aggregates used in this request.
    - `values` object[] — Each entry in the values array represents MACD indicator data for a specific timestamp and includes:
      - `histogram` number, float — The difference between the MACD line (value) and the signal line (signal). Positive histogram values indicate upward (bullish) momentum, while negative histogram values indicate downward (bearish) momentum.
      - `signal` number, float — The signal line value, calculated as the exponential moving average (EMA) of the MACD line (value) over the signal period defined in the request parameters. Traders typically use crossovers between the MACD and signal lines as trading signals.
      - `timestamp` integer — The Unix Msec timestamp from the last aggregate used in this calculation.
      - `value` number, float — The MACD line value, calculated as the difference between the short-term and long-term exponential moving averages (EMAs) based on the periods specified in the request parameters.
  - `status` string, required — The status of this request's response.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)