# Market Data API

> Browse African exchanges and consume MyStocks quotes, historical prices, charts, companies, news, and market intelligence.

The Market Data API is read-only and can be used with a full partner key or a restricted data key. It covers exchange catalogues, stock and ETF prices, historical candles, charts, company profiles, news, market status, and curated market intelligence. The commercial pricing policy is: sandbox prices are delayed by **15 minutes**; paid licenses provide **real-time prices**.

[Get started](/partners/docs/getting-started-market-data)Fetch your first exchange, stock, and historical price response.
[Stocks and ETFs](/partners/docs/stocks)Browse symbols, quotes, fundamentals, news, and chart data.
[Historical and charts](/partners/docs/historical-market-data)Request date-bounded daily, weekly, and monthly candles.
[API Tester](/partners/docs/api-tester)Try read-only market-data endpoints.

## Price tiers and event delivery

The product owner confirmed this policy on **3 October 2026**:

| License | Price delivery           |
| ------- | ------------------------ |
| Sandbox | 15-minute-delayed prices |
| Paid    | Real-time prices         |

Quote delivery is separate from account and order notifications. Webhooks and SSE carry
state-change events, not price ticks or a streaming order book. Event arrival does not establish
quote freshness; inspect `asOf`, `stale` and the response's data-quality metadata.

**Implementation status:** the shared quote path currently reports `delayMinutes: 15` and
`refreshIntervalSeconds: 900` without a license-specific distinction. That path has not yet
been reconciled with the commercial policy above. Do not relabel a delayed or stale response
as real-time based only on the license tier. The detailed quote examples describe that existing
path, not verified delivery of the new tier policy.

Every listed African equity has EOD price history for a line chart. Reported OHLCV is available only
where the source series contains it, so use `recommendedChartType` and the quality metadata before
rendering candlesticks or volume. SSE and webhooks deliver state-change events; they are not
tick-by-tick price feeds. See [Data Licensing](/partners/docs/data-licensing).