All APIsexpand_more

Earnings calendar

GET/stable/earnings-calendar1 tokens per call

Lists scheduled and already reported earnings dates for Japanese companies. Reported rows include actual and estimated EPS and the surprise rate (surpriseRate, a 0–1 decimal; 0.15 = 15% above the estimate). The range is at most 93 days and defaults to 30 days before and after today.

What you can do with this API

check_circleSee which companies report this week to plan trades
check_circleAdd earnings dates of your holdings to a calendar
check_circleFind the periods when earnings announcements cluster

Example URL

https://api.zenithcode.net/stable/earnings-calendar?from=2026-08-01&to=2026-09-15&limit=200

Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.

Parameters

Parameter	Required	Description	Example
`from` string	Optional	Start date (YYYY-MM-DD). Defaults to 30 days before today	`2026-08-01`
`to` string	Optional	End date (YYYY-MM-DD). Defaults to 30 days after today. At most 93 days after from	`2026-09-15`
`limit` number	Optional	Maximum number of rows to return (default 200, max 500)	`200`

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 Viewer

Response 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
`reportDate`	string
`fiscalDate`	string
`beforeAfterMarket`	string
`currency`	string
`actualEps`	number
`estimateEps`	number
`surpriseRate`EPS の予想との差（実績 ÷ 予想 − 1）。0〜1 の小数（0.15 = 予想を 15% 上回った、−0.2 = 20% 下回った）	number	EPS の予想との差（実績 ÷ 予想 − 1）。0〜1 の小数（0.15 = 予想を 15% 上回った、−0.2 = 20% 下回った）

Related APIs

Timely disclosure documents

/stable/disclosures

Earnings forecast (company guidance)New

/stable/earnings-forecast

Ex-dividend calendar

/stable/dividends-calendar

Corporate events feedNew

/stable/events-feed

FAQ

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.