GET /v1/companies/{code}/ownership/signals · API Reference

Path parameters · 1

Variables interpolated into the URL path.

codestringrequired

Securities or EDINET code of the issuer

Query parameters · 6

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

signal_typestring | nulloptional

Filter by signal type

include_trivialbooleanoptional

Include tier 3 (trivial) signals

default false

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.

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.

RequestcURL

curl "https://api.axiora.dev/v1/companies/6330/ownership/signals" \
  -H "Authorization: Bearer ax_live_…"

Response · 200

200 OK

{
  "data": [
    {
      "signal_type": "…",
      "filer_code": "…",
      "filer_name": null,
      "filer_name_en": null,
      "issuer_security_code": "…",
      "issuer_name": null,
      "issuer_name_en": null,
      "detected_date": "…"
      // …more fields
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "total": 1,
    "limit": 50,
    "offset": 0,
    "next_cursor": null,
    "data_as_of": "2026-05-12T03:25:11Z",
    "ontology_version": "2.1.0",
    "as_of": "frz_01HRX9KQ2T8N7P4M"
  }
}

Response · 401

401 UNAUTHORIZED

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key. Pass it as `Authorization: Bearer ax_live_…`."
  }
}