Stooq · Schema

Stooq Historical Data API Query Parameters

Query parameters accepted by the Stooq Historical Data API endpoint at https://stooq.com/q/d/l/

FintechMarket DataStocksIndicesCurrenciesCryptoCommoditiesHistorical DataFree

Properties

Name	Type	Description
s	string	Ticker symbol with optional exchange suffix. Covers equities (.US, .UK, .DE, .JP, .HK, .HU), currencies (e.g. gbp.v, eur.v), cryptocurrencies (e.g. btc.v), indices (e.g. spx), commodities (e.g. oil, g
d1	string	Start date of the data range in YYYYMMDD format. If omitted, the API returns all available history up to d2.
d2	string	End date of the data range in YYYYMMDD format. If omitted, defaults to the most recent available date.
i	string	Data interval. d=daily, w=weekly, m=monthly, q=quarterly, y=yearly, 60=hourly (~9 months history), 5=5-minute (~1 month history).
apikey	string	API key obtained from the Stooq website via a CAPTCHA-gated registration form. Required as of early 2026.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://stooq.com/schemas/query-parameters",
  "title": "Stooq Historical Data API Query Parameters",
  "description": "Query parameters accepted by the Stooq Historical Data API endpoint at https://stooq.com/q/d/l/",
  "type": "object",
  "required": ["s", "apikey"],
  "properties": {
    "s": {
      "type": "string",
      "description": "Ticker symbol with optional exchange suffix. Covers equities (.US, .UK, .DE, .JP, .HK, .HU), currencies (e.g. gbp.v, eur.v), cryptocurrencies (e.g. btc.v), indices (e.g. spx), commodities (e.g. oil, gold), and bonds.",
      "examples": ["aapl.us", "googl.us", "msft.us", "btc.v", "gbp.v", "spx", "oil", "gold"]
    },
    "d1": {
      "type": "string",
      "pattern": "^\\d{8}$",
      "description": "Start date of the data range in YYYYMMDD format. If omitted, the API returns all available history up to d2.",
      "examples": ["20200101", "19900101"]
    },
    "d2": {
      "type": "string",
      "pattern": "^\\d{8}$",
      "description": "End date of the data range in YYYYMMDD format. If omitted, defaults to the most recent available date.",
      "examples": ["20231231", "20260613"]
    },
    "i": {
      "type": "string",
      "enum": ["d", "w", "m", "q", "y", "60", "5"],
      "default": "d",
      "description": "Data interval. d=daily, w=weekly, m=monthly, q=quarterly, y=yearly, 60=hourly (~9 months history), 5=5-minute (~1 month history)."
    },
    "apikey": {
      "type": "string",
      "description": "API key obtained from the Stooq website via a CAPTCHA-gated registration form. Required as of early 2026.",
      "examples": ["your_api_key_here"]
    }
  },
  "additionalProperties": false
}