# 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.