用途別 · 事業者
投資アプリ・フィンテック企業が自社サービスに組み込む
要点
- check_circle決算短信(速報)と有価証券報告書(確報)を統合した財務データを、項目ごとの出典つきで取得できます。
- check_circleBusiness プラン以上なら、データや加工した結果(指標・チャート・スクリーニング結果など)を自社サービスの利用者に表示できます。
- check_circle株価・騰落率と、TDnet の開示書類そのもの(PDF・本文・リンク)は、利用者に表示できません。
これまでと、ZENITH Code を使った場合
これまで
- remove開示書類から数値を取り出す仕組みを自社で作り、書式の変更や訂正への対応を続けていた。
- remove会計基準(日本基準・IFRS・米国基準)の違いで、同じ項目が別の名前になるのを吸収していた。
- remove業種平均などの集計を、自社で計算し直していた。
ZENITH Code なら
- check_circle損益・貸借対照表・キャッシュフローを、会計基準をそろえた項目名で受け取れます。
- check_circle適時開示は 16:30、EDINET は 19:00(日本時間)を目安に反映し、データの鮮度は API で確認できます。
- check_circle業種の中央値・四分位や同業比較が、計算済みの集計値として返ります。
使うエンドポイント
企業ページ・配当ページ・ニュース欄・同業比較の画面を作るときの組み合わせです。
- GET
/stable/income-statement損益計算書業績の推移(短信と有報を統合、出典つき)1 回 1 トークン - GET
/stable/key-metrics主要財務指標(期ごと)ROE・利益率・配当性向などの指標1 回 1 トークン - GET
/stable/dividends配当履歴配当の履歴と予想1 回 1 トークン - GET
/stable/events-feed企業イベントの統合フィード増減配・分割・臨時報告書などのイベント欄(TDnet の書類へのリンクは表示不可)1 回 10 トークン - GET
/stable/peers同業他社との比較同業他社との比較表1 回 10 トークン - GET
/stable/industry-benchmarks業種別の指標の中央値と四分位業種の中央値・四分位1 回 10 トークン
合うプランと表示できる範囲
自社サービスの利用者にデータを表示するには、Business プラン以上の契約が必要です。
| プラン | 月額 | 月間トークン | 第三者への表示(取引所データを除く) |
|---|---|---|---|
| Free | ¥0 | 5,000 | 不可(自分の調査・分析と、法人の場合は社内での利用に限る) |
| Pro | ¥6,980 | 100,000 | 不可(自分の調査・分析と、法人の場合は社内での利用に限る) |
| Businessこの用途に合う | ¥39,800 | 1,000,000 | 可(自社サービスでの表示、加工結果の提供、組織内での共有) |
| Enterpriseこの用途に合う | 個別見積 | 個別見積 | 可(自社サービスでの表示、加工結果の提供、組織内での共有) |
Business プランでも、株価・株価と同じ単位の値(四本値・移動平均・騰落率など)と、TDnet の開示書類そのもの(PDF・本文・リンク)は表示できません。データそのものを API・ファイル・データフィードとして再配信することも、事前の書面の承諾が必要です。
表示・提供できる範囲の正本は利用規約です。個別の使い方で迷うときは、使う前にお問い合わせください。 利用規約 第 8 条 · 料金プラン
コード例
サーバー側で損益と指標をまとめて取得し、画面用の形にする例です(JavaScript)。API キーはブラウザに渡さないでください。
curl -sG "https://api.zenithcode.net/stable/income-statement" \ --data-urlencode "symbol=7203" \ --data-urlencode "period=annual" \ --data-urlencode "limit=5" \ -H "x-api-key: YOUR_API_KEY"
注意点
- errorevents-feed の url のうち、適時開示(type=disclosure)のものは TDnet の書類(PDF)へのリンクで、取引所データに当たるため利用者に表示できません(リンクが付くのは発表から 30 日以内の日本語の書類だけで、それ以外は null)。臨時報告書(type=extraordinary)の url は EDINET の書類で、Business プラン以上なら表示できます。
- errordividend-changes の closePrice(利回りの計算に使った終値)も取引所データです。
- errorAPI キーはサーバー側だけで使い、ブラウザのコードに含めないでください。
投資家・開発者向けの FAQ
PER や配当利回りをアプリに表示できますか?expand_more
Business プラン以上なら表示できます。ZENITH Code が株価と財務数値から計算した評価指標は、取引所データに含まれません。
株価チャートを表示できますか?expand_more
できません。株価と株価と同じ単位の値は取引所データで、どのプランでも第三者に表示できません。
大量に呼び出しても大丈夫ですか?expand_more
Business は月 1,000,000 トークン、毎分 300 リクエストです。それを超える場合は Enterprise をご相談ください。
AI・研究者向けの FAQ
アプリ内の AI アシスタントに使わせられますか?expand_more
Business プラン以上なら、利用者の求めに応じて AI エージェント等に本データを参照させることができます。取引所データを AI の応答として利用者に出すことはできません。
数値の出典を画面に出せますか?expand_more
income-statement などの provenance に出典(TDnet・EDINET)と書類の ID が入ります。出典の表示は利用規約の範囲で行ってください。
データの更新が遅れたことを検知できますか?expand_more
/stable/system/freshness の stale が true のデータセットは、予定の時刻を過ぎても更新されていません。監視に組み込めます。
免責事項
このページは、日本株データ API の使い方とデータの定義を説明するものです。投資の勧誘や、特定の銘柄の売買の推奨を目的としたものではありません。内容は作成時点の情報で、正確性・完全性を保証しません。投資の判断はご自身の責任で行ってください。
取得したデータを第三者に表示・提供できる範囲は、プランと利用規約 第 8 条で決まります。株価などの取引所データは、どのプランでも第三者に表示できません。 利用規約 第 8 条 · データの出典と利用条件

