ドキュメントのメニューexpand_more
使い方
この API で、こんな画面が作れる
例には、同じ会社（株式会社Crabgrass）が運営する日本株分析サイト StockClub の実際の画面（2026 年 10 月 22 日撮影）と、ZENITH Code の dev 環境の実データを保存した応答例（2026-10-23 取得）から描いたミニ画面を使っています。StockClub の内部の作りではなく、同じ表示を ZENITH Code の API で作る方法の説明です。
1. 配当サマリーカード
StockClub の配当ページの上部にある「配当サマリー」。予想利回り・年間配当・配当性向・DOE・連続非減配年数を 1 枚のカードにまとめています。ZENITH Code では 4 本のエンドポイントを組み合わせると同じカードが作れます。
- 1/stable/dividends: dividendType が annual、forecastOrActual が forecast の行が今期予想の年間配当（1 株当たり・分割調整済み）です。
- 2/stable/key-metrics?period=annual: payoutRatio（配当性向）と doe（純資産配当率）は小数の比率で返ります（0.3218 = 32.18%）。
- 3/stable/dividend-streaks: consecutiveNonDecreaseYears が連続非減配年数、consecutiveIncreaseYears が連続増配年数です。
- 4予想配当利回りは /stable/profile の dividendYield（最新の終値から計算した値）を使います。
ZENITH Code の応答例から描画（トヨタ自動車）
トヨタ自動車（7203）の応答例から描画。配当利回りは株価から計算する値なので、この例では省いています。
const BASE = "https://api.zenithcode.net/stable";
const headers = { "x-api-key": process.env.ZENITH_API_KEY };
const get = (path) => fetch(BASE + path, { headers }).then((r) => r.json());
const [dividends, metrics, streaks] = await Promise.all([
get("/dividends?symbol=7203&limit=10"),
get("/key-metrics?symbol=7203&period=annual&limit=1"),
get("/dividend-streaks?symbol=7203"),
]);
const annualForecast = dividends.find(
(d) => d.dividendType === "annual" && d.forecastOrActual === "forecast",
)?.amount; // 100 (JPY)
const payoutRatio = metrics[0].payoutRatio; // 0.3218 -> 32.18%
const doe = metrics[0].doe; // 0.0327 -> 3.27%
const nonCutYears = streaks[0].consecutiveNonDecreaseYears; // 132. 配当の推移グラフ
年間配当を決算期ごとに並べた棒グラフ。/stable/dividend-streaks の years に、決算期ごとの年間配当（分割調整済み）と前年からの増減が入っているので、そのまま棒にできます。
トヨタ自動車（7203）の年間配当（円）
- 1symbol と limit（最大 25 期）を指定して呼びます。
- 2years の annualDividend を棒の高さに、change（increase・unchanged・decrease など）を色分けや注記に使います。
- 3matchesReported が true なら、年間配当から計算した連続年数が、データ基盤で別に集計した値と一致しています。
使うエンドポイント
curl "https://api.zenithcode.net/stable/dividend-streaks?symbol=7203&limit=10" \ -H "x-api-key: YOUR_API_KEY"
3. 損益計算書サマリー
StockClub の損益計算書ページの「PL サマリー」。売上高・純利益は直近 12 か月（TTM）、営業利益・EPS は四半期累計で、前年比も出しています。下には直近 5 期の業績推移と、会社予想に対する通期の進捗率が並びます。日本の決算短信の四半期の数値は期首からの累計なので、TTM は受け取った行から計算します。
- 1/stable/income-statement を period を付けずに呼ぶと、四半期（Q1〜Q3）と通期（FY）が新しい順に並びます。
- 2TTM = 直近の累計 ＋ 前期の通期 − 前年同期の累計。下のコードがその計算です。
- 3各行の provenance に出典（TDnet / EDINET の書類 ID と原本の URL）が付くので、画面から原本へリンクできます。
通期の業績（トヨタ自動車 7203、応答例から描画）
| 決算期 | 売上高 | 営業利益 | 純利益 |
|---|---|---|---|
| 2026-03 | 50.68兆円 | 3.77兆円 | 3.85兆円 |
| 2025-03 | 48.04兆円 | 4.80兆円 | 4.77兆円 |
| 2024-03 | 45.10兆円 | 5.35兆円 | 4.94兆円 |
出典: S100Y8NY EDINET の原本を開く →
// 四半期の累計値から直近 12 か月（TTM）を計算する
const rows = await get("/income-statement?symbol=7203&limit=12");
const latest = rows[0]; // e.g. 2026-06 Q1 (cumulative)
const lastFy = rows.find((r) => r.period === "FY"); // 2026-03 FY
const sameQPrevYear = rows.find(
(r) => r.period === latest.period && r.fiscalPeriod < latest.fiscalPeriod,
); // 2025-06 Q1
const ttmRevenue = latest.period === "FY"
? latest.revenue
: latest.revenue + lastFy.revenue - sameQPrevYear.revenue;4. 会社の配当方針（有報の本文）
StockClub の「会社の配当方針」は、有価証券報告書に書かれた方針をもとにしています。ZENITH Code の /stable/text-blocks は、有報の記述情報（事業の内容・事業等のリスク・MD&A・配当政策など）を目次と本文で返します。
- 1tag を付けずに呼ぶと目次（tag・見出し・文字数）が返ります。
- 2tag に dividend-policy や risks などの別名を指定すると、その節の本文がテキストで返ります（content=html なら HTML）。
- 3本文は長いことがあります（MD&A など）。画面では要約や見出しの抜き出しと組み合わせ、原本へのリンクを添えてください。
使うエンドポイント
curl "https://api.zenithcode.net/stable/text-blocks?symbol=7203" \ -H "x-api-key: YOUR_API_KEY" curl "https://api.zenithcode.net/stable/text-blocks?symbol=7203&tag=dividend-policy" \ -H "x-api-key: YOUR_API_KEY"
事業等のリスク（2026-03 期の有報。応答例から抜粋）
本文 17,543 文字
３ 【事業等のリスク】 以下において、トヨタの事業その他のリスクについて、投資家の判断に重要な影響を及ぼす可能性のある事項を記載しています。ただし、以下はトヨタに関するすべてのリスクを網羅したものではなく、記載されたリスク以外のリスクも存在します。かかるリスク要因のいずれによっても、投資家の判断に影響を及ぼす可能性があります。 本項においては、将来に関する事項が含まれていますが、当該事項は有価証券報告書提出日（2026年６月10日）現在…
EDINET の原本を開く →5. 企業プロフィールカード
銘柄ページの上部に置く会社の基本情報カード。/stable/profile は日英の社名・業種・市場・代表者・所在地・従業員数・事業の説明をまとめて返します。
トヨタ自動車
TOYOTA MOTOR CORPORATION
- 市場
- Tokyo Stock Exchange Prime Market
- 代表者
- 取締役副社長 宮崎洋一
- 所在地
- 愛知県豊田市トヨタ町1番地
- 従業員数
- 390,927
トヨタ自動車は、自動車事業を中心に金融事業とその他の事業を行い、2026年3月31日現在、子会社602社、関連会社および共同支配企業159社で構成される。2026年3月期の売上は、自動車89.2%、金融9.5%、その他1.3%の構成である。自動車事業は、セダン、ミニバン、コンパクト、SUV、トラック等の自動車と関連部品…
- 1sector は東証 33 業種のコードです。/stable/available-sectors で日本語・英語の業種名に変えます。
- 2nameJa / nameEn、descriptionJa / descriptionEn の両方が入るので、表示言語に合わせて選べます。
- 3応答には最新の株価・時価総額・PER なども入りますが、このカードでは使っていません。株価を画面に出す場合は利用規約の条件を確認してください。
使うエンドポイント
curl "https://api.zenithcode.net/stable/profile?symbol=7203" \ -H "x-api-key: YOUR_API_KEY"
7. 条件で絞った銘柄リスト
StockClub の「DOE 配当比較」や「資本効率ランキング」のような、条件で絞って並べた銘柄の一覧。よく使う条件は /stable/screener-presets のプリセットで、細かい条件は /stable/screener で組み合わせます。
- 1preset には high-dividend・value・high-roe・growth・dividend-growth・momentum があり、1 回の呼び出しで並び替え済みの一覧が返ります（時価総額 50 億円以上の株式が対象）。
- 2/stable/screener では roeMoreThan=0.1（ROE 10% 以上）のように比率を小数で指定し、sortBy で並べ替えます。
- 3一覧は毎日夕方に作り直すスナップショット（月〜土 16:45 / 19:45 JST）から返るので、全銘柄が対象でもすぐに返ります。
curl "https://api.zenithcode.net/stable/screener-presets?preset=high-dividend&limit=20" \ -H "x-api-key: YOUR_API_KEY" curl "https://api.zenithcode.net/stable/screener?roeMoreThan=0.1÷ndYieldMoreThan=0.03&sortBy=dividendYield&limit=20" \ -H "x-api-key: YOUR_API_KEY"
高配当プリセットの上位 5 銘柄（応答例から描画）
| コード | 銘柄 | 業種 | ROE | 配当利回り |
|---|---|---|---|---|
| 6191 | エアトリ | サービス業 | 12.3% | 11.1% |
| 8747 | 豊トラスティ証券 | 証券、商品先物取引業 | 27.7% | 10.3% |
| 4716 | 日本オラクル | 情報・通信業 | 34.5% | 8.4% |
ROE と配当利回りは小数の比率で返ります。この例では株価の列は表示していません。
画面に出すときの決まり
利用規約 第 8 条により、ZENITH Code のデータを自社のサービスで表示したり、加工した結果（指標・チャート・スクリーニング結果など）をエンドユーザーに提供したりできます。その際は出典（例: Data provided by ZENITH Code）を表示し、正確性を保証しないこと・投資助言ではないことを明示してください。データそのものの再配信・再販売はできません。
利用規約 第 8 条を読む →