J-Quants API
Markdownを表示

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

GET /v2/fins/earnings-date

APIの概要

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

本APIの留意点

  • 欠損値・レコード不在について：
    • 一度公表された決算発表予定日が後から「未定」に変更された場合、SchDate は空文字（""）となります。これは決算発表の延期等により予定日が未定となったことを示す正常な情報であり、データの欠損・不備ではありません。
  • 決算期末（FYE）について： FYE は公表日時点の決算期末を MMDD の 4 桁で表します。2月末決算のみ 0299 と表記し（99 は月末を表します。2月は月末日が年により異なるため）、それ以外の決算期末は実際の日付で表記します（例：0331・1231）。月末以外の日を決算期末とする銘柄（例：0220）もあります。決算期の変更が報告された場合、同じ銘柄・決算区分でも FYE の異なるレコードが履歴として併存します。
  • scheduled_date を指定した場合、各銘柄・各決算区分（1Q/2Q/3Q/FY）で最後に公表されたレコードのみがヒットします。そのため、予定日がその後変更された場合、変更前の予定日ではヒットしません。
  • プランごとの参照可能期間は、公表日（PubDate）を基準に適用されます。date 指定時は参照範囲外の日付を指定すると 400 エラーとなります。また、code / scheduled_date 指定時は参照範囲外の公表日のデータが結果に含まれません。

データ更新・訂正のポリシー

  • 決算発表予定日の変更・未定は、既存レコードの上書きではなく、別の公表日（PubDate）の新たなレコードとして追加されます。
  • 過去に公表されたレコードも残るため、code を指定することで、予定日の公表・変更の履歴を取得できます。
  • データ不備・不足等によるデータの追加・上書き修正の履歴については、データ修正履歴・制約事項をご参照ください。
  • データ仕様について過去にお問い合わせのあった内容は、FAQ（データ内容・仕様）にも記載しておりますので、あわせてご参照ください。

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

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・公表日時点）
2月末決算の場合は 0299
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?