Docs/Reference/Ownership/List Ownership Signals
GET/v1/ownership/signalsTier · Institutional

List Ownership Signals

Detected ownership signals market-wide.

A signal is a labelled event derived from a filer's trajectory: accumulation streaks, large step-ups/downs, activist escalations, coordinated buying, pace acceleration, purpose drift, etc. Each row carries a tier (1=actionable, 2=informational, 3=trivial), confidence, detected_date, and the doc_id of the triggering filing.

Default response excludes tier-3 (trivial threshold-crossing events like new_position / exit_below_5pct). Pass include_trivial=true for the full feed.

To freeze a response: capture meta.as_of from one call, then pass it back as ?as_of=<token> on later calls to replay the exact same set of rows.

Query parameters · 9

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

signal_typestring | nulloptional

Filter: accumulation_streak, large_step_up, large_step_down, exit_below_5pct, activist_escalation, new_position, pace_acceleration, purpose_drift, coordinated_accumulation, systematic_exit

filer_codestring | nulloptional

Filter by filer EDINET code (e.g. 'E03606' for SBI Holdings)

include_trivialbooleanoptional

Include tier 3 (trivial) signals like new_position and exit_below_5pct. Default returns only tier 1 (actionable) and tier 2 (informational).

default false
date_fromstring · date | nulloptional

Filter: detected_date on or after

format date
date_tostring · date | nulloptional

Filter: detected_date on or before

format date
as_ofstring | nulloptional

Freeze the response to a specific point in time. Pass a value previously returned in meta.as_of to replay the exact same answer. Omit for the live view.

limitintegeroptional

Results per page

default 50
offsetintegeroptional

Results to skip (ignored when cursor is set)

default 0
cursorstring | nulloptional

Opaque cursor for keyset pagination

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

Envelope

dataOwnershipSignalOut[]

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>

OwnershipSignalOut

signal_typestring

Signal type: accumulation_streak, large_step_up, exit_below_5pct, etc.

filer_codestring

Stable canonical identifier for the filer. Equals the filer's EDINET code for ungrouped filers; opaque token for entity-resolved groups.

filer_namestring | null

Name of the filer (JP)

filer_name_enstring | null

English name of the filer

issuer_security_codestring

Securities code of the issuer

issuer_namestring | null

Name of the issuer (JP)

issuer_name_enstring | null

English name of the issuer

detected_datestring · date

Date the signal was detected

format date
holding_ratio_pctnumber | null

At signal time. The stake this holder reports for itself, as a percentage of the issuer's outstanding shares. On a joint filing (co_holder_count > 1) this is the individual holder's own position, not the group's. Compare with group_ratio_pct for the combined position the 5% obligation attaches to.

delta_pctnumber | null

Change in percentage points

confidencenumber

Confidence score 0-1

doc_idstring | null

EDINET document ID of the triggering filing (e.g. 'S100ABCD')

tierinteger

Signal tier: 1=actionable, 2=informational, 3=trivial

default 3
metadataobject | null

Signal-specific context (streak, purpose, filers)

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.