# GET /v2/tickers/{ticker}/history

**Ticker as-of date**

Time-travel to any historical date and pull the whole wide row as it stood then, including the boolean flag values, technical indicators, and the most-recent fundamentals known on that date. Useful for backtests and "what did we know" reconstructions.

## Plan access

- **Plan access.** Included on every plan.
- **Rate limit.** Hobby 60/min · Pro 2,000/min · Scale 10,000/min.
- **History.** Hobby 1y · Pro 5y · Scale all-time.

## Query / path parameters

| Name | In | Type | Required | Description |
|------|----|----|----------|-------------|
| `ticker` | path | string | yes | Ticker symbol. Example: `AAPL`. |
| `asof` | query | string | yes | Target date as `YYYY-MM-DD` or full ISO timestamp `YYYY-MM-DDTHH:MM:SSZ`. The response returns the most-recent daily snapshot on or before this date. Example: `2026-03-01`. |

## Status codes

- **200** — Wide row at the requested date under `data`. `_meta.frozen_fields` lists fields that are not historized (sector, industry, etc.; JOIN to /tickers/{t} for current values).
- **400** — Missing `asof`, invalid format, or beyond your plan's history window.
- **401** — Missing or invalid API key.
- **404** — No historical state for that ticker at or before the requested date.

## Sample response

```json
{
  "as_of": "2026-03-01",
  "ticker": "AAPL",
  "_meta": {
    "resolution": "daily",
    "frozen_fields": ["name", "sector", "industry", "asset_type", "exchange"]
  },
  "data": {
    "ticker": "AAPL",
    "date": "2026-02-27",
    "price": 271.43,
    "day_change_pct": 0.0092,
    "volume_today": 38104000,
    "rsi_14": 64.7,
    "above_sma_50": true,
    "pe_ratio": 31.2,
    "eps": 9.04,
    "...": "(full daily row)"
  }
}
```

## Examples

### AAPL as of 2026-03-01

Request:

```shell
curl "https://api.tickerbot.io/v2/tickers/AAPL/history?asof=2026-03-01" \
  -H "Authorization: Bearer YOUR_KEY"
```

Response (`200`):

```json
{
  "as_of": "2026-03-01",
  "ticker": "AAPL",
  "_meta": {
    "resolution": "daily",
    "frozen_fields": ["name", "sector", "industry", "asset_type", "exchange"]
  },
  "data": {
    "ticker": "AAPL",
    "date": "2026-02-27",
    "price": 271.43,
    "day_change_pct": 0.0092,
    "volume_today": 38104000,
    "rsi_14": 64.7,
    "above_sma_50": true,
    "pe_ratio": 31.2,
    "eps": 9.04,
    "...": "(full daily row)"
  }
}
```

## Notes

- History depth is plan-gated: Hobby 1 year, Pro 5 years, Scale all-time, Enterprise all-time. Requests beyond the window return 400 history_window_exceeded.
- `frozen_fields` are not historized; they're snapshots of the *current* value. The other fields are correct as of the requested date.

---

Interactive sandbox + parameter editor: https://tickerbot.io/api/endpoints/tickers/history