J-Quants API
Markdownを表示

ファイルダウンロード用URL取得(/bulk/get)

GET /v2/bulk/get

APIの概要

ファイルダウンロード用の署名付きURLを取得できます。
ダウンロード可能ファイル一覧で取得したKeyを指定する方法と、エンドポイントと日付を指定する方法の2通りでファイルを取得できます。

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

本APIの留意点

  • 取得したURLの有効期限は5分です。期限内にダウンロードを完了してください。
  • URLは一時的なものであり、再利用はできません。
  • ファイルはgzip形式で圧縮されています。
  • key または endpoint と date の組み合わせのどちらかを指定してください。3つ全てを同時に指定することはできません。

ファイルダウンロード用URLを取得します

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

データの取得では、ファイルキー（key）またはエンドポイント（endpoint）と日付（date）の組み合わせの指定が必須となります。

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

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

keyendpointdateレスポンスの結果
指定されたKeyのファイルのダウンロードURL
指定されたエンドポイントと日付に一致するファイルのダウンロードURL

Requests

Headers

x-api-keystringrequired

APIキー

Query Parameters

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

keystringoptional

ファイルのキー（/bulk/listから取得したKey）。

endpointstringoptional

取得するデータのエンドポイント名（e.g. /equities/bars/daily）。date と組み合わせて使用します。指定可能な値の一覧はこちらをご確認ください。

datestringoptional

対象日付（YYYY-MM, YYYYMM, YYYY-MM-DD, YYYYMMDD）。endpoint と組み合わせて使用します。

  • endpoint と date を組み合わせて指定すると、該当するファイルのダウンロードURLを取得できます。

APIコールサンプルコード

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

データ項目概要

urlstring
ファイルダウンロード用の署名付きURL

レスポンスサンプル

{
    "url": "https://example.presigned-url.com/..."
}

Was this page helpful?