---
title: "List Company Signals"
method: GET
path: "/v1/companies/{code}/ownership/signals"
tags: ["ownership"]
---

# List Company Signals

`GET /v1/companies/{code}/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/companies/{code}/ownership/signals`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/axioradev/apis/axiora-api/docs/v1/companies/:code/ownership/signals/get.ts> (a function with typed inputs; its response is checked against the schema)

Get ownership signals for a specific company.

By default excludes trivial signals (tier 3: new_position, exit_below_5pct).
Use `?as_of=<token>` to freeze the response, copying the token from a
previous response's `meta.as_of`.

## Path parameters

- `code` string, required: Securities or EDINET code of the issuer

## Query parameters

- `signal_type` string, nullable: Filter by signal type
- `include_trivial` boolean: Include tier 3 (trivial) signals
- `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.
- `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, 3 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
  - …4 more
- **2026-03-31** `debdd9fbc570`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axioradev/apis/axiora-api/changes/v1/companies/:code/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/47e27a7f92de?raw)
