Upcoming dividends
curl --request GET \
--url https://api.ngnmarket.com/v1/dividends/upcoming \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ngnmarket.com/v1/dividends/upcoming"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ngnmarket.com/v1/dividends/upcoming', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ngnmarket.com/v1/dividends/upcoming",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ngnmarket.com/v1/dividends/upcoming"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ngnmarket.com/v1/dividends/upcoming")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ngnmarket.com/v1/dividends/upcoming")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"dividends": [
{
"symbol": "DANGCEM",
"company_name": "Dangote Cement Plc",
"sector": "Industrial Goods",
"ex_dividend_date": "2026-06-17",
"dividend": 45,
"type": "Cash",
"payment_date": "2026-07-01",
"yield": 4.14
},
{
"symbol": "GTCO",
"company_name": "Guaranty Trust Holding Company Plc",
"sector": "Financial Services",
"ex_dividend_date": "2026-06-24",
"dividend": 3,
"type": "Cash",
"payment_date": "2026-07-08",
"yield": 5.3
}
],
"page": 1,
"total": 38,
"total_pages": 2
},
"meta": {
"plan": "starter",
"calls_used": 15,
"calls_remaining": 99985,
"reset_at": "2026-06-15T23:57:00.000Z"
}
}Dividend Endpoints
Upcoming Dividends
Browse NGX-listed companies with upcoming ex-dividend dates.
GET
/
dividends
/
upcoming
Upcoming dividends
curl --request GET \
--url https://api.ngnmarket.com/v1/dividends/upcoming \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ngnmarket.com/v1/dividends/upcoming"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ngnmarket.com/v1/dividends/upcoming', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ngnmarket.com/v1/dividends/upcoming",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ngnmarket.com/v1/dividends/upcoming"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ngnmarket.com/v1/dividends/upcoming")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ngnmarket.com/v1/dividends/upcoming")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"dividends": [
{
"symbol": "DANGCEM",
"company_name": "Dangote Cement Plc",
"sector": "Industrial Goods",
"ex_dividend_date": "2026-06-17",
"dividend": 45,
"type": "Cash",
"payment_date": "2026-07-01",
"yield": 4.14
},
{
"symbol": "GTCO",
"company_name": "Guaranty Trust Holding Company Plc",
"sector": "Financial Services",
"ex_dividend_date": "2026-06-24",
"dividend": 3,
"type": "Cash",
"payment_date": "2026-07-08",
"yield": 5.3
}
],
"page": 1,
"total": 38,
"total_pages": 2
},
"meta": {
"plan": "starter",
"calls_used": 15,
"calls_remaining": 99985,
"reset_at": "2026-06-15T23:57:00.000Z"
}
}This endpoint returns a paginated list of NGX-listed companies whose ex-dividend date falls on or after today, ordered chronologically by ex-dividend date. Use it to build a dividend calendar, screen for near-term income opportunities, or alert users before key dates.
Use
If no upcoming dividends are scheduled,
page and limit for pagination (up to 100 records per page).
For example, to fetch the first page of upcoming dividends:
curl "https://api.ngnmarket.com/v1/dividends/upcoming?limit=20&page=1" \
-H "Authorization: Bearer ngm_live_YOUR_KEY"
const url = new URL('https://api.ngnmarket.com/v1/dividends/upcoming');
url.searchParams.set('limit', '20');
url.searchParams.set('page', '1');
const res = await fetch(url, {
headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' },
});
const { data } = await res.json();
// data.dividends — array of upcoming dividend records
// data.total — total matching records
import requests
res = requests.get(
'https://api.ngnmarket.com/v1/dividends/upcoming',
params={'limit': 20, 'page': 1},
headers={'Authorization': 'Bearer ngm_live_YOUR_KEY'},
)
data = res.json()['data']
dividends will be an empty array and total will be 0. This endpoint requires a Starter plan or higher.Authorizations
Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY.
Generate keys at ngnmarket.com/dashboard/developer.
Query Parameters
Page number (1-based).
Required range:
x >= 1Records per page (1–100).
Required range:
1 <= x <= 100