API product catalogPan-African Market Data & Intelligence

Market holiday calendar

Pan-African Market Data & Intelligence

GET

/market/holidays

Sandbox availablegetMarketHolidays

Returns exchange closure dates for a given date range. Use this to: - Show users when a specific exchange is closed before they try to trade. - Build "next trading day" schedulers (skip weekends and holidays). - Display an in-app holiday calendar alongside market status. Defaults: from = today, to = 12 months from today. Maximum range is 2 years. All African exchanges (UTC+0 to UTC+3) use ISO 8601 dates in UTC.

Parameters

exchangestringquery

Filter to a single exchange. One of: NSE, NGX, JSE, GSE, BRVM, ZSE, BSE, LUSE, EGX, DSE, USE, MSE, CSE, SEM. Omit to return holidays for all exchanges.

Example: NSE

fromstringquery

Start date (inclusive), YYYY-MM-DD. Defaults to today.

Example: 2026-06-06

tostringquery

End date (inclusive), YYYY-MM-DD. Defaults to 12 months from from. Maximum 2 years from from.

Example: 2026-12-31

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

dataobject[]

data[].exchangestringRequired

Exchange code.

Example: "NSE"

data[].datestringRequired

Closure date in YYYY-MM-DD format.

Example: "2026-12-25"

data[].reasonstringRequired

Human-readable reason for the closure.

Example: "Christmas Day"

countinteger

Example: 8

fromstring

Example: "2026-06-06"

tostring

Example: "2026-12-31"

metaobject

Standard response metadata included on every market-data envelope.

meta.request_idstring

Unique identifier for this request. Include in support tickets for tracing.

Example: "4f6e1a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b"

meta.timestampstring

ISO 8601 UTC timestamp of when the response was generated.

Example: "2026-06-04T10:23:45.123Z"

meta.exchangestring | null

Exchange code the request was scoped to, when applicable.

Example: "NSE"

meta.symbolstring | null

Ticker symbol the request was scoped to, when applicable.

Example: "SCOM.KE"

Response codes

200Holiday calendar entries for the requested range.

400Invalid exchange code or date format.

401Unauthorized.

Sandbox playground

Read-only sandbox request

exchange Optional · queryfrom Optional · queryto Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/market/holidays

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "exchange",
          "date",
          "reason"
        ],
        "properties": {
          "exchange": {
            "type": "string",
            "example": "NSE",
            "description": "Exchange code."
          },
          "date": {
            "type": "string",
            "format": "date",
            "example": "2026-12-25",
            "description": "Closure date in YYYY-MM-DD format."
          },
          "reason": {
            "type": "string",
            "example": "Christmas Day",
            "description": "Human-readable reason for the closure."
          }
        }
      }
    },
    "count": {
      "type": "integer",
      "example": 8
    },
    "from": {
      "type": "string",
      "format": "date",
      "example": "2026-06-06"
    },
    "to": {
      "type": "string",
      "format": "date",
      "example": "2026-12-31"
    },
    "meta": {
      "type": "object",
      "description": "Standard response metadata included on every market-data envelope.",
      "properties": {
        "request_id": {
          "type": "string",
          "format": "uuid",
          "description": "Unique identifier for this request. Include in support tickets for tracing.",
          "example": "4f6e1a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b"
        },
        "timestamp": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601 UTC timestamp of when the response was generated.",
          "example": "2026-06-04T10:23:45.123Z"
        },
        "exchange": {
          "type": [
            "string",
            "null"
          ],
          "description": "Exchange code the request was scoped to, when applicable.",
          "example": "NSE"
        },
        "symbol": {
          "type": [
            "string",
            "null"
          ],
          "description": "Ticker symbol the request was scoped to, when applicable.",
          "example": "SCOM.KE"
        }
      }
    }
  }
}

curl -X GET 'https://mystocks.africa/api/sandbox/v1/partner/market/holidays' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

GET /market/exchanges

GET /market/movers