--- search: tags: - indicators - GET seo: description: >- 上場法人の計算済み財務指標の年次時系列 (最大 30 期, asof 起点) を返す。 Reference for the GET /indicators endpoint in the IRBANK API API. sidebar: badge: GET label: 計算済み財務指標の時系列 title: 計算済み財務指標の時系列 type: openapi-operation --- 上場法人の計算済み財務指標の年次時系列 (最大 30 期, `as_of` 起点) を返す。 ## 対象の指定 - `edinet_code` または `security_code` のどちらか一方を指定する。 - `security_code` は法人の主たる上場銘柄 (本体株式・4 桁) のみ指定可。法人の主たる EDINET 提出者へ解決して返す (レスポンスの `edinet_code` に解決結果を含む)。 ## 返す項目 営業利益率・ROA・ROE・PER・自己資本比率・配当性向・流動比率・回転率・成長率・連続増配年数・業績予想修正統計など、財務指標 175 項目を提供する (`/financials` が財務諸表の報告値そのもの、本エンドポイントが指標という分担)。 - 大半は有価証券報告書等の報告値から算出した計算値だが、ROE・PER・自己資本比率・配当性向・BPS・DPS のように提出書類に指標として記載される項目は報告値をそのまま返す (計算値と併存する項目は `roe` / `roe_computed` のようにキーで区別でき、算出方法の違いにより両者は一致しない)。 - 値は上流の計算結果・報告値をそのまま返し (as-computed / as-reported)、分母が小さい企業では比率が極端な値になりうる。 - 値が無い項目は null (当該法人・業種で非対象、未開示、上流で算出不能のいずれも含む)。0 とは区別され、null は「値が存在しない」ことを表す。 ## 単位 - 各指標の単位・分析カテゴリはレスポンスの `fields[].unit` / `fields[].category` に機械可読で付与 (self-describing)。 - 比率系は原則 % 値 (例: 7.4 = 7.4%)。ただし報告値の `equity_ratio`・`payout_ratio` のみ生比率 (例: 0.5 = 50%、`fields[].unit` は `ratio`) で、% 値が必要な場合は `equity_ratio_computed` を使う。 - 金額系のうち集計額の `net_debt`・`total_dividends` は円 (`jpy`, 整数)、従業員 1 人当たり系は円 (`jpy`)、1 株当たり系は円/株。 ## 対象期間 - 提供は年次のみ (四半期は将来拡張予定)。 - 返すのは決算期末が到来済みの期のみで、進行中の年度 (決算期末が未到来) は含まない (業績予想の修正統計は進行中年度についても算出されるが、その期は他の指標がすべて null になり `years` の枠を消費するため対象外としている)。 - ある期の指標が適時開示 (TDnet) の 24 時間以内で再配信できない場合、その期の当該指標は null になり、期内の全指標が非表示になるとその期は `periods` 自体から除かれる。 ## 期ラベル (`is_consolidated` / `accounting_standard`) いずれも期単位の要約で、値の採用は項目ごとの連結優先・会計基準優先フォールバックのため、期ラベルと逆スコープ・異基準で採用された項目キーは各期の `scope_exceptions` / `standard_exceptions` に列挙される (空配列なら全項目が期ラベルと同一)。 ## 空レスポンス 該当データが 0 件のときは空配列とともに reason (code=no_results + 状況の説明) を返す。