Market Holidays - NGN Market API

Upcoming NGX public holidays

curl --request GET \
  --url https://api.ngnmarket.com/v1/market/holidays \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "holidays": [
      {
        "id": 3,
        "date": "2026-06-12",
        "name": "Democracy Day",
        "created_at": "2026-01-10T09:00:00.000Z"
      },
      {
        "id": 4,
        "date": "2026-10-01",
        "name": "Independence Day",
        "created_at": "2026-01-10T09:00:00.000Z"
      }
    ],
    "count": 2
  },
  "meta": {
    "plan": "free",
    "calls_used": 1,
    "calls_remaining": 9999,
    "reset_at": "2026-06-01T00:00:00.000Z"
  }
}

GET

market

holidays

Upcoming NGX public holidays

curl --request GET \
  --url https://api.ngnmarket.com/v1/market/holidays \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "holidays": [
      {
        "id": 3,
        "date": "2026-06-12",
        "name": "Democracy Day",
        "created_at": "2026-01-10T09:00:00.000Z"
      },
      {
        "id": 4,
        "date": "2026-10-01",
        "name": "Independence Day",
        "created_at": "2026-01-10T09:00:00.000Z"
      }
    ],
    "count": 2
  },
  "meta": {
    "plan": "free",
    "calls_used": 1,
    "calls_remaining": 9999,
    "reset_at": "2026-06-01T00:00:00.000Z"
  }
}

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.

# Upcoming holidays (default)
curl "https://api.ngnmarket.com/v1/market/holidays" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

# All holidays including past
curl "https://api.ngnmarket.com/v1/market/holidays?upcoming=false" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

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