サービスについて
J-Quants APIはどのようなことができるサービスですか?
J-Quants APIでは、ヒストリカルの株価(四本値)や出来高、財務数値といった金融データをAPIで取得できるサービスです。個人の方にとって入手が難しかった、整形された金融データを取得しやすくすることを目指しています。機関投資家と同等のデータセットを個人にもお届けする、データを民主化するサービスです。
J-Quants APIではどのようなデータが提供されていますか?
現在提供されているデータは提供データ一覧をご覧ください。
APIではなく、CSVなどファイル形式でデータを取得することは可能ですか?
CSVのダウンロードが可能です(Freeプランの方は取引カレンダーのみご利用いただけます)。ファイルダウンロードについてからご確認ください。
J-Quants APIの使い方がわかりません。はじめに何をすればよいですか?
はじめての方はクイックスタートガイドをご参照ください。基本的な流れは以下のとおりです。詳細はAPI仕様書もあわせてご確認ください。
- アカウント作成・サインイン
- ダッシュボードの「設定 » APIキー」からAPIキーを発行・取得
- 各データエンドポイントへのリクエストヘッダーに `x-api-key: <APIキー>` を付与してリクエスト
ユーザー登録したのに確認メールが届きません。
すでにユーザー登録が完了している場合があります。サインインページからメールアドレス・パスワードでサインインをお試しください。メールが見当たらない場合は、迷惑メールボックスもご確認ください。
V1のAPIエンドポイントは使えますか?
J-Quants APIはV1からV2に切り替わり、認証方式が「トークン方式」から「APIキー方式」に変更されました。V1は閉鎖済みのため、すべてのユーザーはV2のみご利用いただけます。V2では `x-api-key` ヘッダーにAPIキーを付与してリクエストしてください。詳細はV1→V2の変更点やクイックスタートガイド(V2認証)をご参照ください。
リクエストパラメータに日付を指定するとエラーになります。
日付パラメータは YYYYMMDD 形式(例: 20240101)または YYYY-MM-DD 形式(例: 2024-01-01)で、実在するカレンダー上の日付を指定してください。存在しない日付(例: 20240230)を指定するとエラーになります。
APIのレート制限(リクエスト上限)はありますか?
プランごとに1分あたりのリクエスト数上限が設定されています。レート制限を超えた場合は 429 Too Many Requests エラーが返されます。時間をおいてから再度リクエストしてください。詳細はレートリミットについてをご確認ください。
- Free: 5回/分
- Light: 60回/分
- Standard: 120回/分
- Premium: 500回/分
データの更新タイミングはいつですか?
データ種別によって異なります。詳細はデータ更新スケジュールや各エンドポイントの仕様書をご確認ください。
- 株価四本値: 営業日の大引け後に当日分が更新
- 財務情報: 18:00と24:30に更新(PremiumプランのAPIは随時更新)
- 銘柄一覧(equities/master): 翌営業日時点の情報は17時半以降に取得可能
V1のサンプルコード(`auth_user` / `auth_refresh` を使うもの)が動かなくなりました。
V1の `/v1/token/auth_user`・`/v1/token/auth_refresh` エンドポイントは廃止されました。V2ではダッシュボードで発行したAPIキーをリクエストヘッダー `x-api-key` に指定する方式に変更されています。お手元のサンプルコードの認証部分を以下のように書き換えてください。詳細はV1→V2の変更点やクイックスタートガイドもご参照ください。
- 旧(V1): auth_user でリフレッシュトークン取得 → auth_refresh でIDトークン取得 → Authorization: Bearer <IDトークン> を付与
- 新(V2): ダッシュボードからAPIキー取得 → x-api-key: <APIキー> を付与
V1で使っていたエンドポイントのV2対応エンドポイントを教えてください。
主要エンドポイントのV1→V2対応関係は以下のとおりです(一部抜粋)。なおV2ではレスポンスのカラム名も短縮形に変更されている項目があります(例:株価の `Open` → `O`、`Close` → `C`)。完全な対応表はV1→V2の変更点でご確認いただけます。
- 株価四本値: /v1/prices/daily_quotes → /v2/equities/bars/daily
- 上場銘柄一覧: /v1/listed/info → /v2/equities/master
- 財務情報: /v1/fins/statements → /v2/fins/summary
- 財務諸表(BS/PL/CF): /v1/fins/fs_details → /v2/fins/details
- 取引カレンダー: /v1/markets/trading_calendar → /v2/markets/calendar
- 業種別空売り比率: /v1/markets/short_selling → /v2/markets/short-ratio
- 指数四本値: /v1/indices → /v2/indices/bars/daily