用途別 · 個人
個人投資家・個人開発者が自分の分析に使う
要点
- check_circle社名から証券コードを探し、損益と配当の履歴をまとめて取得できます。
- check_circle?format=csv を付けると、Google スプレッドシートや Excel にそのまま読み込めます。
- check_circle自分の調査・分析に使うのは Free・Pro の範囲です。作ったツールを他人に公開する場合は Business プラン以上が必要です。
これまでと、ZENITH Code を使った場合
これまで
- remove決算短信の PDF や有価証券報告書を 1 社ずつ開き、数字を表計算に手で写していた。
- remove配当の履歴を集めて、連続増配の年数を自分で数えていた。
- remove社名から証券コードを調べるために、いくつものサイトを行き来していた。
ZENITH Code なら
- check_circle損益計算書を決算期ごとに 1 回の呼び出しで取得できます。各項目に出典(短信か有報か)が付きます。
- check_circle連続増配と連続非減配の年数を、分割調整後の年間配当から計算した値で受け取れます。
- check_circle社名の一部で検索して証券コードを調べ、そのまま次の呼び出しに使えます。
使うエンドポイント
まずはこの 5 本で、調べる・取り込む・絞り込むの一通りができます。
合うプランと表示できる範囲
自分の調査・分析・投資判断に使うのは「基本の利用」で、Free と Pro で使えます。月間トークンの量で選んでください。
| プラン | 月額 | 月間トークン | 第三者への表示(取引所データを除く) |
|---|---|---|---|
| Freeこの用途に合う | ¥0 | 5,000 | 不可(自分の調査・分析と、法人の場合は社内での利用に限る) |
| Proこの用途に合う | ¥6,980 | 100,000 | 不可(自分の調査・分析と、法人の場合は社内での利用に限る) |
| Business | ¥39,800 | 1,000,000 | 可(自社サービスでの表示、加工結果の提供、組織内での共有) |
| Enterprise | 個別見積 | 個別見積 | 可(自社サービスでの表示、加工結果の提供、組織内での共有) |
作ったスプレッドシートやツールを他人と共有・公開すると、第三者への提供になり Free・Pro では使えません。株価などの取引所データは、どのプランでも第三者に見せられません。
表示・提供できる範囲の正本は利用規約です。個別の使い方で迷うときは、使う前にお問い合わせください。 利用規約 第 8 条 · 料金プラン
コード例
保有銘柄の連続増配年数をまとめて確認する例です(Python)。cURL と Google Sheets のタブもあります。
curl -sG "https://api.zenithcode.net/stable/dividend-streaks" \ --data-urlencode "symbol=8113" \ -H "x-api-key: YOUR_API_KEY"
注意点
- error比率(ROE・配当利回りなど)は API では 0〜1 の小数です。0.0323 は 3.23% を意味します。
- error値が null の項目は「0」ではなく「未開示」または「計算できない」です。
- error株価・騰落率を取得するには、会員登録(ログイン)が必要です。
投資家・開発者向けの FAQ
プログラミングをしなくても使えますか?expand_more
使えます。Google スプレッドシートの Apps Script や Excel の Power Query に、各ドキュメントのコード例を貼り付けるだけで表に取り込めます。
Free プランで足りますか?expand_more
Free は月 5,000 トークンです。1 トークンのエンドポイントなら月 5,000 回まで呼べます。保有銘柄の確認程度なら足りることが多く、足りなければ Pro に上げられます。
作ったツールを友人に使ってもらえますか?expand_more
Free・Pro では、取得したデータを第三者が使える状態にできません。共有するなら Business プラン以上が必要です。
AI・研究者向けの FAQ
Claude などの AI に自分の分析を手伝わせられますか?expand_more
できます。MCP に対応した AI クライアントから 72 種類のツールで同じデータを使えます。自分が使う AI での利用は基本の利用に入ります。
データの時点はどう確かめますか?expand_more
/stable/system/freshness で、データセットごとの基準時刻と更新の遅れを確認できます。キーは不要で、トークンも消費しません。
損益の数字の出典は分かりますか?expand_more
income-statement の provenance に、出典(TDnet か EDINET)と書類の ID が入ります。
免責事項
このページは、日本株データ API の使い方とデータの定義を説明するものです。投資の勧誘や、特定の銘柄の売買の推奨を目的としたものではありません。内容は作成時点の情報で、正確性・完全性を保証しません。投資の判断はご自身の責任で行ってください。
取得したデータを第三者に表示・提供できる範囲は、プランと利用規約 第 8 条で決まります。株価などの取引所データは、どのプランでも第三者に表示できません。 利用規約 第 8 条 · データの出典と利用条件

