List of Downloadable Files (/bulk/list)

GET /v2/bulk/list

Overview

You can retrieve a list of files available for download in CSV format.
You can get a list of files for a specific dataset by specifying an endpoint, or get a list of files across all accessible datasets for a specific date.
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.
Either endpoint or date is required.

Retrieve list of downloadable files

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

In your request message, either "endpoint" or "date" must be specified.

Parameter and Response

In your request message, either "endpoint" or "date" must be specified.
Combination of parameter in the request and results are as below.

endpoint	date	from /to	Results
			File list for the specified endpoint for the plan's full allowed period
			File list for the specified endpoint within the specified period
			File list for the specified date across all accessible endpoints under your subscription

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

Either endpoint or date is required.

endpointstringoptional: Endpoint name of the data to retrieve (e.g. /equities/bars/daily). For a list of available values, please see here.
datestringoptional: Target date (YYYY-MM, YYYYMM, YYYY-MM-DD, or YYYYMMDD).
fromstringoptional: Start date of the retrieval period (YYYY-MM, YYYYMM, YYYY-MM-DD, or YYYYMMDD). Only available when endpoint is specified.
tostringoptional: End date of the retrieval period (YYYY-MM, YYYYMM, YYYY-MM-DD, or YYYYMMDD). Only available when endpoint is specified.

When only endpoint is specified, all files within the plan's allowed period are returned. You can narrow the period using from/to.
When only date is specified, files for that date from all endpoints accessible under your subscription are returned.
When Trading Calendar (/markets/calendar) is specified as the endpoint, only the latest file will be returned, regardless of the from/to period. Additionally, Trading Calendar cannot be retrieved with a date specification.

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