Help centre ↗
← All help articles
API & ACCOUNT

API guide: historical metrics and chart series

Query annual or quarterly reported values, compare metrics and paginate aligned chart series.

One metric

Request a mapped metric by ticker or CIK. frequency defaults to annual; use quarterly for directly reported quarters. from and to filter the reported period end, while as_of filters the filing date.

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://api.findata.com/v1/companies/AAPL/metrics/revenue?frequency=quarterly&from=2020-01-01&as_of=2024-12-31"

The response contains observations and limitations. The single-metric route returns up to 200 observations and inspects at most 10,000 candidates; it does not provide a next-page cursor. Narrow your date range when you need a more focused result.

Compare metrics by period end

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://api.findata.com/v1/companies/AAPL/metrics/series?metrics=revenue,net_income,cash&frequency=quarterly&from=2020-01-01&limit=100"

The series route aligns 1–7 distinct metric codes on exact period-end dates and returns values as decimal strings. A null is not a zero. An instant balance-sheet value and a duration income-statement value that share an end date do not describe the same interval.

Get older pages

Each series page contains at most 200 dates. When next_before is present, pass its value as the before parameter in the next request, keeping metrics, frequency, dates and as_of unchanged. before is exclusive. A 422 response means the candidate limit was exceeded for at least one metric; narrow the date range.

Revisions

For a single metric, add view=history to retain available filing-level observations, or use the /history suffix. as_of uses filing dates, not intraday availability. Neither option reconstructs every historical SEC API snapshot.