Quotes, Movers, and Market Status

Quotes

Use GET /market/quotes?symbols=SCOM.KE,MTN.ZA for up to 50 symbols per request. Unresolved symbols appear in not_found without failing the whole batch. Use GET /stocks/{symbol} for a detailed single-instrument response.

Data freshness — read this before you price a trade

African equity quotes are exchange-supplied, 15-minute-delayed data—not real-time prices. MyStocks has full market-data rights for every supported exchange. The delay is the latency class of the exchange feed, not a licensing restriction. MyStocks targets a 15-minute ingestion cadence during the published coverage window, so delayMinutes: 15 describes the exchange delay while refreshIntervalSeconds: 900 describes the API refresh target. There is no tick-by-tick price feed. Outside the relevant exchange session, the latest observation is normally the EOD close.

Every quote carries its own freshness, so you never have to guess:

{
  "symbol": "SCOM.KE",
  "price": 17.85,
  "asOf": "2026-07-13T11:45:02.000Z",
  "stale": false,
  "dataFreshnessSeconds": 214,
  "dataQuality": {
    "delayMode": "DELAYED",
    "delayMinutes": 15,
    "refreshIntervalSeconds": 900,
    "provider": "mstocks",
    "disclaimer": "Exchange-supplied quote delayed by 15 minutes. API refresh target: 15 minutes. Not real-time tick data. Check `asOf`."
  }
}

GET /market/exchanges returns the same contract per exchange (marketData), plus a top-level marketDataPolicy block stating realtime: false, the 15-minute exchange delay, the API refresh target, and whether the intraday coverage window is currently open.

Because quotes are delayed, a market order is quote-gated: you must fetch a single-use quoteId from GET /quote/{symbol} and submit it with the order, so the price you were shown is the price the order is bound to. If you need to control the execution price yourself, place a LIMIT order instead — see Advanced order types.

Market state

• GET /market/status reports whether an exchange is open and its next open time.
• GET /market/holidays provides forward-looking closures.

changePct is a decimal return (0.042 means 4.2%). When the upstream row does not carry the field, the API derives it from price and previousClose; it remains null only when that comparison cannot be made. Sector labels are normalized for display and filtering (for example, Banking and Financial Services resolve to Financials).

• GET /market/movers ranks instruments by movement.
• GET /market/settlement describes market settlement cycles and execution targets.

Use market status and holidays before submitting orders. A quote can be valid while an exchange is closed; order acceptance and execution remain subject to market hours, halts, auctions, and dealing rules.

All responses are read-only and data-key safe. See Rate Limits for batch and polling strategy.