HistoricalDataFree stock and options data samples
Real CSV files from July–December 2022, with all fields in the paid archives' format and examples of stock splits, dividend payments and a delisted stock.
Stock sample
- Tickers
- TSLA · KO · SPY · TWTR
- Period
- July–December 2022 · 127 trading days; 83 for TWTR, ending 27 October.
- Files
- Separate daily and 1-minute CSVs for each ticker: 8 data files, with 17 and 18 columns respectively.
What you can test
| Ticker | Scenario | What to check |
|---|---|---|
| TSLA | 3-for-1 split · 25 August | Compare raw and adjusted prices across the split, alongside the recorded split event. |
| KO | Cash dividends · 15 September and 30 November | Find the $0.44 payments in dividend and inspect their ex-date labels and price adjustments. |
| SPY | ETF distributions · 16 September and 16 December | Inspect ETF distributions and align the stock bars with SPY contracts in the options sample. |
| TWTR | Delisting · last bar 27 October | Handle a series that ends while the other tickers continue through December. |
View stock sample rows · Stock field definitionsDownload stock sample (8 MB)
Options sample
- Underlyings
- TSLA · KO · SPY · SPX (including SPXW)
- Period
- July–December 2022 · 127 trading days, matching the stock sample's window.
- Files
- One end-of-day CSV per trading day: 127 data files, with all 34 columns, including quotes, Greeks and implied volatility.
What you can test
| Underlying | Scenario | What to check |
|---|---|---|
| TSLA | Stock split · 25 August | Follow changes in contracts and strikes around the 3-for-1 split, using the stock sample for comparison. |
| KO | Dividend-paying stock | Inspect option quotes and implied volatility around the ex-dividend dates in the stock sample. |
| SPY | American-style ETF options | Compare contracts with SPX index options, accounting for early exercise and physical rather than cash settlement. |
| SPX / SPXW | European-style index options | Inspect AM/PM settlement and find same-day expirations where expiration equals quote_date. |
View options sample rows · Options field definitionsDownload options sample (239 MB)
Verify the sample files
Each ZIP includes a README, a file manifest and verify.py. Python is required; no additional packages are needed.
- Stocks
- From the extracted stock sample folder, run
python verify.py --strict --extract .. - Options
- From the extracted options sample folder, run
python verify.py --complete day_by_date.
The scripts check file checksums, column structure and documented data rules, and report failures by file.
For broader testing, see the data evaluation guide.
Sample scope
These six months let you test file formats and your processing workflow, but do not represent field availability across the full history. All columns are retained; fields unavailable in this period, such as options quote_time, remain blank.
Review historical coverage and conventions: Stock data limits · Options data limits.