jquants-api — J-Quants API v2 Rust クライアント
日本株の株価・財務・市場データを取得できる J-Quants API(JPX 総研提供)の非公式 async Rust クライアントです。株価日足・分足、財務諸表、信用取引残高、空売り比率、先物・オプション、TOPIX・指数、適時開示まで、v2 の全データ系エンドポイントを型付きで扱えます。
Unofficial async Rust client for the J-Quants API v2 — Japanese stock market data
(equities, financial statements, margin trading, short selling, derivatives, indices,
timely disclosure) provided by JPX Market Innovation & Research. Requires a J-Quants
subscription (free plan available). See llms.txt for an AI-friendly
API reference.
特徴
- J-Quants API v2 対応(
https://api.jquants.com/v2・x-api-key認証) - 全 30 データ系エンドポイントを型付きでカバー — 株価四本値(日足・前場・分足)、上場銘柄マスタ、バリュエーション指標、決算発表予定日、投資部門別売買状況、売買内訳、営業日カレンダー、信用取引残高、空売り比率・残高報告、指数・TOPIX、先物・オプション、財務諸表サマリー・詳細・配当、EDINET(大株主・政策保有株式・大量保有報告書)、適時開示、一括ダウンロード
- ページ分割の自動追従 —
pagination_keyをライブラリが処理し、全件を結合して返す - 差分取得(cursor)対応 — 財務諸表・適時開示は前回の続きから取得できる
- ゆらぎのある応答を吸収 — string / number / null が混在する項目は
FlexString(as_f64()付き)で安全に受け取る - プラン別レート制限に対応 —
with_plan(Plan::Light)で契約プランの API コール制限(Free 5 件/分〜Premium 500 件/分)に合わせて自動待機。任意の値もwith_rate_limit(件数/分)で指定可能 - ランタイムは tokio、TLS は rustls(OpenSSL 不要)
インストール
[]
= "0.3"
= { = "1", = ["full"] }
クイックスタート
API キーを J-Quants Dashboard で発行し、環境変数に設定します(無料プランで発行できます)。
use ;
async
使用例: 財務諸表を差分取得する
/fins/summary /fins/details /td/list は cursor を返します。保存しておき、次回の呼び出しに渡すと前回以降の差分だけ取得できます。
use ;
async
使用例: 営業日カレンダー・TOPIX
use ;
async
対応エンドポイント
| メソッド | エンドポイント | 内容 |
|---|---|---|
master |
/equities/master |
上場銘柄マスタ |
daily_bars |
/equities/bars/daily |
株価日足(調整前後・前後場込み) |
am_bars |
/equities/bars/daily/am |
前場終値時点の株価 |
minute_bars |
/equities/bars/minute |
株価分足 |
valuation |
/equities/valuation |
バリュエーション指標(EPS・BPS・ROE・PER・PBR・時価総額) |
earnings_calendar |
/equities/earnings-calendar |
決算発表予定(3・9月期決算会社のみ) |
investor_types |
/equities/investor-types |
投資部門別売買状況 |
breakdown |
/markets/breakdown |
売買内訳 |
trading_calendar |
/markets/calendar |
営業日カレンダー |
margin_alert |
/markets/margin-alert |
日々公表信用取引残高 |
margin_interest |
/markets/margin-interest |
信用取引残高(2026-09-25 申込分以降は日次、それ以前は週末時点) |
short_ratio |
/markets/short-ratio |
業種別空売り比率 |
short_sale_report |
/markets/short-sale-report |
空売り残高報告 |
index_daily_bars |
/indices/bars/daily |
指数日足 |
topix_daily_bars |
/indices/bars/daily/topix |
TOPIX 日足 |
futures_bars |
/derivatives/bars/daily/futures |
先物四本値 |
options_bars |
/derivatives/bars/daily/options |
オプション四本値 |
options_225_bars |
/derivatives/bars/daily/options/225 |
日経225オプション四本値 |
fins_summary |
/fins/summary |
財務諸表サマリー(cursor 対応) |
fins_details |
/fins/details |
財務諸表詳細(cursor 対応) |
fins_dividend |
/fins/dividend |
配当金情報 |
fins_earnings_date |
/fins/earnings-date |
決算発表予定日 |
edinet_major_shareholders |
/edinet/major-shareholders |
大株主の状況(Standard 以上) |
edinet_cross_shareholdings |
/edinet/cross-shareholdings |
政策保有株式(Standard 以上) |
edinet_large_volume_shareholders |
/edinet/large-volume-shareholders |
大量保有報告書(Standard 以上) |
td_list |
/td/list |
適時開示一覧(cursor 対応) |
td_bulk |
/td/bulk |
適時開示の一括ダウンロード情報 |
td_files |
/td/files |
適時開示ファイル(PDF / XBRL) |
bulk_list |
/bulk/list |
一括ダウンロード可能ファイル一覧 |
bulk_get |
/bulk/get |
一括ダウンロード URL 取得 |
株価ティック(/equities/trades)は API の仕様上 CSV ファイル提供のみのため、
専用メソッドはありません。bulk_list / bulk_get に endpoint: "/equities/trades" を
指定してダウンロード URL を取得してください。
プランとデータ範囲
利用できるエンドポイントとデータ期間は J-Quants の契約プラン(Free / Light / Standard / Premium)で異なります。目安として Free は約 2 年分(12 週遅延)、上位プランほど過去データが長く・遅延なしになります。正確な範囲は J-Quants API Reference を確認してください。
Free プランで取得できないエンドポイント・期間を指定した場合、このライブラリは Error::Api { status, message } を返します。
エラーハンドリング
use ;
async
レート制限
契約プランを指定すると、API コール制限を超えないようリクエスト間隔を自動調整します(超えそうな場合は送信を待機するだけで、エラーにはなりません)。ページ分割の内部リクエストにも 1 件ずつ適用されます。
use ;
let client = from_env?
.with_plan; // Free プラン: 5 件/分
// .with_plan(Plan::Light) // 60 件/分
// .with_plan(Plan::Standard) // 120 件/分
// .with_plan(Plan::Premium) // 500 件/分
// .with_rate_limit(30) // 任意の値(件/分)も指定可能
既定ではレート制限は無効です。プリセット値は 2026-08 時点の公式料金ページに基づくため、変更されていないか J-Quants の料金プランで確認してください。大量取得はレート制限にかかわらず bulk_list / bulk_get(一括ダウンロード)の利用を検討してください。
AI エージェント・LLM で使う
コーディングエージェント(Claude Code、Cursor、Copilot など)にこのクレートを使わせる場合:
llms.txt— 全メソッドのシグネチャ・型・注意点をまとめた機械可読リファレンス。エージェントのコンテキストに渡すとそのまま正しいコードを書けます.claude/skills/jquants-api-usage/SKILL.md— Claude Code 用のスキル定義
開発
JQUANTS_API_KEY を設定(環境変数または .env)すると tests/live_test.rs が実 API への疎通テストとして実行されます(未設定ならスキップ)。
リリース
Cargo.toml の version を上げて main に入れたあと、同じ番号のタグを push すると crates.io に公開されます。
タグと version の照合・CI が通ると公開の直前で承認待ちになり、GitHub の Actions の画面で承認したときだけ cargo publish が走ります。
注意事項
- 非公式クレートです。 JPX・JPX 総研とは無関係のコミュニティ実装で、API 仕様・利用条件の正は J-Quants 公式ドキュメントです
- J-Quants API は個人の私的利用に限定されています。取得したデータの再配布・分析結果の継続的な第三者提供は利用規約で禁止されています
- 本クレートは投資助言を行うものではありません。投資判断は自己責任で行ってください
謝辞
エンドポイント・レスポンス型の定義とフィールド説明は、JPX Market Innovation & Research, Inc. の公式 CLI J-Quants/jquants-cli(MIT License)に由来します。原著作権表示とライセンスは THIRD-PARTY-NOTICES.md を参照してください。
License
MIT または Apache-2.0 のデュアルライセンス。
Licensed under either of MIT license or Apache License 2.0 at your option.
一部に MIT ライセンスの第三者コードに由来する部分を含みます。どちらのライセンスを選択する場合も、THIRD-PARTY-NOTICES.md の著作権表示は保持してください。