# GET /api/mcp/data/dividend/{ticker}

> What does AAPL pay, when is the next ex-date, and does the options market agree?

Returns the current dividend amount, frequency, yield and growth, the implied dividend from options versus the declared one, the next ex-date and the payment history.

- **Family:** Stock analytics (https://apexvol.com/developers/stock-analytics-api)
- **Plan:** Premium and above. Every call needs `Authorization: Bearer avmcp_<token>`; tokens are issued to paid and trial accounts under Account, then API Access.
- **Units:** Amounts in dollars per share; yields and growth in percent.
- **Basis:** Implied dividend from put-call parity on the chain; history from the data feed.
- **MCP tools:** `get_ticker_analytics`
- **Background:** https://apexvol.com/learn/what-is-a-dividend

## Parameters

| Name | In | Default | Range | Meaning |
|---|---|---|---|---|
| `ticker` (required) | path |  | any covered symbol | The underlying, upper case. Use /search to check coverage. |

## Request

```bash
curl -H "Authorization: Bearer avmcp_YOUR_TOKEN" \
     "https://apexvol.com/api/mcp/data/dividend/AAPL"
```

## Response (captured 2026-09-08)

Real response, lists cut to the rows nearest the money. The envelope is `{"success": true, "data": ...}`.

```json
{
  "success": true,
  "data": {
    "cagr": 0.0763,
    "current": {
      "annual_actual": 1.08,
      "annual_implied": 0,
      "div_amount": 0.27,
      "div_freq": "Quarterly",
      "div_growth": 0.0,
      "div_yield": 0.3,
      "implied_vs_actual": -1.08,
      "next_div_date": "2026-11-10",
      "next_div_implied": 0,
      "price": 320.07
    },
    "history": [
      {
        "amount": 0.27,
        "decl_date": null,
        "ex_date": "2026-11-10",
        "frequency": 91,
        "pay_date": null,
        "type": null
      },
      {
        "amount": 0.27,
        "decl_date": null,
        "ex_date": "2026-08-10",
        "frequency": 91,
        "pay_date": null,
        "type": null
      },
      {
        "amount": 0.27,
        "decl_date": null,
        "ex_date": "2026-05-12",
        "frequency": 91,
        "pay_date": null,
        "type": null
      }
    ],
    "pays_dividends": true,
    "sector": "Technology",
    "ticker": "AAPL"
  }
}
```

## Fields

- `current.div_amount, div_freq, div_yield, next_div_date`: The dividend now.
- `current.annual_implied, annual_actual, implied_vs_actual`: What options imply versus what is paid.
- `history[].ex_date, pay_date, amount`: Past payments.
- `cagr, pays_dividends`: Growth and flag.

## Errors

- `401`: no or revoked token
- `429`: Retry-After seconds
- `403`: Premium plan required
- `424`: data feed unavailable, retry
- Full list: https://apexvol.com/developers/errors

## Ask it in an MCP client

- When is AAPL's next ex-dividend date and how much?
- Does the options market imply a dividend cut for XOM?
- Show MSFT's dividend history and growth.

Conventions for units, bases and timestamps: https://apexvol.com/developers/conventions