jquants-api-client

個人投資家向けデータ API 配信サービス「 J-Quants API 」の Python クライアントライブラリです。 J-Quants や API 仕様についての詳細を知りたい方は公式ウェブサイトをご参照ください。現在、J-Quants API は有償版サービスとして提供されています。

使用方法

pip 経由でインストールします。

pip install jquants-api-client

動作環境

Python 3.10 以上
pandas 2.2 以上
- pandas 3 系にも対応しています。ただし pandas 3 系は Python 3.11 以上が必須のため、Python 3.10 では pandas 2 系が使用されます。
- pandas 3 系では返却される DataFrame の dtype が一部変わります。dtype に依存した処理を行っている場合はご注意ください。
  - 文字列カラム: object → str
  - 日付カラム: datetime64[ns] → datetime64[us]

J-Quants API の利用

To use J-Quants API, you need to "Applications for J-Quants API" from J-Quants API Web site and to select a plan.

J-Quants API を利用するためにはJ-Quants API の Web サイトから「J-Quants API 申し込み」及び利用プランの選択が必要になります。

jquants-api-client-python を使用するためには「J-Quants API ダッシュボードから取得した API キー」が必要になります。必要に応じて下記の Web サイトより取得してください。

J-Quants API ダッシュボード

サンプルコード (V2)

V2 API では API キーによる認証を使用します。API キーは J-Quants API ダッシュボードから取得できます。

from datetime import datetime
from dateutil import tz
import jquantsapi

my_api_key: str = "*****"
cli = jquantsapi.ClientV2(api_key=my_api_key)
df = cli.get_eq_bars_daily_range(
    start_dt=datetime(2022, 7, 25, tzinfo=tz.gettz("Asia/Tokyo")),
    end_dt=datetime(2022, 7, 26, tzinfo=tz.gettz("Asia/Tokyo")),
)
print(df)

環境変数 JQUANTS_API_KEY を設定している場合は、引数を省略できます。

import jquantsapi

cli = jquantsapi.ClientV2()  # 環境変数 JQUANTS_API_KEY を使用

API レスポンスが Dataframe の形式で取得できます。

      Code       Date  ...     AdjC       AdjVo
0    13010 2022-07-25  ...   3630.0      8100.0
1    13050 2022-07-25  ...   2023.0     54410.0
2    13060 2022-07-25  ...   2001.0    943830.0
3    13080 2022-07-25  ...   1977.5    121300.0
4    13090 2022-07-25  ...  43300.0       391.0
...    ...        ...  ...      ...         ...
4189 99930 2022-07-26  ...   1426.0      5600.0
4190 99940 2022-07-26  ...   2605.0      7300.0
4191 99950 2022-07-26  ...    404.0     13000.0
4192 99960 2022-07-26  ...   1255.0      4000.0
4193 99970 2022-07-26  ...    825.0    133600.0

[8388 rows x 14 columns]

より具体的な使用例はサンプルノートブック(/examples) をご参照ください。

対応 API (V2)

ClientV2 クラスで利用可能な V2 API エンドポイントです。

プランごとに利用可能な API とデータ格納期間については、公式ドキュメントをご参照ください。

ラッパー群

get_eq_master - 上場銘柄一覧
get_eq_bars_daily - 株価日足
get_eq_bars_daily_am - 株価午前終値
get_eq_earnings_cal - 決算発表予定日（3・9月期決算会社のみ・翌営業日分）
get_eq_investor_types - 投資部門別売買状況
get_eq_valuation - バリュエーション指標（PER/PBR/ROE・時価総額）
get_idx_bars_daily - 指数日足
get_idx_bars_daily_topix - TOPIX日足
get_mkt_calendar - 営業日カレンダー
get_mkt_short_ratio - 空売り比率
get_mkt_short_sale_report - 空売り報告
get_mkt_margin_interest - 信用取引残高（2026-09-25 申込分以降は日次、それ以前は週次。公表日 published_date_yyyymmdd での検索に対応。空結果でも 16 列の列定義を保持した DataFrame を返します）
get_mkt_margin_alert - 信用規制情報
get_mkt_breakdown - 売買内訳
get_drv_bars_daily_fut - 先物日足
get_drv_bars_daily_opt - オプション日足
get_drv_bars_daily_opt_225 - 日経225オプション日足
get_fin_summary - 決算サマリー
get_fin_summary_cursor - 決算サマリー（cursor 差分取得）
get_fin_details - 財務詳細
get_fin_details_cursor - 財務詳細（cursor 差分取得）
get_fin_dividend - 配当情報
get_fin_earnings_date - 決算発表予定日
get_edinet_major_shareholders - 大株主状況（EDINET）
get_edinet_cross_shareholdings - 政策保有株式（EDINET）
get_edinet_large_volume_shareholders - 大量保有報告書（EDINET）
get_bulk_list - バルクデータ一覧
get_bulk - バルクデータ取得
get_eq_bars_minute - 分足
get_eq_bars_5minute - 5分足（分足から算出）
get_eq_bars_15minute - 15分足（分足から算出）
get_td_list - 適時開示インデックス一覧
get_td_files - 適時開示ファイルダウンロードURL取得
get_td_bulk - 適時開示インデックス一括ダウンロードURL取得

