J-Quants API の V1 は終了しました｜V2 でコードのどこが壊れるか

まず結論：V1 はもう存在しません

J-Quants API は V1 から V2 へ移行し、旧バージョンの V1 は 2026年6月1日に終了しました。2025年12月22日以降に登録した人は、はじめから V2 しか使えません。

つまり、2025年までに書かれた解説記事・サンプルコード・ライブラリの多くは、そのままでは動きません。検索で上位に出てくるものほど古いことがあるので、まずここを疑ってください。

変わったところ（5つ＋1）

1. 認証：トークン方式 → APIキー方式

V1 では、メールアドレスとパスワードでリフレッシュトークンを取り、それで ID トークンを取り、ID トークンを Authorization: Bearer に載せる——という3段構えでした。V2 ではこれが全部なくなります。

ダッシュボードで発行した APIキーを x-api-key ヘッダーに入れるだけです。APIキー自体に有効期限はありません（再発行と削除はできます）。トークンの期限切れを気にしてリフレッシュ処理を書いていた部分は、まるごと消せます。

# V1 のコード（もう動かない）
import requests

# 1. メールアドレスとパスワードでリフレッシュトークンを取る
r = requests.post(
    "https://api.jquants.com/v1/token/auth_user",
    json={"mailaddress": MAIL, "password": PASS},
)
refresh_token = r.json()["refreshToken"]

# 2. リフレッシュトークンから ID トークンを取る
r = requests.post(
    "https://api.jquants.com/v1/token/auth_refresh",
    params={"refreshtoken": refresh_token},
)
id_token = r.json()["idToken"]

# 3. ID トークンを Authorization ヘッダーに載せて叩く
r = requests.get(
    "https://api.jquants.com/v1/prices/daily_quotes",
    params={"code": "8697", "date": "2026-09-18"},
    headers={"Authorization": f"Bearer {id_token}"},
)
quotes = r.json()["daily_quotes"]
print(quotes[0]["Close"])

# V2 のコード
import requests

API_KEY = "..."  # ダッシュボードの [API Keys] で発行する

r = requests.get(
    "https://api.jquants.com/v2/equities/bars/daily",
    params={"code": "8697", "date": "2026-09-18"},
    headers={"x-api-key": API_KEY},
)
r.raise_for_status()
rows = r.json()["data"]      # V1 の "daily_quotes" ではなく "data"
print(rows[0]["C"])          # V1 の "Close" ではなく "C" 

2. エンドポイントが全部変わった

パスの付け方が「データの種類ごとの階層」に整理され直しました。対応表は次のとおりです。

見てのとおり、機械的に置換できるものはほとんどありません。/v1/ を /v2/ に変えるだけでは動きません。

3. レスポンスが data キーに統一された

V1 はエンドポイントごとに入れ物の名前が違いました（daily_quotes、info、statements など）。V2 は原則としてすべて data の配列で返ってきます。

{
  "data": [
    { ... },
    { ... }
  ],
  "pagination_key": "..."
}

該当データが0件のときもエラーにはならず、200 で {"data": []} が返ります。pagination_key は付きません。

4. カラム名が短縮形になった（ここが一番危ない）

認証やエンドポイントの変更は、動かないのですぐ気づきます。怖いのはこちらです。

5. レートリミットが新設された

V1 には明示のレートリミットがありませんでした。V2 ではプランごとに上限が決まっています。

加えて、財務情報（/v2/fins/summary）と財務諸表（/v2/fins/details）は、プランに関係なく専用枠で 60/分。分足・ティックのアドオンも専用枠で 60/分です。

上限を超えると 429 が返ります。Retry-After ヘッダーは付きません。判定は1分のスライディングウィンドウで、429 になったリクエストも回数に数えられるため、待たずに投げ直すと制限が解けるまでの時間が延びます。大幅に超過し続けると、5分程度アクセスが完全に遮断されることがあります。

