Expand description
J-Quants API v2 の非公式 Rust クライアント。
Unofficial async Rust client for the J-Quants API v2 — Japanese stock market data (equities, financials, margin trading, short selling, derivatives, indices, timely disclosure) by JPX Market Innovation & Research.
J-Quants API は JPX 総研が提供する個人投資家向けの日本株データ API。 本クレートの利用には J-Quants の契約(API キー、無料プランあり)が必要で、 取得したデータの扱いは J-Quants の利用規約に従うこと。
§クイックスタート
API キーを https://jpx-jquants.com/dashboard/api-keys で発行し、
環境変数 JQUANTS_API_KEY に設定する。
use jquants_api::{CodeDateQuery, JQuantsClient};
let client = JQuantsClient::from_env()?; // JQUANTS_API_KEY を読む
let query = CodeDateQuery {
code: Some("7203".into()),
from: Some("2026-01-01".into()),
..Default::default()
};
let bars = client.daily_bars(&query).await?;
for bar in &bars {
println!("{} close={:?} (adjusted: {:?})", bar.date, bar.close, bar.adj_close);
}§設計
- ページ分割(
pagination_key)は各メソッドが自動追従し、全件を結合して返す fins_summary/fins_details/td_listはCursorPageを返す。cursorを保存して 次回のクエリに渡すと、前回以降の差分だけ取得できる- string / number / null が混在する項目は
FlexStringで受け取る(FlexString::as_f64あり) JQuantsClient::with_plan/JQuantsClient::with_rate_limitで、契約プランの API コール制限(Free 5 件/分〜Premium 500 件/分)に合わせた自動待機を有効にできる (既定は無効)。それでもError::Api { status: 429, .. }が返ったら間隔を空けること
use jquants_api::{FinsQuery, JQuantsClient};
// 差分取得: 前回保存した cursor を渡す
let page = client
.fins_summary(&FinsQuery { cursor: saved, ..Default::default() })
.await?;
for row in &page.items {
println!("{} {} sales={}", row.disc_date, row.code, row.sales);
}
let next_cursor = page.cursor; // 保存して次回に渡すStructs§
- AmBar
- 前場終値時点の株価(
/equities/bars/daily/am) - Breakdown
- 売買内訳(
/markets/breakdown) - Bulk
GetQuery - 一括ダウンロード URL 取得(
/bulk/get)の条件 - Bulk
List Item - 一括ダウンロード可能なファイルの一覧項目(
/bulk/list) - Bulk
List Query - 一括ダウンロード一覧(
/bulk/list)の条件 - Calendar
- 営業日カレンダー(
/markets/calendar) - Calendar
Query - 営業日カレンダー(
/markets/calendar)の条件 - Code
Date Query - 銘柄コード・日付・期間の共通条件 (日足・分足・バリュエーション指標・売買内訳・日々公表信用取引残高・配当・指数日足で使用)
- Cross
Shareholding Holder - 政策保有株式の保有主体(提出会社・最大保有会社・第 2 位保有会社共通)
- Cross
Shareholding Issue - 政策保有株式の銘柄別明細(特定投資株式・みなし保有株式共通)
- Cross
Shareholdings Doc - 政策保有株式(
/edinet/cross-shareholdings)の書類 1 件 - Cursor
Page - cursor 型エンドポイント(
/fins/summary/fins/details/td/list)の結果。cursorを次回リクエストに渡すと前回以降の差分を取得できる - Daily
Bar - 株価日足(
/equities/bars/daily)。前後場・調整値を含む - Earnings
Calendar - 決算発表予定(
/equities/earnings-calendar)。3・9月期決算会社のみが対象 - Earnings
Date - 決算発表予定日(
/fins/earnings-date) - Earnings
Date Query - 決算発表予定日(
/fins/earnings-date)の条件。 API の仕様上code/date/scheduled_dateのいずれか 1 つの指定が必須 - Edinet
Query - EDINET 系エンドポイント(
/edinet/*)共通の条件。edinet_codeとcodeは同時指定できない(API 側でエラーになる) - Fins
Details - 財務諸表詳細(
/fins/details)。fsは勘定科目の可変な集合のため JSON のまま保持する - Fins
Dividend - 配当金情報(
/fins/dividend) - Fins
Query - 財務系 cursor エンドポイント(
/fins/summary/fins/details)の条件 - Fins
Summary - 財務諸表サマリー(
/fins/summary) - Flex
String - J-Quants API は同じ項目を string / number / null のいずれでも返すことがあるため、 どれで来ても文字列として受け取る newtype。null は空文字列になる。
- Futures
Bar - 先物四本値(
/derivatives/bars/daily/futures) - Futures
Bars Query - 先物四本値(
/derivatives/bars/daily/futures)の条件 - Index
Daily Bar - 指数日足(
/indices/bars/daily) - Investor
Type - 投資部門別売買状況(
/equities/investor-types) - Investor
Types Query - 投資部門別売買状況(
/equities/investor-types)の条件 - JQuants
Client - J-Quants API v2 クライアント。
- Large
Volume Holder - 大量保有報告書の提出者・共同保有者 1 名分の情報
- Large
Volume Shareholders Doc - 大量保有報告書(
/edinet/large-volume-shareholders)の書類 1 件 - Major
Shareholder - 大株主 1 名分の情報
- Major
Shareholders Doc - 大株主の状況(
/edinet/major-shareholders)の書類 1 件 - Margin
Alert - 日々公表信用取引残高(
/markets/margin-alert) - Margin
Interest - 信用取引残高(
/markets/margin-interest)。 2026-09-25 申込分以降は日次、それ以前は週末時点のデータ。 公表日と金額 6 項目は日次化以降の行にしか入らない - Margin
Interest Query - 信用取引残高(
/markets/margin-interest)の条件。 API の仕様上code/date/published_dateのいずれかの指定が必須。published_dateはdate/from/toと同時指定できない(API 側でエラーになる) - Master
Query - 上場銘柄マスタ(
/equities/master)の条件 - Minute
Bar - 株価分足(
/equities/bars/minute) - Options225
Bar - 日経225オプション四本値(
/derivatives/bars/daily/options/225) - Options
Bar - オプション四本値(
/derivatives/bars/daily/options) - Options
Bars Query - オプション四本値(
/derivatives/bars/daily/options)の条件 - PubReason
- 日々公表信用取引残高の公表理由。各フィールドは該当有無を示すフラグ
- Range
Query - 期間のみの条件(
/indices/bars/daily/topix) - Short
Ratio - 業種別空売り比率(
/markets/short-ratio) - Short
Ratio Query - 業種別空売り比率(
/markets/short-ratio)の条件 - Short
Sale Report - 空売り残高報告(
/markets/short-sale-report) - Short
Sale Report Query - 空売り残高報告(
/markets/short-sale-report)の条件 - Stock
Master - 上場銘柄マスタ(
/equities/master) - TdBulk
- 適時開示一括ダウンロード情報(
/td/bulk) - TdFiles
- 適時開示ファイル(
/td/files) - TdFiles
Inner - 適時開示ファイルの取得先 URL
- TdList
- 適時開示一覧(
/td/list) - TdList
Query - 適時開示一覧(
/td/list)の条件 - Topix
Daily Bar - TOPIX 日足(
/indices/bars/daily/topix) - Valuation
- バリュエーション指標(
/equities/valuation)。 実績値は直近12ヶ月(TTM)、fwd_*は進行期の予想にもとづく。 算出対象外の銘柄(ETF 等)は指標が null で返る
Enums§
- Error
- jquants-api の全 API が返すエラー型。
- Plan
- J-Quants の契約プラン。
JQuantsClient::with_planに渡すと プランの API コール制限に合わせたレート制限が有効になる。
Constants§
- DEFAULT_
BASE_ URL - J-Quants API v2 の本番ベース URL