J-Quants API
Markdownを表示

TDnet/適時開示インデックス一覧(/td/list)

GET /v2/td/list

APIの概要

適時開示のインデックス情報（開示番号・日時・タイトルなど）の一覧を取得できます。
日付またはコードを指定してデータを取得します。

本APIの留意点

  • 本APIはTDnet/適時開示情報アドオンが必要です。
  • データ取得可能期間は過去5年間です。
  • 開示情報の更新を通知するWebhookは提供していません。当日の差分取得にはcursorを使った差分取得をご利用ください。
  • 開示情報がJ-Quants API／Bulkで利用可能になった時刻を示すフィールドは提供していません。更新頻度および更新時刻の目安は提供データの更新タイミングをご参照ください。
  • 本APIと財務情報は同期していません。Premiumプランでも、本APIで新規開示を検知した時点では当該開示の財務情報を取得できない場合があります。
  • 当日分の適時開示情報を随時取得される場合は、cursorを使った差分取得（cursor パラメータ）のご利用を推奨しております。

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

  • 適時開示ファイル自体が訂正された場合、新規の開示番号（DiscNo）が割り振られ、新規レコードとして追加されます。既存レコードは上書きされません。
  • 訂正・変更された場合でも、元の開示データは引き続き取得いただけます。データ取得可能期間（過去5年間）内であれば、旧 DiscNo を指定して適時開示ファイル取得から当時のファイルを取得いただけます。
  • 適時開示ファイルの題目が訂正された場合、当APIで取得される情報にその訂正内容は反映されません。
  • 適時開示情報が削除された場合でも、当APIではその適時開示情報を取得いただけます。
  • 全版履歴および訂正・取消・削除情報は、本API（/td/list）および適時開示インデックス一括ダウンロード（/td/bulk）のいずれにおいても提供していません。訂正前後を版として関連付けた形での提供は行っておらず、訂正後の開示がどの開示に対する訂正・削除であるかを機械的に特定するための項目も、現仕様では提供していません。訂正元を特定される場合は、Code・Title・DiscItems（公開項目コード）等の項目からの照合をご検討ください。
  • データ不備・不足等によるデータの追加・上書き修正の履歴については、データ修正履歴・制約事項をご参照ください。
  • データ仕様について過去にお問い合わせのあった内容は、FAQ（データ内容・仕様）にも記載しておりますので、あわせてご参照ください。

適時開示インデックス一覧を取得します

GET https://api.jquants.com/v2/td/list

データの取得では、日付（date）または銘柄コード（code）の指定が必須となります。

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

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

datecodefrom/toレスポンスの結果
指定された日付の開示一覧
指定された銘柄の開示一覧（直近5年間）
指定された銘柄の指定期間の開示一覧

cursorを使った開示情報の取得

cursorを使ったリアルタイム差分取得の仕様については、cursorを使った差分取得をご参照ください。

Requests

Headers

x-api-keystringrequired

APIキー

Query Parameters

date または code のいずれか一つの指定が必須です。

datestringoptional

開示日（e.g. 20250401 or 2025-04-01）

codestringoptional

銘柄コード（e.g. 13010 or 1301）

fromstringoptional

取得開始日（e.g. 20250301 or 2025-03-01）
code と組み合わせて使用します。to と必ずペアで指定してください。

tostringoptional

取得終了日（e.g. 20250401 or 2025-04-01）
code と組み合わせて使用します。from と必ずペアで指定してください。

discItemsstringoptional

公開項目コードで絞り込む（カンマ区切りで複数指定可能、AND条件）（e.g. 11101 or 11101,11102）
公開項目コードの一覧はTDnet API仕様書の付録1を参照してください。

cursorstringoptional

本日どの開示情報まで取得したかを保持するカーソル
前回のレスポンスで返却された cursor を指定することで前回のリクエスト以降に配信されたデータを取得できます。pagination_key と同時指定不可。

pagination_keystringoptional

ページネーションキー
前回のレスポンスで返却された pagination_key を指定します。cursor と同時指定不可。

APIコールサンプルコード

Request

GET
/v2/td/list
curl -G https://api.jquants.com/v2/td/list \
-H "x-api-key: {loading}" \
-d date="20250401"

Responses

データ項目概要

DiscNostring
開示番号（14桁）
Codestring
銘柄コード
Namestring
会社名
DiscDatestring
開示日（YYYY-MM-DD, JST）
TDnetの正式な開示日としてご利用いただけます。
DiscTimestring
開示時刻（HH:MM、JST）
TDnetの正式な開示時刻としてご利用いただけます。
Titlestring
開示タイトル
DiscStatusstring
取扱属性（null: 新規開示情報、'revision': 訂正開示情報、'delete': 削除開示情報）
現仕様では常に null が格納され、'revision'・'delete' は出力されません。訂正された適時開示は新規の開示番号を持つ別レコードとして追加されます。
RevNonumber
開示履歴番号（1～99）
現仕様では常に 1 が格納されます。
DiscItemsstring[]
公開項目コードのリスト
Docsstring[]
書類タイプのリスト（g: 全文情報PDF、s: サマリ情報PDF、x: XBRL関連ファイル）
cursorstring
本日どの開示情報まで取得したかを保持するためのコード（dateに当日を指定し、かつページネーションなしで全件取得できた場合のみ返却）
pagination_keystring
ページネーションキー

レスポンスサンプル

{
    "data": [
        {
            "DiscNo": "20250401130100",
            "Code": "86970",
            "Name": "日本取引所グループ",
            "DiscDate": "2025-04-01",
            "DiscTime": "08:00",
            "Title": "2025年3月期 決算短信〔日本基準〕（連結）",
            "DiscStatus": null,
            "RevNo": 1,
            "DiscItems": ["11101"],
            "Docs": ["g", "s", "x"]
        }
    ],
    "cursor": "eyJkIjoiMjAyNS0wNC0wMSIsInQiOiIyMDI1LTA0LTAxVDA4OjAwOjAwWiMyMDI1MDQwMTEzMDEwMCJ9"
}

Was this page helpful?