---
title: "List Ownership Signals"
method: GET
path: "/v1/ownership/signals"
tags: ["ownership"]
---

# List Ownership Signals

`GET /v1/ownership/signals`

## Request

- Base URL: `https://api.axiora.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.axiora.dev/v1/ownership/signals`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/axioradev/apis/axiora-api/docs/v1/ownership/signals/get.ts> (a function with typed inputs; its response is checked against the schema)

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

- `signal_type` string, nullable: 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_code` string, nullable: Filter by filer EDINET code (e.g. 'E03606' for SBI Holdings)
- `include_trivial` boolean: Include tier 3 (trivial) signals like new_position and exit_below_5pct. Default returns only tier 1 (actionable) and tier 2 (informational).
- `date_from` string, date, nullable: Filter: detected_date on or after
- `date_to` string, date, nullable: Filter: detected_date on or before
- `as_of` string, nullable: 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.
- `limit` integer: Results per page
- `offset` integer: Results to skip (ignored when cursor is set)
- `cursor` string, nullable: Opaque cursor for keyset pagination

## Response `200`

Successful Response

- ListResponseOwnershipSignalOut
  - `data` OwnershipSignalOut[], required: Array of result objects.
    - `signal_type` string, required: Signal type: accumulation_streak, large_step_up, exit_below_5pct, etc.
    - `filer_code` string, required: Stable canonical identifier for the filer. Equals the filer's EDINET code for ungrouped filers; opaque token for entity-resolved groups.
    - `filer_name` string, nullable: Name of the filer (JP)
    - `filer_name_en` string, nullable: English name of the filer
    - `issuer_security_code` string, required: Securities code of the issuer
    - `issuer_name` string, nullable: Name of the issuer (JP)
    - `issuer_name_en` string, nullable: English name of the issuer
    - `detected_date` string, date, required: Date the signal was detected
    - `holding_ratio_pct` number, nullable: 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_pct` number, nullable: Change in percentage points
    - `confidence` number, required: Confidence score 0-1
    - `doc_id` string, nullable: EDINET document ID of the triggering filing (e.g. 'S100ABCD')
    - `tier` integer: Signal tier: 1=actionable, 2=informational, 3=trivial
    - `metadata` object, nullable: Signal-specific context (streak, purpose, filers)
  - `meta` AxioraApiSchemasMeta, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `996d12eb9cb3`: 1 breaking, 4 warning, 2 info
  - removed the required property `meta/request_id` from the response with the `200` status
  - removed the optional property `meta/limit` from the response with the `200` status
  - removed the optional property `meta/next_cursor` from the response with the `200` status
  - removed the optional property `meta/offset` from the response with the `200` status
  - …3 more
- **2026-03-31** `debdd9fbc570`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axioradev/apis/axiora-api/changes/v1/ownership/signals/get.md)

---

[API](https://skmtc.dev/axioradev/apis/axiora-api.md) - [All operations](https://skmtc.dev/axioradev/apis/axiora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/axioradev/apis/axiora-api/revisions/19ceccd9a71d?raw)