Earnings Calendar (/fins/announcement)

The announcement date of financial results

Overview

Ths API provides the announcement date of financial results. For now, companies with fiscal year ends in March or September can be obtained. (Companies with fiscal year ends in other month will be supported in the future.)

Attention

• It will be updated at around 19:00 (JST) only when there is an update for companies which end their fiscal year in March or September at the following site. https://www.jpx.co.jp/listing/event-schedules/financial-announcement/index.html

• This API returns information about stocks whose financial results will be announced on the next business day.

• If there is no record with the next business day in the data obtained from the API, it means that there are no companies scheduled to disclose on the next business day among the companies with fiscal year ends in March or September.

• REIT data is not included.

Parameter and Response

inquire the issue code, fiscal year, and quarter scheduled to be announced on the next day.

GET https://api.jquants.com/v1/fins/announcement

*required

Query Parameters

Name	Type	Description
pagination_key	String	The primary key of the first item that this operation will evaluate. Use the value that was returned for pagination_key in the previous operation.

Headers

Name	Type	Description
Authorization*	String	Access key

200: OK

{
  "announcement": [
    {
      "Date": "2022-02-14",
      "Code": "43760",
      "CompanyName": "くふうカンパニー",
      "FiscalYear": "9月30日",
      "SectorName": "情報・通信業",
      "FiscalQuarter": "第１四半期",
      "Section": "マザーズ"
    }
  ],
  "pagination_key": "value1.value2."
}

400: Bad Request

{
    "message": "<Error Message>"
}

401: Unauthorized

{
　　　　　　　　"message": "The incoming token is invalid or expired."
}

403: Forbidden

}
    "message": "Missing Authentication Token. The method or resources may not be supported."
}

500: Internal Server Error

{
    "message": "Unexpected error. Please try again later."
}

Data Item

Variable	Description	Data type	Remark
Date	Date	String	Ex. YYYY-MM-DD If the earnings announcement date is undecided, the data will be an empty string ("").
Code	Issue code	String
CompanyName	Company name (Japanese)	String
FiscalYear	End of Fiscal year (Japanese)	String
SectorName	Sector name (Japanese)	String
FiscalQuarter	Fiscal quarter (Japanese)	String
Section	Market segment name (Japanese)	String

Sample Code

Curl

idToken=<YOUR idToken> && curl https://api.jquants.com/v1/fins/announcement -H "Authorization: Bearer $idToken" 

Python

import requests
import json

idToken = "YOUR idToken"
headers = {'Authorization': 'Bearer {}'.format(idToken)}
r = requests.get("https://api.jquants.com/v1/fins/announcement", headers=headers)
r.json()