API product catalogPan-African Market Data & Intelligence

List supported exchanges

Pan-African Market Data & Intelligence

GET

/market/exchanges

Sandbox availablegetMarketExchanges

Returns metadata for all supported exchanges — exchange code, name, country, currency, timezone, local trading hours, and real-time market status (OPEN/CLOSED). No parameters required. Response reflects the current server time. Formerly GET /market-data/exchanges, which remains a supported (deprecated) alias.

Parameters

This endpoint has no path or query parameters.

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

dataobject[]

data[].codestring

Exchange code.

Example: "NSE"

data[].micstring

ISO 10383 operating Market Identifier Code.

Example: "XNAI"

data[].namestring

Full exchange name.

Example: "Nairobi Securities Exchange"

data[].countrystring

ISO 3166-1 alpha-2 country code.

Example: "KE"

data[].currencystring

Local trading currency.

Example: "KES"

data[].timezonestring

IANA timezone identifier.

Example: "Africa/Nairobi"

data[].trading_hoursobject

data[].settlementobject

Exchange settlement cycle. See GET /market/settlement for full detail (CSD, processing window).

data[].market_statusOPEN | CLOSED

Current market status based on server time and exchange schedule.

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

200List of supported exchanges with current market status.

401Unauthorized.

Sandbox playground

Read-only sandbox request

Sandbox API keyYour key stays in this page’s memory.

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

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Exchange code.",
            "example": "NSE"
          },
          "mic": {
            "type": "string",
            "description": "ISO 10383 operating Market Identifier Code.",
            "example": "XNAI"
          },
          "name": {
            "type": "string",
            "description": "Full exchange name.",
            "example": "Nairobi Securities Exchange"
          },
          "country": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 country code.",
            "example": "KE"
          },
          "currency": {
            "type": "string",
            "description": "Local trading currency.",
            "example": "KES"
          },
          "timezone": {
            "type": "string",
            "description": "IANA timezone identifier.",
            "example": "Africa/Nairobi"
          },
          "trading_hours": {
            "type": "object",
            "properties": {
              "open": {
                "type": "string",
                "description": "Local session open time (HH:MM).",
                "example": "09:00"
              },
              "close": {
                "type": "string",
                "description": "Local session close time (HH:MM).",
                "example": "15:00"
              }
            }
          },
          "settlement": {
            "type": "object",
            "nullable": true,
            "description": "Exchange settlement cycle. See GET /market/settlement for full detail (CSD, processing window).",
            "properties": {
              "cycle": {
                "type": "string",
                "description": "Settlement cycle in T+N notation.",
                "example": "T+3"
              },
              "cycleDays": {
                "type": "integer",
                "description": "Settlement cycle length in business days.",
                "example": 3
              }
            }
          },
          "market_status": {
            "type": "string",
            "enum": [
              "OPEN",
              "CLOSED"
            ],
            "description": "Current market status based on server time and exchange schedule."
          }
        }
      }
    },
    "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/exchanges' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

GET /market-intel/{id}

GET /market/holidays