ユーティリティ群

業種や市場区分一覧などを返します。

get_market_segments - 市場区分一覧
get_17_sectors - 17業種一覧
get_33_sectors - 33業種一覧

日付範囲を指定して一括でデータ取得して、取得したデータを結合して返すユーティリティです。

get_list - 銘柄一覧（セクター情報付き）
get_eq_bars_daily_range - 株価日足（範囲指定）
get_eq_valuation_range - バリュエーション指標（範囲指定）
get_mkt_short_ratio_range - 空売り比率（範囲指定）
get_mkt_short_sale_report_range - 空売り報告（範囲指定）
get_mkt_margin_interest_range - 信用取引残高（申込日付の範囲指定）
get_mkt_margin_alert_range - 信用規制情報（範囲指定）
get_mkt_breakdown_range - 売買内訳（範囲指定）
get_drv_bars_daily_fut_range - 先物日足（範囲指定）
get_drv_bars_daily_opt_range - オプション日足（範囲指定）
get_drv_bars_daily_opt_225_range - 日経225オプション日足（範囲指定）
get_fin_summary_range - 決算サマリー（範囲指定）
get_fin_details_range - 財務詳細（範囲指定）
get_fin_earnings_date_range - 決算発表予定日（公表日の範囲指定）

レートリミット

J-Quants API には、サービスの安定稼働を目的としてレートリミット（利用頻度の制限）が設けられています。プランごとのレートリミットの詳細については、公式ドキュメントをご参照ください。

注意事項

サフィックスが _range で終わるメソッド（例: get_eq_bars_daily_range、get_fin_summary_range など）は、指定された日付範囲に対して並列処理で繰り返し API リクエストを行います。そのため、広い日付範囲を指定した場合や、短時間に複数回実行した場合、レートリミットに達する可能性があります。

レートリミットを超過すると、API は HTTP ステータスコード 429 Too Many Requests を返します。エラーが発生した場合は、一定時間待機してから再試行するか、より狭い日付範囲で分割してリクエストすることをご検討ください。

設定

API キーは設定ファイルおよび環境変数を使用して指定することも可能です。設定は下記の順に読み込まれ、設定項目が重複している場合は後に読み込まれた値で上書きされます。

/content/drive/MyDrive/drive_ws/secret/jquants-api.toml (Google Colab のみ)
${HOME}/.jquants-api/jquants-api.toml
jquants-api.toml
os.environ["JQUANTS_API_CLIENT_CONFIG_FILE"]
${JQUANTS_API_KEY}

設定ファイル例

jquants-api.toml は下記のように設定します。

[jquants-api-client]
api_key = "*****"

動作確認

Google Colab および Python 3.13 で動作確認を行っています。 J-Quants API は有償版で継続開発されているため、本ライブラリも今後仕様が変更となる可能性があります。 Python の EOL を迎えたバージョンはサポート対象外となります。 Please note we only support Python supported versions. Unsupported versions (after EOL) are not supported. ref. https://devguide.python.org/versions/#supported-versions

開発

J-Quants API Client の開発に是非ご協力ください。 Github 上で Issue や Pull Request をお待ちしております。

Metadata

Release files for jquants-api-client 2.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jquants-api-client 2.8.0
File	Size	Uploaded	Provenance
jquants_api_client-2.8.0.tar.gz	36.3 kB	Sep 30, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for jquants-api-client 2.8.0
File	Interpreter	ABI	Platform	Reset
jquants_api_client-2.8.0-py3-none-any.whl 42.7 kB Sep 30, 2026 Without provenance	Python 3	none	any	Details

Total release size: 79.0 kB

Release files / jquants_api_client-2.8.0.tar.gz

Download URL	jquants_api_client-2.8.0.tar.gz
Size	36.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`684d2be876d2d6df275f4b4a195ce2771101c2bf88e22088831e3b24ea1f1d28`
BLAKE2b-256 checksum How to use checksums	`1e703dfa49a88359391548bcece1e04fe6626c85efa9243921f1d702a5267ff7`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.5.1 CPython/3.12.3 Linux/6.17.0-1022-azure`

Release files / jquants_api_client-2.8.0-py3-none-any.whl

Download URL	jquants_api_client-2.8.0-py3-none-any.whl
Size	42.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`810f154e3f75565308bb56a32d980877170fb1ed9cfe3db5a2f0a31a2c4f6d00`
BLAKE2b-256 checksum How to use checksums	`69ad529c397dcb9d94098e5c8c7bb74581ccbfd1f37cd64d83678b71b69ca160`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.5.1 CPython/3.12.3 Linux/6.17.0-1022-azure`

Security for jquants-api-client 2.8.0

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.