All APIsexpand_more
Earnings forecast (company guidance)
GET
/stable/earnings-forecast1 tokens per callNewReturns the company guidance published in each earnings release (revenue, operating income, net income and EPS), with implied margins, growth versus the full-year actual, and forecast-based PER, ROE, ROA, PSR and PEG. A fiscal-year (FY) row carries guidance for the next fiscal year, while Q1–Q3 rows carry the full-year guidance for the current year; forecastTarget tells which. Withheld ("undetermined") guidance is null, and periods without guidance are omitted. Amounts are in JPY and ratios are 0–1 decimals.
What you can do with this API
- check_circleSee how the company expects profit for this and next year
- check_circleJudge valuation using forecast-based PER
- check_circleTrack how guidance changed from one release to the next
Example URL
https://api.zenithcode.net/stable/earnings-forecast?symbol=7203&period=annual&limit=10Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
symbolstring | Required | Securities code (4 characters, e.g. 7203 = Toyota Motor; alphanumeric codes such as 130A also work) | 7203 |
periodselect | Optional | Period type: annual = FY rows only, quarter = quarter rows only. Q1, Q2, Q3, Q4 or FY also work. Omit for all Allowed values: Q1, Q2, Q3, Q4, FY, annual, quarter | annual |
limitnumber | Optional | Maximum number of rows to return (default 10, max 40) | 10 |
Try it
Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 1 tokens.
travel_exploreTry in the API ViewerResponse example (real data)
lock
Live response examples are shown to signed-in users only (they include exchange data such as stock prices). Sign in to view
Response fields
symbol | string | |
fiscalPeriodfiscalPeriod is the period-end month (YYYY-MM), and period is Q1–Q3 or FY (full year). Q2 and Q3 income and cash-flow values are cumulative from the start of the fiscal year; single-quarter values are not returned. | string | fiscalPeriod is the period-end month (YYYY-MM), and period is Q1–Q3 or FY (full year). Q2 and Q3 income and cash-flow values are cumulative from the start of the fiscal year; single-quarter values are not returned.How it is calculated → |
periodfiscalPeriod is the period-end month (YYYY-MM), and period is Q1–Q3 or FY (full year). Q2 and Q3 income and cash-flow values are cumulative from the start of the fiscal year; single-quarter values are not returned. | string | fiscalPeriod is the period-end month (YYYY-MM), and period is Q1–Q3 or FY (full year). Q2 and Q3 income and cash-flow values are cumulative from the start of the fiscal year; single-quarter values are not returned.How it is calculated → |
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株当たり当期純利益予想（円） |
operatingMarginForecastThe API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue. | number | The API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue.How it is calculated → |
netMarginForecastThe API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue. | number | The API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue.How it is calculated → |
revenueGrowthVsActualThe API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue. | number | The API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue.How it is calculated → |
operatingIncomeGrowthVsActualThe API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue. | number | The API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue.How it is calculated → |
netIncomeGrowthVsActualThe API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue. | number | The API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue.How it is calculated → |
epsGrowthVsActualThe API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue. | number | The API computes how much the company forecast grows from the latest full-year actual, and forecast profit as a share of forecast revenue.How it is calculated → |
payoutRatioForecastDPS divided by split-adjusted EPS: 0.3218 in the API is 32.18% on screen. payoutRatioForecast uses the company’s forecast EPS. | number | DPS divided by split-adjusted EPS: 0.3218 in the API is 32.18% on screen. payoutRatioForecast uses the company’s forecast EPS.How it is calculated → |
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（倍） |
pegRatioForecastPER divided by EPS growth expressed as a percentage number. pegRatioForecast divides forward PER by forecast EPS growth. | number | PER divided by EPS growth expressed as a percentage number. pegRatioForecast divides forward PER by forecast EPS growth.How it is calculated → |
Related APIs
FAQ
Why is a forecast null?expand_more
The company announced it as "undetermined". Periods with no guidance at all are left out as rows.
How many tokens does one call use?expand_more
1 tokens per call, regardless of how many rows come back. Your monthly allowance depends on your plan.
Do I need an account to try it?expand_more
Use the API Viewer to run it with your own parameters. Sign up for free and sign in (no credit card). Each run uses this API's tokens.
Can I get CSV instead of JSON?expand_more
Add format=csv to the URL to get CSV, ready for spreadsheets or pandas.
Can I get labels in English?expand_more
With neither lang nor Accept-Language, labels such as sector names are returned in English; add lang=ja or send Accept-Language: ja for Japanese. Company and sector names are always returned in both languages as nameJa / nameEn and sectorJa / sectorEn. Field names are the same in both languages.