Quote API

Latest quote snapshots for up to 50 stocks, ETFs, indices, crypto pairs and currency crosses per call, in the YH quoteResponse shape, refreshed on request.

Request

curl -H "x-api-key: $KEY" \
  "https://api.stockdataapi.com/v6/finance/quote?symbols=AAPL,MSFT,^GSPC"

Send your key in the x-api-key header. Try it in the browser with your own key.

Parameters

Also accepted, for compatibility with existing clients, and ignored: region, lang.

Behavior

• Quotes come back in request order, with duplicates collapsed.
• A symbol that cannot be found is left out of result: unknown tickers, and malformed ones (anything outside letters, digits and . ^ = & -, or longer than 20 characters). The call still answers 200, with an empty list if nothing matched.
• More symbols than your plan allows per request is a 400 naming the limit.
• A stored quote older than 60 seconds during the regular session (15 minutes otherwise) is refetched from the source before the call answers. The shared response cache then serves it for up to 30 seconds.
• URL-encode ^, = and & inside the list (%5EGSPC, ES%3DF, M%26M.NS): an unencoded & ends the parameter.

Example response

{
  "quoteResponse": {
    "result": [
      {
        "symbol": "AAPL",
        "shortName": "Apple Inc.",
        "currency": "USD",
        "marketState": "REGULAR",
        "regularMarketPrice": 230.5,
        "regularMarketOpen": 228.5,
        "regularMarketDayHigh": 231.2,
        "regularMarketDayLow": 227.8,
        "regularMarketPreviousClose": 228.0,
        "regularMarketVolume": 42000000
      }
    ],
    "error": null
  }
}

Related endpoints

• Chart API: OHLCV historyOHLCV history — daily back to 1970, plus intraday
• Spark API: close-price seriesClose-price mini series for watchlists and tiles
• Market summary APIIndex, futures, FX and crypto tiles for a market overview