Skip to main content
GET
/
v2
/
history
curl
curl "https://api.stockcontext.com/v2/history?symbol=AAPL&series=close&range=1m" \
  -H "X-API-Key: $STOCKCONTEXT_API_KEY"
{
  "data": {
    "as_of": "2026-06-11T23:59:59Z",
    "cache_age_seconds": 0,
    "cadence": "daily",
    "columns": [
      "date",
      "close"
    ],
    "coverage": {
      "end": "2026-06-11",
      "start": "2026-05-12"
    },
    "freshness": "end_of_day",
    "market_status": "open",
    "period": "1m",
    "rows": [
      [
        "2026-05-12",
        294.8
      ],
      [
        "2026-05-13",
        298.87
      ],
      [
        "2026-05-14",
        298.21
      ],
      [
        "2026-05-15",
        300.23
      ],
      [
        "2026-05-18",
        297.84
      ],
      [
        "2026-05-19",
        298.97
      ]
    ],
    "symbol": "AAPL"
  },
  "schema_version": "2026-06-17.6"
}

Authorizations

​
X-API-Key
string
header
required

StockContext API key. Keys start with sctx_ and are sent on every REST request.

Query Parameters

​
symbol
string
required

Ticker symbol. Case-insensitive; share-class dots are normalized to dashes (BRK.B == BRK-B). Returns SYMBOL_UNKNOWN when the symbol is outside the supported universe.

Example:

"AAPL"

​
series
string | null

Comma-separated list of history series. Allowed values: close, volume, rsi_14, pe_ttm, ps_ttm, ev_ebitda_ttm, roic_pct, fcf_margin_pct, gross_margin_pct, dividend. daily/weekly support close, volume, rsi_14, pe_ttm, ps_ttm, ev_ebitda_ttm; quarterly/annual support roic_pct, fcf_margin_pct, gross_margin_pct; per-payment supports dividend. The valuation series (pe_ttm, ps_ttm, ev_ebitda_ttm) are derived from SEC EDGAR filings with point-in-time TTM windows joined on each filing's date.

Example:

"close,volume"

​
range
enum<string> | null

Historical lookback window. Allowed values: 1m, 1mo, 3m, 3mo, 6m, 6mo, 1y, 2y, 5y, 10y, 30y, ytd, max. Long mo forms normalize to short month forms; max is capped at 30y.

Available options:
1m,
1mo,
3m,
3mo,
6m,
6mo,
1y,
2y,
5y,
10y,
30y,
ytd,
max
Example:

"1y"

​
period
enum<string> | null

Legacy alias for range (back-compat).

Available options:
1m,
1mo,
3m,
3mo,
6m,
6mo,
1y,
2y,
5y,
10y,
30y,
ytd,
max
Example:

"1m"

​
cadence
enum<string> | null

Row cadence. Allowed values: daily, weekly, quarterly, annual, per-payment.

Available options:
daily,
weekly,
quarterly,
annual,
per-payment
Example:

"daily"

​
format
string | null

Response format: 'rows' (default) or 'compact'.

Example:

"compact"

Response

Success envelope: { "data": ... }.

​
data
HistoryData · object
required

The endpoint payload. Present on every 2xx response; never null.

​
schema_version
string
required

StockContext response schema version for this 200 payload.