# Dividend calendar

> Dividends across the whole market by ex-dividend date. Use `upcoming=true` for what is coming next.

```http
GET https://koboterminal.com/api/ngxdata/dividends-calendar
```

**Plan:** Free and above (free key, no card).

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `upcoming` | query | boolean | no | Only ex-dates from today forward, soonest first (e.g. `true`) |
| `from` | query | string | no | Earliest ex-date, YYYY-MM-DD (default 90 days ago) |
| `to` | query | string | no | Latest ex-date, YYYY-MM-DD |
| `symbol` | query | string | no | Filter by ticker |
| `limit` | query | integer | no | Default 200, max 500 |

## Request

```bash
curl "https://koboterminal.com/api/ngxdata/dividends-calendar?upcoming=true" \
  -H "X-API-Key: $KOBO_API_KEY"
```

```python
import os, requests

r = requests.get(
    "https://koboterminal.com/api/ngxdata/dividends-calendar",
    params={"upcoming": "true"},
    headers={"X-API-Key": os.environ["KOBO_API_KEY"]},
    timeout=30,
)
r.raise_for_status()
data = r.json()
```

```javascript
const res = await fetch("https://koboterminal.com/api/ngxdata/dividends-calendar?upcoming=true", {
  headers: { "X-API-Key": process.env.KOBO_API_KEY },
});
if (!res.ok) throw new Error(`Kobo API ${res.status}`);
const data = await res.json();
```

## Response

Illustrative example (values are examples, field names are exact):

```json
{
  "success": true,
  "from": "2026-11-18",
  "to": null,
  "upcoming": true,
  "count": 1,
  "dividends": [
    {
      "symbol": "ZENITHBANK",
      "company_name": "Zenith Bank Plc",
      "ex_dividend_date": "2026-11-27",
      "record_date": "2026-11-28",
      "pay_date": "2026-12-08",
      "dividend_per_share": 1.25,
      "currency": "NGN"
    }
  ]
}
```

## Use it from an AI assistant

This endpoint is available as the `get_dividend_calendar` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp).

## Errors

Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors).
