Get File Download URL (/bulk/get)

GET /v2/bulk/get

Overview

You can obtain a signed URL for downloading a file.
By specifying the Key obtained from List of Downloadable Files, you can get a URL to actually download the file.

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

Attention

The obtained URL expires in 5 minutes. Please complete the download within the validity period.
The URL is temporary and cannot be reused.
Files are compressed in gzip format.

Retrieve file download URL

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

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

keystringrequired: File key (Key obtained from /bulk/list)

Sample Code

Request

GET

/v2/bulk/get

curl -G https://api.jquants.com/v2/bulk/get \
-H "x-api-key: {loading}" \
-d key="equities/bars/daily/historical/2025/equities_bars_daily_202501.csv.gz"

Responses

Data Item

urlstring: Signed URL for file download

Response Sample

{
    "url": "https://example-bucket.s3.amazonaws.com/equities/bars/daily/historical/2025/equities_bars_daily_202501.csv.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=...&X-Amz-Expires=3600&X-Amz-Signature=..."
}