J-Quants API
Markdownを表示

株価分足(/equities/bars/minute)

GET /v2/equities/bars/minute

APIの概要

分足の株価データを取得することができます。
1分単位の四本値（始値・高値・安値・終値）、出来高、売買代金のデータを提供します。

本APIの留意点

  • 本APIは「株価 分足・ティック」アドオンのご契約により利用可能となります。ベースプランのみではご利用いただけません。FAQ「アドオンプランだけを利用することは可能ですか？」もあわせてご参照ください。
  • 収録データ範囲について：
  • 銘柄によって取得可能開始日が異なる場合の基準は、東証への上場日です。直近2年以内に東証へ上場した銘柄については、上記の期間内であっても取得可能開始日は東証上場日以降となります（新規上場のほか、地方取引所やTOKYO PRO MARKETから東証へ上場した銘柄も同様です）。
  • 市場区分の変更（市場再編を含む）があった銘柄も、変更前の期間を含めてデータを収録しております。
  • 当APIは取引のティックデータを1分単位で集約したデータを提供しており、その1分間に取引が存在しない時間帯のデータは返却値に含まれません。
  • 板寄せによる約定はその成立時刻の分足に、大引けの約定は 15:30 の分足に収録されます。クロージング・オークションによる約定も収録しています。ただし板寄せ約定であることを示す項目はなく、時刻からの判別となります。
    • 前引け・大引けの板寄せは、該当時刻（11:30、15:30）に四本値が同値のバーとして現れます。
    • 寄付は当日最初のバーですが、成立時刻は9時00分に限りません。当日最初のバーが必ず「09:00」になるわけではありません。
    • 後場寄りの板寄せ約定は同一分の連続約定と合算されるため、板寄せ分のみの分離はできません。
    • ザラバ終了（15:25）から大引け（15:30）までの間のバーは通常返却されず、15:24 の次が 15:30 となります。
  • 四本値（O/H/L/C）は調整前の価格です（株式分割・株式併合等の調整は行っていません。調整済みの株価は株価四本値（日足）でご確認ください）。
  • 多数銘柄・長期間（全期間）のデータを取得される場合は、APIでの連続取得ではなくCSVファイルのダウンロード機能のご利用を推奨しております。ダウンロード可能ファイル一覧API・ファイルダウンロード用URL取得APIのほか、サインイン後のDownloadページからも取得いただけます。
  • データ不備・不足等によるデータの追加・上書き修正の履歴については、データ修正履歴・制約事項をご参照ください。
  • データ仕様について過去にお問い合わせのあった内容は、FAQ（データ内容・仕様）にも記載しておりますので、あわせてご参照ください。

分足の株価データを取得します

GET https://api.jquants.com/v2/equities/bars/minute

データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。

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

データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。

codedatefrom /toレスポンスの結果
指定された銘柄について全期間分のデータ
指定された銘柄について指定された日付のデータ
指定された銘柄について指定された期間分のデータ
全上場銘柄について指定された日付のデータ

Requests

Headers

x-api-keystringrequired

APIキー

Query Parameters

code または date のいずれか一つの指定が必須です。

codestringoptional

銘柄コード（e.g. 27800 or 2780）
4桁の銘柄コードを指定した場合は、普通株式と優先株式等の両方が上場している銘柄においては普通株式のデータのみが取得されます。

datestringoptional

from と to を指定しないとき（e.g. 20210907 or 2021-09-07）

fromstringoptional

fromの指定（e.g. 20210901 or 2021-09-01）

tostringoptional

to の指定（e.g. 20210907 or 2021-09-07）

pagination_keystringoptional

検索の先頭を指定する文字列
過去の検索で返却された pagination_key を設定

APIコールサンプルコード

Request

GET
/v2/equities/bars/minute
curl -G https://api.jquants.com/v2/equities/bars/minute \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="20230324"

Responses

data 配列の行順は仕様として規定・保証しているものはございません。

データ項目概要

Datestring
日付（YYYY-MM-DD）
Timestring
時刻（HH:mm、JST。各1分間の開始時刻。例: 15:00 は 15:00:00〜15:00:59 の約定を集計）
Codestring
銘柄コード
Onumber
始値（当該1分間の最初の約定値段）
Hnumber
高値（当該1分間の最も高い約定値段）
Lnumber
安値（当該1分間の最も安い約定値段）
Cnumber
終値（当該1分間の最後の約定値段）
Vonumber
出来高（当該1分間の約定数量の合計、単位: 株）
Vanumber
売買代金（当該1分間の約定価格×約定数量の合計、単位: 円）

レスポンスサンプル

{
    "data": [
        {
            "Date": "2023-03-24",
            "Time": "09:00",
            "Code": "86970",
            "O": 2047.0,
            "H": 2055.0,
            "L": 2045.0,
            "C": 2050.0,
            "Vo": 12500.0,
            "Va": 25625000.0
        }
    ],
    "pagination_key": "value1.value2."
}

Was this page helpful?