Docs/Reference/Ownership/Get Ownership Chart
GET/v1/companies/{code}/ownership/chartTier · Institutional

Get Ownership Chart

Chart-ready ownership timeline for a company.

Returns one series per filer with all points sorted by date. Merges trajectory data (entity-grouped) with raw shareholding filings for filers not covered by trajectories. Max 15 series.

Path parameters · 1

Variables interpolated into the URL path.

codestringrequired

Securities code (e.g. '7203') or EDINET code (e.g. 'E02144')

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 OwnershipChartSeriesOut.

Envelope

dataOwnershipChartSeriesOut[]

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>

OwnershipChartSeriesOut

filer_codestring | null

EDINET code of the filer. Null when the filer is a group of entities with no EDINET code of its own; use filer_name.

filer_namestring | null

Name of the filer

sourcestring

'trajectory' or 'shareholding'

trajectory_typestring | null

accumulating, exiting, stable, new_position

latest_holding_pctnumber | null

Most recent holding ratio

pointsOwnershipChartPointOut[]

Timeline points sorted by date

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.