J-Quants API
Markdownを表示

ダウンロード可能ファイル一覧(/bulk/list)

GET /v2/bulk/list

APIの概要

CSV形式でダウンロード可能なファイルの一覧を取得できます。
エンドポイントを指定して特定のデータセットのファイル一覧を取得する方法と、日付を指定して該当期間の全データセットのファイル一覧を取得する方法があります。
取得したファイル一覧を利用して、ファイルダウンロード用URL取得APIでファイルを取得いただけます。

Bulk APIで取得したCSVファイルの解凍方法、制約事項についてはファイルダウンロードをご確認ください。

本APIの留意点

  • ファイルはgzip形式で圧縮されています。
  • ファイル名には年月情報が含まれています。
  • endpoint または date のどちらかは必須です。

ダウンロード可能ファイル一覧を取得します

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

データの取得では、エンドポイント（endpoint）または日付（date）の指定が必須となります。

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

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

endpointdatefrom /toレスポンスの結果
指定されたエンドポイントのプランに応じた全期間のファイル一覧
指定されたエンドポイントの指定期間のファイル一覧
ご契約プランでアクセス可能な全エンドポイントの指定日付のファイル一覧

Requests

Headers

x-api-keystringrequired

APIキー

Query Parameters

endpoint または date のどちらかが必須です。

endpointstringoptional

取得するデータのエンドポイント名（e.g. /equities/bars/daily）。指定可能な値の一覧はこちらをご確認ください。

datestringoptional

対象日付（YYYY-MM, YYYYMM, YYYY-MM-DD, YYYYMMDD）。

fromstringoptional

取得期間の開始日（YYYY-MM, YYYYMM, YYYY-MM-DD, YYYYMMDD）。endpoint 指定時のみ使用可能です。

tostringoptional

取得期間の終了日（YYYY-MM, YYYYMM, YYYY-MM-DD, YYYYMMDD）。endpoint 指定時のみ使用可能です。

  • endpoint のみを指定した場合、プランに応じた期間の全ファイルが返されます。from/to で期間を絞り込むことができます。
  • date のみを指定した場合、ご契約プランでアクセス可能な全エンドポイントの該当日付のファイルが返されます。

APIコールサンプルコード

Request

GET
/v2/bulk/list
curl -G https://api.jquants.com/v2/bulk/list \
-H "x-api-key: {loading}" \
-d endpoint="/equities/bars/daily"

Responses

データ項目概要

Keystring
ファイルのキー（ファイルダウンロード時に使用）
LastModifiedstring
最終更新日時（ISO 8601形式）
Sizenumber
ファイルサイズ（バイト）

レスポンスサンプル

{
    "data": [
        {
            "Key": "equities/bars/daily/historical/2025/equities_bars_daily_202501.csv.gz",
            "LastModified": "2025-11-07T20:48:51.295000+00:00",
            "Size": 6933528
        },
        {
            "Key": "equities/bars/daily/historical/2024/equities_bars_daily_202412.csv.gz",
            "LastModified": "2025-01-07T18:30:15.123000+00:00",
            "Size": 6845123
        }
    ]
}

Was this page helpful?