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.