List of Downloadable Files (/bulk/list)

GET /v2/bulk/list

Overview

You can retrieve a list of files available for download in CSV format.
By specifying an endpoint, you can get a list of files for a specific dataset.
You can use the obtained file list to download files with the Get File Download URL API.

For information on decompression methods and restrictions for CSV files obtained via Bulk API, please see File Download.

Attention

Files are compressed in gzip format.
File names include year and month information.

Retrieve list of downloadable files

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

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

endpointstringrequired: Endpoint name of the data to retrieve (e.g. /equities/bars/daily). For a list of available values, please see here.

Sample Code

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

Data Item

Keystring: File key (used when downloading file)
LastModifiedstring: Last modified date and time (ISO 8601 format)
Sizenumber: File size (bytes)

Response Sample

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