# Getting Started with Market Data API

> Fetch a symbol catalogue, quote, and historical series from the MyStocks Market Data API.

## Before you start

- Use a full key or read-only `pk_data_` key.
- Confirm the environment and base URL in [Authentication](/partners/docs/auth).
- Review [rate limits](/partners/docs/rate-limits) and [data licensing](/partners/docs/data-licensing).

## First requests

1. Call `GET /stocks?exchange=NSE&limit=20` to discover canonical symbols.
2. Call `GET /market/quotes?symbols=SCOM.KE` for the current quote.
3. Call `GET /stocks/SCOM.KE/candles?interval=1d&from=2025-08-10&to=2026-08-10` for historical candles.
4. Inspect the response currency, exchange, freshness, and `historyConfidence` fields.
5. Cache only within the limits described by your data-licensing terms.

The [Stocks](/partners/docs/stocks) and [ETF/charts](/partners/docs/etfs-and-charts) guides contain response examples. Use the [API Reference](/partners/docs/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](/partners/docs/endpoints/listStocks)      | [Prepare stocks request](/partners/docs/api-tester?endpoint=listStocks)     |
| Read a quote         | [Batch quotes](/partners/docs/endpoints/getBatchQuotes) | [Prepare quotes request](/partners/docs/api-tester?endpoint=getBatchQuotes) |

If access is rejected, check the key environment and entitlement in [Authentication](/partners/docs/auth). 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](/partners/docs/product-market-data).
