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-calendarPlan: 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.
Errors
Standard errors apply: see Rate limits and errors.