ドキュメントのメニューexpand_more
Cookbook
レシピ集：よくある作業を短いコードで
よくある作業を、コピーしてそのまま動く短いコードにまとめました。curl・Python・JavaScript と、向いている作業には Google Apps Script も載せています。
要点
- check_circle各レシピは、使うエンドポイント → コード → コードの説明 → 注意点 → FAQ の順です。
- check_circleコードの YOUR_API_KEY を、ダッシュボードで発行したキーに置き換えるだけで動きます。
- check_circle画面つきの完成形の例は「使い方」のページ、各エンドポイントの詳細は API リファレンスにあります。
レシピの一覧
- search社名から証券コードを探す社名の一部で検索して、証券コードと日英の社名を取得します。/search-name
- bar_chart配当の推移をグラフにする決算期ごとの年間配当と連続増配年数を取得し、棒グラフにします。/dividend-streaks /dividends
- functions直近 12 か月（TTM）の売上高を計算する期首からの累計で返る四半期の売上高から、直近 12 か月の合計を計算します。/income-statement /key-metrics
- notifications増配・減配を毎日拾う市場全体のイベントから増配・減配を拾い、スプレッドシートに毎日追記します。/events-feed /dividend-changes
- event決算発表の予定を一覧にする今後 2 週間の決算発表の予定を取得し、保有銘柄だけを抜き出します。/earnings-calendar
- table_viewGoogle スプレッドシートに書き出す?format=csv で受け取り、Apps Script で毎日シートを更新します。Excel の Power Query もあります。/industry-benchmarks
- compare_arrows同じ業種の会社を比べる対象の会社と、同じ業種で時価総額が近い会社・業種中央値を 1 つの表にします。/peers /industry-benchmarks
- groups大量保有の変化を追う大量保有報告書を提出のたびに取得し、保有割合の変化を一覧にします。/large-holding-reports /large-holders
- account_tree財務諸表の全科目を階層で読む開示された書類の全科目を、親子関係のまま字下げして表示します。/financial-statement-full /financial-facts
すべてのレシピに共通すること
どのレシピも、次の決まりの上で動きます。
- ベース URL
- https://api.zenithcode.net/stable
- 認証
- x-api-key ヘッダーに API キーを入れます（Authorization: Bearer も可）。URL の ?apikey= は使えません。
- 応答の形
- ほとんどのエンドポイントは JSON の配列を返します。?format=csv を付けると同じ行を CSV で返します。
- 単位
- 金額は円、比率は 0〜1 の小数（0.0323 = 3.23%）、倍率は倍です。null は「0」ではなく「未開示」または「計算できない」です。
- トークン
- エンドポイントごとに 1 回の消費量が決まっています。各レシピの「使うエンドポイント」に書いてあります。
投資家・開発者向けの FAQ
コードはそのまま動きますか？expand_more
YOUR_API_KEY を自分のキーに置き換えれば動きます。Python は requests（グラフや表には matplotlib・pandas）、JavaScript はブラウザか Node.js 18 以降の fetch を使います。
プログラミングをしない場合は？expand_more
Google Apps Script のタブのコードを、スプレッドシートの 拡張機能 > Apps Script に貼り付けて使えます。
Free プランで試せますか？expand_more
試せます。Free は月 5,000 トークンです。各レシピの消費トークンを確かめてください。
AI・研究者向けの FAQ
AI エージェントに同じ作業をさせられますか？expand_more
MCP に対応した AI クライアントなら、同じエンドポイントを呼ぶツールで同じ作業ができます。手順の確認にこのレシピを使えます。
コード例のエンドポイントと引数は正しいですか？expand_more
公開している API のカタログ（OpenAPI から生成）で確かめたパスと引数だけを使っています。
取得したデータを他人に見せてもよいですか？expand_more
プランと利用規約 第 8 条によります。Free・Pro は自分（法人は社内）での利用に限られ、株価などの取引所データはどのプランでも第三者に見せられません。
gavel
免責事項
このページは、日本株データ API の使い方とデータの定義を説明するものです。投資の勧誘や、特定の銘柄の売買の推奨を目的としたものではありません。内容は作成時点の情報で、正確性・完全性を保証しません。投資の判断はご自身の責任で行ってください。
取得したデータを第三者に表示・提供できる範囲は、プランと利用規約 第 8 条で決まります。株価などの取引所データは、どのプランでも第三者に表示できません。 利用規約 第 8 条 · データの出典と利用条件