すべての APIexpand_more
業績予想（会社予想）
GET
/stable/earnings-forecast1 回 1 トークン新着決算短信に載る会社の業績予想（売上高・営業利益・純利益・EPS）と、予想利益率、通期実績に対する伸び率、予想ベースの PER・ROE・ROA・PSR・PEG を返します。通期（FY）の行は来期の予想、第 1〜3 四半期の行は今期の通期予想で、どちらかは forecastTarget で分かります。「未定」の予想は null で、予想が出ていない期は含まれません。金額は円、比率は 0〜1 の小数です。
この API でできること
- check_circle会社が今期・来期の利益をどう見ているかを確認する
- check_circle予想ベースの PER から割安かどうかを判断する
- check_circle期ごとに予想がどう修正されたかを追う
例の URL
https://api.zenithcode.net/stable/earnings-forecast?symbol=7203&period=annual&limit=10読みやすいように符号化せずに表示しています。日本語などの値は、送るときに自動で符号化されます。
パラメータ
| 引数 | 必須 | 説明 | 例 |
|---|---|---|---|
symbolstring | 必須 | 証券コード（4 桁。例: 7203 = トヨタ自動車。130A のような英字入りも可） | 7203 |
periodselect | 任意 | 期間の種類。annual = 通期（FY）の行だけ、quarter = 四半期の行だけ。Q1・Q2・Q3・Q4・FY の個別指定も可。省略するとすべて 選べる値: Q1, Q2, Q3, Q4, FY, annual, quarter | annual |
limitnumber | 任意 | 返す件数の上限（既定 10、最大 40） | 10 |
試してみる
自分の条件で実行して、応答を表・JSON・CSV で確かめられます。ログインが必要で、実行するたびに 1 トークンを使います。
travel_exploreAPI ビューワーで試す応答の例（実データ）
lock
実データの応答例は、ログインした方だけに表示しています（株価などの取引所データを含むため）。 ログインして見る
レスポンス項目
symbol | string | |
fiscalPeriod予想を公表した短信の決算期（四半期末月 YYYY-MM） | string | 予想を公表した短信の決算期（四半期末月 YYYY-MM）計算方法 → |
periodQ1 | Q2 | Q3 | FY | string | Q1 | Q2 | Q3 | FY計算方法 → |
forecastTargetnext-fiscal-year=来期の通期予想（FY 行） / current-fiscal-year=今期の通期予想（Q1〜Q3 行） | string | next-fiscal-year=来期の通期予想（FY 行） / current-fiscal-year=今期の通期予想（Q1〜Q3 行） |
forecastFiscalPeriod予想の対象期末（YYYY-MM）。FY 行は決算期の 12 か月後、四半期行は null | string | 予想の対象期末（YYYY-MM）。FY 行は決算期の 12 か月後、四半期行は null |
accountingStandard | string | |
announcedAt短信の開示日（出典情報から） | string | 短信の開示日（出典情報から） |
docId出典の短信の書類ID | string | 出典の短信の書類ID |
source出典の種類（tdnet / edinet）。出典が分からない期は null | string | 出典の種類（tdnet / edinet）。出典が分からない期は null |
sourceUrl公式の閲覧リンク（EDINET は閲覧期間内だけ。TDnet は null） | string | 公式の閲覧リンク（EDINET は閲覧期間内だけ。TDnet は null） |
archiveUrlZENITH Code の配信経路の PDF（/stable/filing-document。API キーが要る） | string | ZENITH Code の配信経路の PDF（/stable/filing-document。API キーが要る） |
revenueForecast売上高予想（円） | number | 売上高予想（円） |
operatingIncomeForecast営業利益予想（円） | number | 営業利益予想（円） |
netIncomeForecast当期純利益予想（円） | number | 当期純利益予想（円） |
epsForecast1株当たり当期純利益予想（円） | number | 1株当たり当期純利益予想（円） |
operatingMarginForecast営業利益予想 ÷ 売上高予想。0〜1 の小数（0.12 = 12%） | number | 営業利益予想 ÷ 売上高予想。0〜1 の小数（0.12 = 12%）計算方法 → |
netMarginForecast純利益予想 ÷ 売上高予想。0〜1 の小数（0.12 = 12%） | number | 純利益予想 ÷ 売上高予想。0〜1 の小数（0.12 = 12%）計算方法 → |
revenueGrowthVsActual売上高予想 ÷ 同じ行の通期実績 − 1（FY 行のみ）。0〜1 の小数（0.12 = 12%） | number | 売上高予想 ÷ 同じ行の通期実績 − 1（FY 行のみ）。0〜1 の小数（0.12 = 12%）計算方法 → |
operatingIncomeGrowthVsActual営業利益予想 ÷ 同じ行の通期実績 − 1（FY 行のみ。実績が 0 以下なら null）。0〜1 の小数（0.12 = 12%） | number | 営業利益予想 ÷ 同じ行の通期実績 − 1（FY 行のみ。実績が 0 以下なら null）。0〜1 の小数（0.12 = 12%）計算方法 → |
netIncomeGrowthVsActual純利益予想 ÷ 同じ行の通期実績 − 1（FY 行のみ。実績が 0 以下なら null）。0〜1 の小数（0.12 = 12%） | number | 純利益予想 ÷ 同じ行の通期実績 − 1（FY 行のみ。実績が 0 以下なら null）。0〜1 の小数（0.12 = 12%）計算方法 → |
epsGrowthVsActualEPS 予想 ÷ 同じ行の EPS 実績 − 1（FY 行のみ。実績が 0 以下なら null）。0〜1 の小数（0.12 = 12%） | number | EPS 予想 ÷ 同じ行の EPS 実績 − 1（FY 行のみ。実績が 0 以下なら null）。0〜1 の小数（0.12 = 12%）計算方法 → |
payoutRatioForecast配当性向予想。0〜1 の小数（0.12 = 12%） | number | 配当性向予想。0〜1 の小数（0.12 = 12%）計算方法 → |
perForecast予想 EPS ベースの PER（倍） | number | 予想 EPS ベースの PER（倍） |
roeForecast予想 ROE。0〜1 の小数（0.12 = 12%） | number | 予想 ROE。0〜1 の小数（0.12 = 12%） |
roaForecast予想 ROA。0〜1 の小数（0.12 = 12%） | number | 予想 ROA。0〜1 の小数（0.12 = 12%） |
psrForecast予想売上ベースの PSR（倍） | number | 予想売上ベースの PSR（倍） |
pegRatioForecast予想 PEG レシオ | number | 予想 PEG レシオ計算方法 → |
関連する API
よくある質問
予想が null になるのはなぜですか？expand_more
会社が「未定」として発表した場合です。予想そのものが無い期は、行として含まれません。
1 回の呼び出しでトークンをいくつ使いますか？expand_more
1 トークンです。件数や期間によらず、1 回の呼び出しごとに同じ数を使います。月の上限はプランによって決まります。
試すのに登録は必要ですか？expand_more
API ビューワーで、自分の条件で実行して応答を確かめられます。無料登録してログインしてください（クレジットカード不要）。実行するたびに、この API のトークンを使います。
CSV で受け取れますか？expand_more
URL に format=csv を付けると CSV で返ります。表計算ソフトや pandas にそのまま読み込めます。
英語で受け取れますか？expand_more
lang も Accept-Language も無いと、業種名などの label は英語で返ります。日本語にするには lang=ja を付けるか、Accept-Language: ja を送ります。企業名・業種名は nameJa / nameEn、sectorJa / sectorEn のように両方の項目で常に返ります。項目名は日英とも同じです。