KoboTerminalNGX API DocsGet a free API key

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

NameInTypeRequiredDescription
upcomingquerybooleannoOnly ex-dates from today forward, soonest first (e.g. true)
fromquerystringnoEarliest ex-date, YYYY-MM-DD (default 90 days ago)
toquerystringnoLatest ex-date, YYYY-MM-DD
symbolquerystringnoFilter by ticker
limitqueryintegernoDefault 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.