J-Quants API
Markdownを表示

決算発表予定日(/fins/earnings-date)

GET /v2/fins/earnings-date

APIの概要

東証上場会社等が東証に対して報告した決算発表予定日を取得できます。
決算期によらず、報告を行った全上場銘柄（REIT等を含む）が対象で、予定日の変更・未定の履歴も含めて公表日単位で提供します。

本APIの留意点

  • 決算発表予定日の変更が報告された場合、以前のデータは削除されず、修正後の予定日が新たなデータとして追加されます（code 指定時は変更履歴を含む全レコードが返却されます）。
  • 一度公表された決算発表予定日が後から「未定」に変更された場合、SchDate は空文字（""）となります。
  • scheduled_date を指定した場合、各銘柄・各決算区分（1Q/2Q/3Q/FY）で最後に公表されたレコードのみがヒットします。そのため、予定日がその後変更された場合、変更前の予定日ではヒットしません。
  • プランごとの参照可能期間は、公表日（PubDate）を基準に適用されます。date 指定時は参照範囲外の日付を指定すると 400 エラーとなります。また、code / scheduled_date 指定時は参照範囲外の公表日のデータが結果に含まれません。

決算発表予定日データを取得します

GET https://api.jquants.com/v2/fins/earnings-date

データの取得では、code（銘柄コード）・date（公表日）・scheduled_date（発表予定日）のいずれか1つの指定が必須となります。
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。

codedatescheduled_dateレスポンスの結果
指定された銘柄の予定日公表履歴
指定日に公表・変更された全銘柄の予定日データ
指定日を現在有効な発表予定日とする全銘柄のデータ

※ 2つ以上のパラメータを同時に指定することはできません（400 エラー）。
※ 該当データが存在しない場合は空配列（"data": []）を返却します。

Requests

Headers

x-api-keystringrequired

APIキー

Query Parameters

codestringoptional

銘柄コード（e.g. 86970 or 8697）

datestringoptional

公表日（e.g. 20250620 or 2025-06-20）

scheduled_datestringoptional

決算発表予定日（e.g. 20250805 or 2025-08-05）

pagination_keystringoptional

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

APIコールサンプルコード

Request

GET
/v2/fins/earnings-date
curl -G https://api.jquants.com/v2/fins/earnings-date \
-H "x-api-key: {loading}" \
-d code="86970"

Responses

データ項目概要

PubDatestring
公表日（YYYY-MM-DD）
この予定日が公表・変更された日
SchDatestring
決算発表予定日（YYYY-MM-DD）
未定の場合は空文字（""）
FQNamestring
決算区分（1Q / 2Q / 3Q / FY）
FYEstring
決算期末（MMDD）
Codestring
銘柄コード（5桁）
CoNamestring
会社名
CoNameEnstring
会社名（英語）

※ 会社名（CoName・CoNameEn）は PubDate 時点のデータです。

レスポンスサンプル

{
    "data": [
        {
            "PubDate": "2025-06-03",
            "SchDate": "2025-07-30",
            "FQName": "1Q",
            "FYE": "0331",
            "Code": "86970",
            "CoName": "日本取引所グループ",
            "CoNameEn": "Japan Exchange Group,Inc."
        }
    ],
    "pagination_key": "value1.value2."
}

Was this page helpful?