Package: jquants-api-client
jquants-api-client個人投資家向けデータ API 配信サービス「J-Quants API」の Python クライアントライブラリです。
J-Quants や API 仕様についての詳細を知りたい方は公式ウェブサイトをご参照ください。
現在、J-Quants API は有償版サービスとして提供されています。使用方法pip 経由でインストールします。pipinstalljquants-api-clientJ-Quants API の利用To use J-Quants API, you need to "Applications for J-Quants API" fromJ-Quants API Web siteand to select a plan.J-Quants API を利用するためにはJ-Quants API の Web サイトから「J-Quants API 申し込み」及び利用プランの選択が必要になります。jquants-api-client-python を使用するためには「J-Quants API ログインページで使用するメールアドレスおよびパスワード」または「J-Quants API メニューページから取得したリフレッシュトークン」が必要になります。必要に応じて下記の Web サイトより取得してください。J-Quants API ログインページサンプルコードfromdatetimeimportdatetimefromdateutilimporttzimportjquantsapimy_mail_address:str="*****"my_password:str="*****"cli=jquantsapi.Client(mail_address=my_mail_address,password=my_password)df=cli.get_price_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)API レスポンスが Dataframe の形式で取得できます。CodeDate...AdjustmentCloseAdjustmentVolume0130102022-07-25...3630.08100.01130502022-07-25...2023.054410.02130602022-07-25...2001.0943830.03130802022-07-25...1977.5121300.04130902022-07-25...43300.0391.0
..................4189999302022-07-26...1426.05600.04190999402022-07-26...2605.07300.04191999502022-07-26...404.013000.04192999602022-07-26...1255.04000.04193999702022-07-26...825.0133600.0[8388rowsx14columns]より具体的な使用例はサンプルノートブック(/examples)をご参照ください。対応 APIラッパー群J-Quants API の各 API エンドポイントに対応しています。------------------ Free plan or higher is required ------------------get_refresh_tokenget_id_tokenget_listed_infoget_prices_daily_quotesget_fins_statementsget_fins_announcement------------------ Light plan or higher is required ------------------get_markets_trades_specget_indices_topix------------------ Standard plan or higher is required ------------------get_option_index_optionget_markets_weekly_margin_interestget_markets_short_selling------------------ Premium plan or higher is required ------------------get_markets_breakdownget_prices_prices_amget_fins_dividendユーティリティ群業種や市場区分一覧などを返します。get_market_segmentsget_17_sectorsget_33_sectors日付範囲を指定して一括でデータ取得して、取得したデータを結合して返すようなユーティリティが用意されています。------------------ Free plan or higher is required ------------------get_listget_price_rangeget_statements_range------------------ Standard plan or higher is required ------------------get_weekly_margin_rangeget_short_selling_rangeget_index_option_range------------------ Premium plan or higher is required ------------------get_breakdown_rangeget_dividend_range設定認証用のメールアドレス/パスワードおよびリフレッシュトークンは設定ファイルおよび環境変数を使用して指定することも可能です。
設定は下記の順に読み込まれ、設定項目が重複している場合は後に読み込まれた値で上書きされます。/content/drive/MyDrive/drive_ws/secret/jquants-api.toml(Google Colab のみ)${HOME}/.jquants-api/jquants-api.tomljquants-api.tomlos.environ["JQUANTS_API_CLIENT_CONFIG_FILE"]${JQUANTS_API_MAIL_ADDRESS},${JQUANTS_API_PASSWORD},${JQUANTS_API_REFRESH_TOKEN}設定ファイル例jquants-api.tomlは下記のように設定します。[jquants-api-client]mail_address="*****"password="*****"refresh_token="*****"動作確認Google Colab および Python 3.11 で動作確認を行っています。
J-Quants API は有償版で継続開発されているため、本ライブラリも今後仕様が変更となる可能性があります。
Python 3.7 サポートは廃止予定です。将来のバージョンではサポート対象外となります。
Please note Python 3.7 support is deprecated.開発J-Quants API Client の開発に是非ご協力ください。
Github 上で Issue や Pull Request をお待ちしております。