TDnet解析ガイド：XBRLの数字を使うまでに確認すること

最初に仕組みを学びたい方には入門連載、既に目的が決まっている方にはAPIドキュメントを案内します。基礎の手順を整理したページで、全社対応の解析器を実装する手順ではありません。

「売上高が欲しい」だけでは、複数の候補が残ります。「対象会社の、当期1年間の、連結売上高の実績が欲しい」と書くと、選ぶための条件が見えてきます。

例えば、架空の青葉製作所について、当期実績100億円と次期予想110億円が見つかったとします。数字はどちらも売上高ですが、目的が当期実績なら100億円を選びます。110億円が新しい見通しでも、実績を置き換える値ではありません。

上の会社・日付・金額は説明用の架空例です。条件を書き出せない段階なら、先に決算短信の表題と見出しを確認します。APIを使う場合にも、この一文を用意しておくと引数や応答の読み間違いを減らせます。

TDnetは適時開示情報を伝える仕組みで、決算短信はそこで扱われる書類の一つです。XBRLは、報告内容を機械で扱えるように項目や条件を結び付ける形式です。「サイト」「書類」「データ形式」を分けて考えると整理しやすくなります。JPX：TDnet

PDFは人がレイアウトに沿って読むのに適しています。XBRLでは数値と条件を参照できます。ただし、PDFがあることと、欲しい内容がXBRLでタグ付けされていることは別です。対象範囲はJPXのXBRL仕様一覧で確認します。

EDINETの有価証券報告書は、事業やリスク、詳しい財務情報を読む際のもう一つの入口です。二つの仕組みの比較は、既存のTDnetとEDINETの違いで確認できます。

XBRLの一つの数値には、その意味を確認する参照先があります。コンテキストは対象や期間などの条件、ユニットは単位の定義です。タグ名だけで選ばず、参照先の内容を読みます。

例えば「四半期の値」と説明されていても、年度の開始から第2四半期末までの累計か、直近3か月の単独期間かは別です。タグの名前だけで判断せず、コンテキストの日付と資料の見出しを確認します。

数値を取り出した後にも、元の文字列、解釈した数値、表示単位を分けると確認しやすくなります。円から億円へ換算するのは表示の工程です。既に円へ戻した値を、もう一度百万円から円へ換算しないようにします。

新しい資料が見つかっても、古い数値を全て上書きしてよいとは限りません。予想の見直し、表題などの情報の訂正、財務数値の訂正は、別々に確認します。

TDnet APIの公開仕様では、開示番号、開示履歴番号、取扱属性が区別されています。これらは開示情報と履歴を調べる材料です。属性に訂正を表す値があるだけで、XBRL内の売上高まで変わったとは判断できません。JPX：TDnet API接続仕様書

今日の最新値を表示する画面と、過去のある日に利用できた情報を再現する分析では、必要な記録が違います。後者はpoint-in-timeの考え方を先に確認してください。後から判明した修正を、過去にも知っていた情報として混ぜないためです。

自分でXBRLファイルを読む方法に加え、ZENITH Codeで構造化されたデータを取得する方法があります。標準化済みの主要項目と、開示書類の科目の階層は用途が違います。

financial-facts は有価証券報告書のXBRLデータを調べる入口です。TDnetの全ての書類をそのまま返すAPIとして選ばないようにします。対象書類は各エンドポイントの説明を確認してください。

このページは選び方の案内なので、実企業の値やAPI応答を例示していません。データを取得する段階では、ドキュメントの引数と応答を確認し、まず一社・一期・一項目で元の意味を説明できるか確かめます。

以下は株式会社CrabgrassがQiitaで公開している連載です。概要からタグの確認へ順に進めます。

1. TDnet解析①：TDnet・決算短信・適時開示の基礎
2. EDINET解析①：有価証券報告書の役割
3. TDnet解析②：PDFとXBRL、コンテキストと単位
4. EDINET解析②：タグ・構造・表示階層

コードを動かす前に、「どのファイルを開き、何という文字を検索するか」を確認したい場合はTDnet解析②が入口になります。

• EDINET解析ガイド
• 財務データAPIの選び方

• 損益計算書APIの引数と応答
• 財務諸表の全科目と階層
• 会計基準による違い

私たち株式会社Crabgrassは、財務データAPI「ZENITH Code」を開発・提供しています。本記事は情報の読み方を説明するもので、特定の金融商品の売買を勧めるものではありません。