Getting Started with Market Data API
Fetch a symbol catalogue, quote, and historical series from the MyStocks Market Data API.
Explore endpoints
33 of 33/assets
Unified asset catalog
Full endpoint documentationlistAssetsReturns stocks, ETFs, bonds, and funds in one normalized catalog. Instruments that exist but cannot currently be transacted remain discoverable with tradable: false, a status, and capability flags. Unknown exchange order constraints are returned as null rather than inferred.
Parameters
assetClassSTOCK | ETF | BOND | FUNDqueryexchangestringquerystatusstringquerytradablebooleanquerysearchstringquerylimitintegerqueryExample: 100
cursorstringqueryHeaders
AuthorizationstringRequiredBearer sk_sandbox_<your_key> for sandbox requests.
Response fields
dataobject[]Requireddata[].assetIdstringRequiredExample: "stock:SCOM.KE"
data[].sourceIdstringRequireddata[].symbolstring | nulldata[].namestring | nulldata[].assetClassSTOCK | ETF | BOND | FUNDRequireddata[].exchangestring | nulldata[].exchangeMicstring | nulldata[].currencystringRequireddata[].statusstringRequireddata[].statusReasonstring | nulldata[].tradablebooleanRequireddata[].fractionablebooleanRequireddata[].shortablebooleanRequireddata[].marginablebooleanRequireddata[].minOrderSizenumber | nulldata[].lotSizenumber | nulldata[].tickSizenumber | nulldata[].settlementCyclestring | nulldata[].capabilitiesobjectRequireddata[].fractionalEligibilityobjectRequireddata[].orderRulesobjectRequireddata[].settlementunioncountintegerRequiredhasMorebooleanRequirednextCursorstring | nullResponse codes
200Normalized asset page.Before you start
- Use a full key or read-only
pk_data_key. - Confirm the environment and base URL in Authentication.
- Review rate limits and data licensing.
First requests
- Call
GET /stocks?exchange=NSE&limit=20to discover canonical symbols. - Call
GET /market/quotes?symbols=SCOM.KEfor the current quote. - Call
GET /stocks/SCOM.KE/candles?interval=1d&from=2025-08-10&to=2026-08-10for historical candles. - Inspect the response currency, exchange, freshness, and
historyConfidencefields. - Cache only within the limits described by your data-licensing terms.
The Stocks and ETF/charts guides contain response examples. Use the API Reference for filters and pagination.
Verify the result
Use the same key and canonical symbol throughout. A successful HTTP response alone does not establish fresh market data. Check the exchange, currency, timestamp and confidence fields before displaying a price. An empty historical range is different from an authentication failure.
| Task | Reference | Sandbox preparation |
|---|---|---|
| Discover instruments | List stocks | Prepare stocks request |
| Read a quote | Batch quotes | Prepare quotes request |
If access is rejected, check the key environment and entitlement in Authentication. For throttling, respect Retry-After; for missing or stale prices, retain the timestamp rather than substituting a synthetic current quote. Next, implement the caching and freshness policy in Market Data.
Was this page useful?
Your signal helps us tighten partner onboarding docs.
Last updated on
Market Data API
Browse African exchanges and consume MyStocks quotes, historical prices, charts, companies, news, and market intelligence.
Stocks
Delayed and historical price data for equities and ETFs across supported African exchanges — quotes, charts, news pulse, company fundamentals, canonical tickers, and curated market intelligence. All read-only and data-key safe.