List flat files
Per-trading-date gzipped CSV files for the US market, newest date first: eod (daily bars) and corporate-actions (dividends and splits that take effect that day). Files hold the rows GET /v1/eod and /v1/corporate-actions return for that New York trading date, except mutual funds (NMFQ), which only plans with mutual-funds.read may read and which /v1/eod and exports serve; files are published by the nightly build after the date and rebuilt for five trading days (the latest two hourly) so corrections republish changed files; the sha256 and generated_at change with each republication. Daily-bar and corporate-action files are kept; they exist from the first trading date the nightly build published (the oldest file listed), and earlier history is read from /v1/eod or an export. There are no intraday files: US listings are collected as five-minute bars, which /v1/intraday serves for 30 days. Requires flat-files.read (Pro, Commercial and Scale) and each listed dataset capability; without dataset only entitled datasets are listed. Dates before the plan history depth are omitted.
/v1/flat-files- Required capability
- flat-files.read
- Data timing
- Nightly files
- Credits
- 5 credits per request.
Parameters
datasetstringoptional · query- Only this dataset.
eodcorporate-actions fromstringoptional · query- Inclusive first trading date (YYYY-MM-DD).
tostringoptional · query- Inclusive last trading date (YYYY-MM-DD); must be on or after from, so from equal to to selects one day.
limitintegeroptional · query- Maximum files per page, from 1 to 500; default 100.Default:
100 cursorstringoptional · query- Opaque cursor, expires after one hour. Keep all query parameters unchanged.
Response fields
Returns data as an array of records. All example values are illustrative.
datasetstring- dataset
eodcorporate-actions marketstring- market
datestring- New York trading date the file covers.
rowsinteger- Data rows, excluding the header row.
bytesinteger- Size of the .csv.gz file.
sha256string- SHA-256 of the .csv.gz file; changes when the file is republished.
generated_atstring- When this version was published; also its knowledge cutoff.
download_pathstring- Relative URL that downloads the file.
Response metadata
Responses include meta.timezone. Dataset responses include next_cursor; health and exports have their own metadata. Request tracing uses the X-Request-ID header.
When something goes wrong
An empty data: [] is a successful query with no matching records. Invalid symbols, permissions and malformed parameters produce an RFC 9457 problem with an actionable detail.
Plans
Requires flat-files.read. Access, recency and history depth come from the plan definitions the API enforces.
| Plan | Access | Recency | History |
|---|---|---|---|
| Free | Not included | — | — |
| Developer | Not included | — | — |
| Pro | Included | Nightly files | 15 years |
| Commercial | Included | Nightly files | Full history |
| Scale | Included | Nightly files | Full history |
History is how far back a plan may request. How far records actually go for a symbol is history_from in dataset coverage. Nothing is real-time. Compare plans