Skip to main content
GET
Upcoming NGX public holidays
Returns the public holidays that the NGX is closed for, as maintained by the NGN Market team. These are the same holidays reflected in the GET /market/status reason: holiday response. By default only upcoming holidays (today or later) are returned. Pass upcoming=false to retrieve past holidays as well.
Each holiday object contains the date in YYYY-MM-DD format and the name of the holiday. Use this list to pre-compute non-trading days in your application rather than polling the status endpoint on each day.

Authorizations

Authorization
string
header
required

Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY. Generate keys at ngnmarket.com/dashboard/developer.

Query Parameters

upcoming
boolean
default:true

Set to false to include past holidays. Defaults to true.

limit
integer
default:50

Maximum number of results to return (1–100). Defaults to 50.

Required range: 1 <= x <= 100

Response

Holiday list retrieved successfully.

success
boolean
required
meta
object

Quota and plan metadata included on every authenticated response.

data
object