決算発表予定日(/fins/announcement)

翌日発表予定の決算情報が取得できます

API概要

3月期・9月期決算の会社の決算発表予定日を取得できます。（その他の決算期の会社は今後対応予定です）

本APIの留意点

• 下記のサイトで、3月期・９月期決算会社分に更新があった場合のみ19時ごろに更新されます。３月期・９月期決算会社についての更新がなかった場合は、最終更新日時点のデータを提供します。 https://www.jpx.co.jp/listing/event-schedules/financial-announcement/index.html

• 本APIは翌営業日に決算発表が行われる銘柄に関する情報を返します。

• 本APIから得られたデータにおいてDateの項目が翌営業日付であるレコードが存在しない場合は、3月期・9月期決算会社における翌営業日の開示予定はないことを意味します。

• REITのデータは含まれません。

パラメータ及びレスポンス

決算発表予定日の銘柄コード、年度、 四半期等の照会をします。

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

*は必須項目

Query Parameters

Name	Type	Description
pagination_key	String	検索の先頭を指定する文字列 過去の検索で返却されたpagination_keyを設定

Headers

Name	Type	Description
Authorization*	String	アクセスキー

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."
}

データ項目概要

変数名	説明	型	備考
Date	日付	String	例：YYYY-MM-DD なお、決算発表予定日が未定の場合、空文字("")となります。
Code	銘柄コード	String
CompanyName	会社名	String
FiscalYear	決算期末	String
SectorName	業種名	String
FiscalQuarter	決算種別	String
Section	市場区分	String

APIコールサンプルコード

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()