Finance

OHLCV historical data. Use period OR start/end, not both. Supports intraday intervals (1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h) and daily+ (1d, 5d, 1wk, 1mo, 3mo). A long window is downsampled upstream; the response reports the granularity actually served.

get/api/v2/quotes/{symbol}/historical

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v2/quotes/{symbol}/historical
  • Auth: API key in header x-api-key

Path parameters

symbolstring required

Stock, ETF or index ticker symbol, for example BRK-B, ^GSPC or OR.PA. Not for currency pairs or futures.

Query parameters

period'1d' | '5d' | '7d' | '60d' | '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | '10y' | 'ytd' | 'max' nullable

Lookback window: 1d, 5d, 7d, 60d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd or max. Alias of range. Give a window or start/end, not both.

range'1d' | '5d' | '7d' | '60d' | '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | '10y' | 'ytd' | 'max' nullable

Alias of period, the spelling used by /api/v2/market/chart and the indicators family.

startstring date nullable

Start date, YYYY-MM-DD. Give start/end or a window (period or range), not both.

endstring date nullable

End date, YYYY-MM-DD, later than start; for one day of history, the day after start.

interval'1m' | '2m' | '5m' | '15m' | '30m' | '60m' | '90m' | '1h' | '1d' | '5d' | '1wk' | '1mo' | '3mo'

1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo. A long window is downsampled upstream; the response reports the granularity actually served. Intraday history reaches back 7 days for 1m, 730 days for 60m and 1h, and 60 days for the other intraday intervals.

extended_hoursboolean

Include pre/post-market bars (intraday intervals only; ignored on 1d+).

limitinteger nullable

Return only the most recent N bars. Applied after the window is fetched, so it does not change what is cached.

Response

OHLCV historical bars for the symbol at the requested interval and period or date range.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

    • breaking

      removed the enum value 10y from the query request parameter period

    • breaking

      removed the enum value 10y from the query request parameter range

    • breaking

      removed the enum value 1d from the query request parameter period

    • breaking

      removed the enum value 1d from the query request parameter range

    • breaking

      removed the enum value 1mo from the query request parameter period

    • breaking

      removed the enum value 1mo from the query request parameter range

    • breaking

      removed the enum value 1y from the query request parameter period

    • breaking

      removed the enum value 1y from the query request parameter range

    • breaking

      removed the enum value 2y from the query request parameter period

    • breaking

      removed the enum value 2y from the query request parameter range

    • breaking

      removed the enum value 3mo from the query request parameter period

    • breaking

      removed the enum value 3mo from the query request parameter range

    • breaking

      removed the enum value 5d from the query request parameter period

    • breaking

      removed the enum value 5d from the query request parameter range

    • breaking

      removed the enum value 5y from the query request parameter period

    • breaking

      removed the enum value 5y from the query request parameter range

    • breaking

      removed the enum value 60d from the query request parameter period

    • breaking

      removed the enum value 60d from the query request parameter range

    • breaking

      removed the enum value 6mo from the query request parameter period

    • breaking

      removed the enum value 6mo from the query request parameter range

    • breaking

      removed the enum value 7d from the query request parameter period

    • breaking

      removed the enum value 7d from the query request parameter range

    • breaking

      removed the enum value max from the query request parameter period

    • breaking

      removed the enum value max from the query request parameter range

    • breaking

      removed the enum value ytd from the query request parameter period

    • breaking

      removed the enum value ytd from the query request parameter range

    • info

      added the enum value 10y to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 10y to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value 1d to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 1d to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value 1mo to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 1mo to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value 1y to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 1y to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value 2y to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 2y to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value 3mo to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 3mo to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value 5d to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 5d to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value 5y to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 5y to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value 60d to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 60d to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value 6mo to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 6mo to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value 7d to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value 7d to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value max to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value max to the property anyOf[subschema #1]/ of the query request parameter range

    • info

      added the enum value ytd to the property anyOf[subschema #1]/ of the query request parameter period

    • info

      added the enum value ytd to the property anyOf[subschema #1]/ of the query request parameter range

    • breaking

      the query request parameter interval was restricted to a list of enum values

    • breaking

      the query request parameter period was restricted to a list of enum values

    • breaking

      the query request parameter range was restricted to a list of enum values

    • breaking

      added the pattern ^\^?[A-Za-z0-9]{1,10}(?:[.-][A-Za-z0-9]{1,4})?$ to the path request parameter symbol

    • breaking

      for the query request parameter end, the format changed from no format to date

    • breaking

      for the query request parameter start, the format changed from no format to date

    • info

      added the new enum value 10y to the query request parameter period

    • info

      added the new enum value 10y to the query request parameter range

    • info

      added the new enum value 15m to the query request parameter interval

    • info

      added the new enum value 1d to the query request parameter interval

    • info

      added the new enum value 1d to the query request parameter period

    • info

      added the new enum value 1d to the query request parameter range

    • info

      added the new enum value 1h to the query request parameter interval

    • info

      added the new enum value 1m to the query request parameter interval

    • info

      added the new enum value 1mo to the query request parameter interval

    • info

      added the new enum value 1mo to the query request parameter period

    • info

      added the new enum value 1mo to the query request parameter range

    • info

      added the new enum value 1wk to the query request parameter interval

    • info

      added the new enum value 1y to the query request parameter period

    • info

      added the new enum value 1y to the query request parameter range

    • info

      added the new enum value 2m to the query request parameter interval

    • info

      added the new enum value 2y to the query request parameter period

    • info

      added the new enum value 2y to the query request parameter range

    • info

      added the new enum value 30m to the query request parameter interval

    • info

      added the new enum value 3mo to the query request parameter interval

    • info

      added the new enum value 3mo to the query request parameter period

    • info

      added the new enum value 3mo to the query request parameter range

    • info

      added the new enum value 5d to the query request parameter interval

    • info

      added the new enum value 5d to the query request parameter period

    • info

      added the new enum value 5d to the query request parameter range

    • info

      added the new enum value 5m to the query request parameter interval

    • info

      added the new enum value 5y to the query request parameter period

    • info

      added the new enum value 5y to the query request parameter range

    • info

      added the new enum value 60d to the query request parameter period

    • info

      added the new enum value 60d to the query request parameter range

    • info

      added the new enum value 60m to the query request parameter interval

    • info

      added the new enum value 6mo to the query request parameter period

    • info

      added the new enum value 6mo to the query request parameter range

    • info

      added the new enum value 7d to the query request parameter period

    • info

      added the new enum value 7d to the query request parameter range

    • info

      added the new enum value 90m to the query request parameter interval

    • info

      added the new enum value max to the query request parameter period

    • info

      added the new enum value max to the query request parameter range

    • info

      added the new enum value ytd to the query request parameter period

    • info

      added the new enum value ytd to the query request parameter range