History
Bulk historical sync endpoint for one ticker across a date range
Overview
Use /history when you need a full time series for one ticker. This endpoint is designed for backfills and research syncs, so clients do not need to loop over thousands of dated /summary requests.
Internally, TickerAPI serves the hot window from Cloudflare KV and deeper history from versioned R2 archives. The response shape stays stable either way.
Each row contains the same core asset snapshot returned by Summary, plus support/resistance level payloads that use the same level terminology documented in Bands.
Plus Up to 2 years of history.
Pro Up to 5 years of history.
Parameters
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
ticker | path | string | Yes | Asset symbol to fetch, for example AAPL, MSFT, or BTCUSD. |
timeframe | query | string | No | daily or weekly. Defaults to daily. |
start | query | date | Yes | Inclusive range start in YYYY-MM-DD format. |
end | query | date | Yes | Inclusive range end in YYYY-MM-DD format. |
start and end are required together. Bounds are inclusive, rows are returned in ascending date order, and requests outside your tier window return 400. If the ticker exists but there is no data inside the requested range, the endpoint still returns a valid envelope with row_count: 0 and an empty rows array.
Example
Response Shape
rows[].summary follows the Summary response contract. rows[].levels carries the historical support/resistance objects, including distance and status bands described in Bands.
| Field | Type | Description |
|---|---|---|
ticker | string | The requested asset symbol. |
timeframe | string | daily or weekly. |
start | string | Echoed inclusive start bound. |
end | string | Echoed inclusive end bound. |
row_count | integer | Total number of rows returned for the requested range. |
rows | array | Ascending historical snapshots for the ticker and timeframe. |
Row Object
| Field | Type | Description |
|---|---|---|
rows[].date | string | Snapshot date for that bar or week. |
rows[].schema_version | string | History row schema version for forward compatibility. |
rows[].summary | object | Full asset snapshot for that date. See Summary. |
rows[].levels | object | Historical support/resistance payload for that date. Distance and status values use the same vocabulary documented in Bands. |
rows[].levels may be absent or null when level data is unavailable for that row or not included for the requesting tier.