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

GET /v2/bulk/list

APIの概要

CSV形式でダウンロード可能なファイルの一覧を取得できます。
エンドポイントを指定することで、特定のデータセットのファイル一覧を取得できます。
取得したファイル一覧を利用して、ファイルダウンロード用URL取得APIでファイルを取得いただけます。

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

本APIの留意点

ファイルはgzip形式で圧縮されています。
ファイル名には年月情報が含まれています。

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

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

Requests

Headers

x-api-keystringrequired: APIキー

Query Parameters

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

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
        }
    ]
}