ドキュメント/Introduction
はじめに

Introduction.

Axiora is a verifiable financial-data API for Japanese listed companies. Every figure traces to a source filing, and every response can be frozen and replayed byte-for-byte.

Base URL
api.axiora.dev
API version
v1
Envelope
{ data, meta }

What is Axiora

11,000社以上の日本企業について、保有動向インテリジェンスと公式開示由来の企業データを提供します。すべてのエンドポイントは{ data, meta }エンベロープ形式のJSONを返します。

Numbers are lifted from schema-validated XBRL by deterministic code, never inferred by a model. Language (translations, naturalised entity names) is LLM-assisted, with the Japanese original always preserved. Every row carries the EDINET doc_id it came from, and the verifiability model explains exactly which layer produced each field.

レスポンスエンベロープ

すべての成功レスポンスは同じエンベロープでペイロードを包みます。一覧エンドポイントはmetaにページネーション情報を追加します。

単一リソースapplication/json
{
  "data": { "...": "resource fields" },
  "meta": {
    "request_id": "req_abc123",
    "data_as_of": "2026-05-12T03:25:11Z",
    "as_of": "6b6d7729-0e41-4e6c-94dc-33e584afaf0d",
    "computation_version": "2026.04.1",
    "ontology_version": "2.1.0",
    "caveats": ["..."]
  }
}

List endpoints return an array under data and add pagination fields (total, limit, offset, next_cursor) to meta.

Meta フィールド

フィールド説明
request_id
string
トレース・サポート用のリクエスト識別子 (例: req_abc123)。
data_as_of
string | null
開示原本の最終取り込み成功時刻。ISO 8601 タイムゾーン付き。未解決の場合は null。
as_of
string | null
不透明な凍結トークン。この値をコピーし、後日 `?as_of=<token>` として送信すれば、完全に同一の行が返ります。レスポンスがピン留め不可な場合は null。
computation_version
string
レスポンススキーマの公開互換性バージョン。破壊的変更時にバンプ。形式 YYYY.MM.N。完全な再現には `as_of` を使用してください。
ontology_version
string
フィールド・単位解釈レイヤーの SemVer。破壊的変更時にバンプ。完全な再現には `as_of` を使用してください。
caveats
string[] | null
レスポンスを正しく解釈するためのエンドポイント固有の注記。下記カタログの文字列のサブセット。該当なしの場合は null。
total
int | null
該当する全レコード件数 (リストエンドポイントのみ)。
limit
int | null
1ページあたりの最大レコード数。
offset
int | null
スキップされたレコード数 (オフセット式ページング)。
next_cursor
string | null
次ページの不透明カーソル (キーセット式ページング)。最終ページでは null。

Caveat カタログ

Caveat は meta.caveats に付与される、レスポンスの正しい解釈を補助するための公開メッセージです。エラーではありません。各エンドポイントは下記の文字列のうち該当するものだけを返します。

  • このレスポンスは加工済みの集計ビューであり、提出書類の生スナップショットではありません。情報の鮮度は meta.data_as_of、完全な再現は meta.as_of トークンをコピーして ?as_of=<token> で再送信してください。
  • 出典は TDNet (東京証券取引所) の 決算短信 であり、金融庁 EDINET ではありません。決算短信は対応する EDINET 有価証券報告書よりも数週間早く到着するため、鮮度は meta.data_as_of をご参照ください。
  • 英文社名は name_en_quality で 'verified' / 'derived' / 'machine' の信頼度タグが付与されます。'verified' と 'derived' は高信頼、'machine' はベストエフォートのためご利用前に確認を推奨します。
  • 1株あたりの値 (eps, bps, dps) は、当該レスポンスの meta.split_adjusted が true でない限り、提出書類の原値をそのまま反映します。株式分割を跨ぐ比較は調整が適用されている場合に限り可能です。
  • 複数の提出書類から集計された行のため、行ごとの doc_id は現在公開されていません。鮮度は meta.data_as_of をご参照ください。
  • すべての提出書類・セクションが翻訳済みではありません。text_en が null の行は未処理です。
  • 翻訳対象は東証プライム・スタンダード・グロース (内国株式) 上場の発行体に限定しています。REIT、資産運用ファンド、未上場子会社、個人投資家、その他普通株式以外の提出者の書類は翻訳されません ── 日本語の原文は sections エンドポイントで引き続き取得できます。
  • 一部のシグナル行は doc_id = null を持ちます ── 複数の提出書類にわたるパターンを集約したシグナルで、単一の発生元書類を特定できない場合です。直接の EDINET 引用が必要な場合は doc_id IS NOT NULL でフィルタしてください。

Coverage

Six classes, all derived from the same EDINET and TDNet filings. Each shares the response envelope and the same as_of replay contract.

ClassDescription
Financials
15 endpoints
Income statement, balance sheet, cash flow, and ratios, lifted from typed XBRL.
Translations
5 endpoints
JA→EN narrative sections; the Japanese source stays on the row.
Filings
3 endpoints
The raw EDINET document index: doc_id, doc_type, fiscal year, filed_at.
Ownership
20 endpoints
Large-shareholding trajectories, movers, and signals built from 大量保有報告書.
Governance
6 endpoints
Board composition, voting results, relationships, and subsidiaries.
Earnings
9 endpoints
決算短信 results, forecasts, and earnings signals from TDNet.

Surfaces

The same data over three surfaces. Pick the one your stack already talks to.

Building with an LLM? Point it at llms.txt for a map of these docs, or connect the MCP server directly.

Next steps