Docs/Reference/Compare/Get Timeseries
GET/v1/timeseriesTier · Developer

Get Timeseries

Time-series data for a single metric across one or more companies.

Returns data in a chart-friendly format: one array per company, each element being {fiscal_year, value}.

Query parameters · 4

Optional filters and modifiers. Pass as URL-encoded ?key=value.

codesstringrequired

Comma-separated EDINET or securities codes (max 5)

metricstringoptional

Financial metric to chart

default revenue
yearsintegeroptional
default 10
split_adjustedbooleanoptional

Adjust per-share metrics (eps, bps, dividends_per_share) for detected stock splits. Set to false for raw values.

default true

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains an array of TimeseriesResultOut.

Envelope

dataTimeseriesResultOut[]

Array of result objects.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

TimeseriesResultOut

companyCompanyOut

Company details.

metricstring

Which metric is charted (e.g. 'revenue', 'roe').

pointsTimeseriesPoint[]

Time series data points ordered by fiscal year.

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.