search
API Specification(Japanese)J-Quants Pro Website

Earnings Announcement Dates & Times (/fins/earnings_announcement_dates_times)

You can obtain the scheduled dates of earnings announcements reported to the TSE by TSE-listed companies, as well as the predicted times calculated by JPX Market Innovation & Research.

hashtag
Overview

This dataset provides the earnings announcement dates reported to the TSE by listed companies as of the day before the data is delivered. It also includes predicted earnings announcement times, which are calculated by JPX Market Innovation & Research using a proprietary model based on historical earnings announcement times.

hashtag
Attention

circle-info

  • Earnings Announcement Dates

    • These are the earnings announcement dates reported to the TSE by listed companies as of the day before the data provision date.

    • When a listed company reports a change to its earnings announcement date, the previous data is not deleted; instead, the revised earnings announcement date is added as new data.

    • Listed companies may report their earnings announcement date as "undecided."

  • Predicted Earnings Announcement Times

    • These are predicted earnings announcement times calculated by JPX Market Innovation & Research using a proprietary model based on past earnings announcement times.

    • Predicted earnings announcement times are not necessarily published for all issues or all earnings periods.

    • There may be cases where a scheduled earnings announcement date without a predicted earnings announcement time is published first, and then a new record containing the predicted earnings announcement time is distributed later.

    • Predicted earnings announcement times are distributed only for issues for which a scheduled earnings announcement date has been reported at least once. Even if the scheduled earnings announcement date is later changed to "undecided" by the listed company, any predicted earnings announcement time that has already been distributed will remain unchanged.

circle-exclamation

  • Predicted earnings announcement times are calculated by JPX Market Innovation & Research using a proprietary model based on past earnings announcement times. They are not information reported to the TSE by TSE-listed companies. Predicted earnings announcement times calculated by the model may not necessarily match the actual earnings announcement times. Please use this information with full understanding and acknowledgement of its content and nature.

  • In accordance with the TSE market restructuring in April 2022, the Bank of Japan (code: 83010) and Shinkin Central Bank (code: 84210) no longer belong to any market divisions under the system, but J-Quants handles them as "Standard".

hashtag
Parameter and Response

One of the parameters must be specified to obtain data. The combination of each parameter and the results of the response are as below.

publication_date
scheduled_date
code
Result

Data for the specified issue and publication date (scheduled earnings announcement date and predicted earnings announcement time).

Data for the specified issue and earnings announcement date.

Data for all distributed issues with the specified publication date (earnings announcement date and predicted earnings announcement time).

Data for all distributed issues where the earnings announcement date occurs on or after the data acquisition date.

Data for the specified issue.

Data for all distributed issues where the earnings announcement date occurs on or including and after the data provision date.

hashtag
Get Earnings Announcement Dates & Times Data

GET https://api.jquants-pro.com/v2/fins/earnings_announcement_dates_times

One of the parameters must be specified to obtain data.

"*" is a mandatory item.

hashtag
Query Parameters

Name
Type
Description

publication_date

String

Specification of the publication date of the earnings announcement date and the predicted earnings announcement time

(e.g. 20240301 or 2024-03-01)

scheduled_date

String

Specification of the earnings announcement date

(e.g. 20240301 or 2024-03-01)

code

String

issue code

(e.g. 86970)

pagination_key

String

String specifying the start of the search

Set the pagination_key returned by a previous search

hashtag
Headers

Name
Type
Description

Authorization*

String

Access key

hashtag
Data Item

Variable Name
Description
Type
Remark

PublicationDate

Date (publication date of earnings announcement date or publication date of predicted earnings announcement time)

String

YYYY-MM-DD

ScheduledDate

Date (scheduled earnings announcement date)

String

YYYY-MM-DD null (when a listed company reports the earnings announcement date as undecided)

TimePredicted

Predicted earnings announcement time

String

HH:MM (JST, rounded down to 30-minute intervals. e.g., "15:00" indicates that the earnings announcement is predicted to occur between 15:00-15:29) null: Prediction not published * 1

SessionPredicted

Predicted earnings announcement time session

String

1: JST00:00 to before morning session start 2: During morning session 3: After morning session to before afternoon session start 4: During afternoon session 5: After afternoon session to JST24:00 null: Prediction not published * 1

TimePredictedConfidenceScore

Confidence score of the predicted earnings announcement time

String

1 / 2 / 3 / 4 / 5 (5 is the highest confidence, 1 is the lowest) null: Prediction not published * 1

SessionPredictedConfidenceScore

Confidence score of the predicted earnings announcement time session

String

1 / 2 / 3 / 4 / 5 (5 is the highest confidence, 1 is the lowest) null: Prediction not published * 1

FiscalQuarterName

Fiscal quarter name

String

1Q / 2Q / 3Q / FY

FiscalYearEnd

Fiscal year end date

String

MMDD

Code

Stock code

String

5-digit code

PublicationType

Publication type of the record

String

Publication type of each record (see table below) 1: Earnings announcement date newly published. Predicted earnings announcement time not published 2: Both earnings announcement date and predicted earnings announcement time newly published 3: No change in earnings announcement date, predicted earnings announcement time newly published 4: Only earnings announcement date changed, predicted earnings announcement time not published or no change 5: Earnings announcement date changed and predicted earnings announcement time newly published

CompanyName

Company name

String

* 2

CompanyNameEnglish

Company name (English)

String

* 2

Sector17Code

17-Sector code

String

See 17-sector code and name * 2

Sector33Code

33-Sector code

String

See 33-sector code and name * 2

ScaleCategory

TOPIX Scale category

String

See Scale category * 2

MarketCode

Market segment code

String

See Market segment code and name * 2

MarginCode

Flags of margin and loan issues

String

1: Margin issues, 2: Loan issues, 3: Other issues(non-loan, non-margin) * 2

* 1 Calculated by JPX Market Innovation & Research using a proprietary model based on past earnings announcement times, not data reported by listed companies. * 2 Data as of PublicationDate.

PublicationType indicates the difference between the current record and the previous record for the same stock and the same earnings period. It is classified as shown in the table below.

Scheduled Date: Newly Published
Scheduled Date: Changed
Scheduled Date: No Change

Predicted Time: No Change

1 *

4

(This pattern does not exist)

Predicted Time: Newly Published

2

5

3

* Only this category has predicted earnings announcement time in an unpublished state. Predicted earnings announcement times are distributed only for issues for which a scheduled earnings announcement date has been reported (however, they are also distributed even if the scheduled earnings announcement date is subsequently changed to "undecided").

hashtag
API Call Sample Code

PreviousFinancial Statement Data(BS/PL/CF) (/fins/fs_details)NextDerivatives Trading Volume by Participant (/derivatives/volume_by_participant)

Last updated