API product catalogExecution & Order Management (OMS)

Market status (NSE, NGX, JSE, GSE, etc.)

Execution & Order Management (OMS)

GET

/market/status

Sandbox availablegetMarketStatus

Returns the real-time open/closed status for each supported African stock exchange (NSE, NGX, JSE, GSE, BRVM, ZSE, BSE, LUSE, EGX, DSE, USE, MSE, CSE, SEM), next session boundaries, server time, and local trading hours. Pass ?exchange=NSE to get status for a single exchange. Without the filter the response includes all exchanges plus an anyOpen boolean.

Parameters

exchangestringquery

Filter to a single exchange code (NSE, NGX, JSE, GSE, BRVM, ZSE, BSE, LUSE, EGX, DSE, USE, MSE, CSE, SEM).

Example: NSE

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

anyOpenboolean

True if at least one exchange is currently open.

checkedAtstring

serverTimestring

exchangesobject

Keyed by exchange code (e.g. "NSE", "NGX"). Each value is an exchange status object.

Response codes

200Exchange status map.

404Unknown exchange code.

Sandbox playground

Read-only sandbox request

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

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

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "anyOpen": {
      "type": "boolean",
      "description": "True if at least one exchange is currently open."
    },
    "checkedAt": {
      "type": "string",
      "format": "date-time"
    },
    "serverTime": {
      "type": "string",
      "format": "date-time"
    },
    "exchanges": {
      "type": "object",
      "description": "Keyed by exchange code (e.g. \"NSE\", \"NGX\"). Each value is an exchange status object.",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "Nairobi Securities Exchange"
          },
          "country": {
            "type": "string",
            "example": "Kenya"
          },
          "currency": {
            "type": "string",
            "example": "KES"
          },
          "isOpen": {
            "type": "boolean"
          },
          "status": {
            "type": "string",
            "enum": [
              "OPEN",
              "CLOSED"
            ]
          },
          "localOpen": {
            "type": "string",
            "description": "Local market open time (HH:MM).",
            "example": "09:00"
          },
          "localClose": {
            "type": "string",
            "description": "Local market close time (HH:MM).",
            "example": "15:00"
          },
          "timezone": {
            "type": "string",
            "example": "Africa/Nairobi"
          },
          "nextOpen": {
            "type": "string",
            "format": "date-time",
            "description": "ISO timestamp of the next future session open, skipping known holidays."
          },
          "nextClose": {
            "type": "string",
            "format": "date-time",
            "description": "Current session close when open; otherwise the close of the next session."
          },
          "serverTime": {
            "type": "string",
            "format": "date-time"
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "HOLIDAY",
              "NON_TRADING_DAY",
              "OUTSIDE_TRADING_HOURS",
              "CLOSED",
              null
            ]
          },
          "session": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "open",
                  "close"
                ],
                "properties": {
                  "open": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "close": {
                    "type": "string",
                    "format": "date-time"
                  }
                }
              },
              {
                "type": "null"
              }
            ]
          }
        }
      }
    }
  }
}

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

GET /market/settlement

GET /opportunities