# Tradevo Data

> Point-in-time US equity fundamentals API built from SEC EDGAR. Every value is stamped with
> `first_filed` — the date it actually became public — so backtests never see numbers before
> the market did (no lookahead bias). Each row carries the first-reported value AND the latest
> revision, with a `restated` flag and per-row QA status. Free API key (250 requests/day, full
> annual + quarterly API, no card); $29/mo adds bulk + 5,000 requests/day; free 40-company CC0 sample too.

Key facts (generated from the live database at build time):
- Coverage: 5,170 US companies, 633,394 point-in-time rows, 16 concepts (Revenue, NetIncome,
  Assets, StockholdersEquity, OperatingCashFlow, EPSDiluted, DilutedShares), up to 12 fiscal years.
- Annual 10-K/10-K/A plus quarterly 10-Q history. Quarterly v1 covers seven quarterly concepts; Q4 is
  reported where tagged or derived and labelled where supported. Q4 EPS and diluted shares are not derived; no TTM.
- Measured filing lag (fiscal period end → first public): mean 66 days across the full universe
  (median 60, 90th percentile 90, on the 569,348 filed_reliable rows);
  43.2 days on the fast-filing 40-large-cap sample. A row is filed_reliable only when its lag is
  0–120 days, so 120 is the QA cutoff for reliable rows, not a measured maximum — cite the percentile.
- 37,941 labeled restatements (same-tag revisions >0.5%, incl. 10-K/A amendments).
- API: GET /v1/fundamentals?ticker=AAPL&as_of=2025-02-15[&concept=Revenue][&period=annual|quarterly] —
  period defaults to annual and the server does the point-in-time join (first_filed <= as_of).
  Free key: 250 requests/day. Paid ($29/mo): 5,000 requests/day,
  2,500 distinct tickers/day.
- Bulk is paid-plan only: GET /v1/download?period=annual|quarterly (one gzipped CSV, sha256 integrity header) and
  GET /v1/snapshot?as_of=YYYY-MM-DD&period=annual|quarterly (whole-universe point-in-time cross-section).
- Source is public-domain SEC EDGAR; the full methodology is published and re-derivable.
- Not investment advice. Data product only — no signals, no performance claims.

## Docs
- [API documentation](https://tradevodata.com/docs): endpoint, parameters, errors, limits, examples
- [OpenAPI spec](https://tradevodata.com/openapi.json)
- [Changelog](https://tradevodata.com/changelog): dataset corrections are published, not buried
- [Status](https://tradevodata.com/status)

## Free sample (no signup)
- [GitHub — 40 companies, 6,969 rows, 16 concepts, CSV + methodology](https://github.com/christianpichichero-max/pit-fundamentals)
- [Kaggle mirror](https://www.kaggle.com/datasets/christianpichichero/point-in-time-us-equity-fundamentals-sample)
- [HuggingFace mirror](https://huggingface.co/datasets/Tradevodata/point-in-time-us-equity-fundamentals-sample)

## Guides
- [Lookahead bias in fundamental backtests, measured](https://tradevodata.com/blog/lookahead-bias-fundamental-backtests)
- [What point-in-time fundamentals data actually means](https://tradevodata.com/blog/point-in-time-fundamentals-data)
- [Survivorship bias vs lookahead bias](https://tradevodata.com/blog/survivorship-bias-vs-lookahead-bias)
- [Building point-in-time fundamentals from SEC EDGAR](https://tradevodata.com/blog/building-point-in-time-fundamentals-from-sec-edgar)
- [Honest comparisons vs Sharadar, SimFin, FMP, EODHD, Tiingo](https://tradevodata.com/alternatives)

## Company pages (point-in-time snapshots)
- [All covered companies](https://tradevodata.com/companies)