import time
import requests


def get_with_retry(url, params, headers, tries=5):
    for i in range(tries):
        r = requests.get(url, params=params, headers=headers, timeout=60)
        if r.status_code == 429:
            # Retry-After は付かない。1分のスライディングウィンドウなので
            # 「すぐ投げ直さず、余裕をみて待つ」以外に手はない
            time.sleep(90)
            continue
        if r.status_code in (500, 502, 503, 504):
            time.sleep(5 * (i + 1))
            continue
        r.raise_for_status()
        return r.json()
    raise RuntimeError(f"{tries} 回試しても取れなかった: {url} {params}")

おまけ：Premium の取得期間が縮んだ

見落とされがちですが、Premium プランの期間制限が「無制限」から「過去20年分」に変わりました。20年より前まで遡る検証を組んでいた場合は、前提が変わります。

逆に緩くなった点もあり、上場銘柄一覧の貸借信用区分は、V1 では Standard 以上だったものが V2 では全プランで取れるようになりました。

ページングの書き方

レスポンスが大きいと pagination_key が付いて返ってきます。付かなくなるまで繰り返すのが全件取得の作法です。総件数を返す項目はありません。

import requests

HEADERS = {"x-api-key": API_KEY}
URL = "https://api.jquants.com/v2/equities/bars/daily"


def fetch_all(**params):
    out = []
    while True:
        r = requests.get(URL, params=params, headers=HEADERS)
        r.raise_for_status()
        body = r.json()
        out += body["data"]
        key = body.get("pagination_key")
        if not key:
            return out
        params["pagination_key"] = key   # 他の条件は変えないこと

• 分割が起きるのは、レスポンスが 5,000,000 バイト相当に達したとき
• 1回あたりの件数は内部処理で変動し、非公開・保証対象外
• pagination_key の値は毎回変わる
• 繰り返しの途中でデータが更新された場合、取得結果全体の一貫性は保証されない

403 が返ったときの読み分け

V2 の 403 は複数の原因で返ります。メッセージを見ないと切り分けられません。

V1 のパスを叩くと 404 ではなく 403 が返ることがあります。「権限の問題かと思ってプランを上げたが直らない」という遠回りをしやすいので、まず自分が叩いている URL が /v2/ かを確かめてください。

移行チェックリスト

1. ダッシュボードの [API Keys] でAPIキーを発行する
2. auth_user / auth_refresh を呼んでいる箇所をすべて削除する
3. Authorization: Bearer を x-api-key に置き換える
4. エンドポイントを対応表で1つずつ書き換える（機械置換はできない）
5. レスポンスの取り出しを data に統一する
6. カラム名を短縮形に直す。.get() ではなく [] で取って、抜けていればその場で落とすようにする
7. 429 を待って再開する処理を入れる（Retry-After は来ない）
8. pagination_key が付かなくなるまで繰り返すようにする
9. Premium を使っていて20年より前を見ていた場合は、検証期間の前提を見直す

Windows で叩くときの細かい注意

公式ドキュメントにも注記がありますが、PowerShell では2つ引っかかります。

• シングルクォートの中で変数が展開されません。ヘッダーはダブルクォートで書きます（-H "x-api-key: $key"）
• curl が別コマンドの別名になっていることがあります。curl.exe と明示してください

curl.exe -G "https://api.jquants.com/v2/equities/bars/daily" `
  -H "x-api-key: $key" `
  -d code=8697 `
  -d date=2026-09-18

まとめ

V1 から V2 への移行は、「認証を差し替えれば済む」という規模ではありません。エンドポイント・レスポンス構造・カラム名の3つが同時に変わっているので、データを取る層はほぼ書き直しになります。

そのうえで、いちばん怖いのはカラム名です。認証もパスも直して「動いた」と思ったあとに、Close が取れていなかったことに気づく——という順番になりがちだからです。検証の数字がおかしいと感じたら、まずそこを見てください。