Skip to main content

Crate jquants_api

Crate jquants_api 

Source
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)
BulkGetQuery
一括ダウンロード URL 取得(/bulk/get)の条件
BulkListItem
一括ダウンロード可能なファイルの一覧項目(/bulk/list)
BulkListQuery
一括ダウンロード一覧(/bulk/list)の条件
Calendar
営業日カレンダー(/markets/calendar)
CalendarQuery
営業日カレンダー(/markets/calendar)の条件
CodeDateQuery
銘柄コード・日付・期間の共通条件 (日足・分足・バリュエーション指標・売買内訳・日々公表信用取引残高・配当・指数日足で使用)
CrossShareholdingHolder
政策保有株式の保有主体(提出会社・最大保有会社・第 2 位保有会社共通)
CrossShareholdingIssue
政策保有株式の銘柄別明細(特定投資株式・みなし保有株式共通)
CrossShareholdingsDoc
政策保有株式(/edinet/cross-shareholdings)の書類 1 件
CursorPage
cursor 型エンドポイント(/fins/summary /fins/details /td/list)の結果。 cursor を次回リクエストに渡すと前回以降の差分を取得できる
DailyBar
株価日足(/equities/bars/daily)。前後場・調整値を含む
EarningsCalendar
決算発表予定(/equities/earnings-calendar)。3・9月期決算会社のみが対象
EarningsDate
決算発表予定日(/fins/earnings-date)
EarningsDateQuery
決算発表予定日(/fins/earnings-date)の条件。 API の仕様上 code / date / scheduled_date のいずれか 1 つの指定が必須
EdinetQuery
EDINET 系エンドポイント(/edinet/*)共通の条件。 edinet_code と code は同時指定できない(API 側でエラーになる)
FinsDetails
財務諸表詳細(/fins/details)。fs は勘定科目の可変な集合のため JSON のまま保持する
FinsDividend
配当金情報(/fins/dividend)
FinsQuery
財務系 cursor エンドポイント(/fins/summary /fins/details)の条件
FinsSummary
財務諸表サマリー(/fins/summary)
FlexString
J-Quants API は同じ項目を string / number / null のいずれでも返すことがあるため、 どれで来ても文字列として受け取る newtype。null は空文字列になる。
FuturesBar
先物四本値(/derivatives/bars/daily/futures)
FuturesBarsQuery
先物四本値(/derivatives/bars/daily/futures)の条件
IndexDailyBar
指数日足(/indices/bars/daily)
InvestorType
投資部門別売買状況(/equities/investor-types)
InvestorTypesQuery
投資部門別売買状況(/equities/investor-types)の条件
JQuantsClient
J-Quants API v2 クライアント。
LargeVolumeHolder
大量保有報告書の提出者・共同保有者 1 名分の情報
LargeVolumeShareholdersDoc
大量保有報告書(/edinet/large-volume-shareholders)の書類 1 件
MajorShareholder
大株主 1 名分の情報
MajorShareholdersDoc
大株主の状況(/edinet/major-shareholders)の書類 1 件
MarginAlert
日々公表信用取引残高(/markets/margin-alert)
MarginInterest
信用取引残高(/markets/margin-interest)。 2026-09-25 申込分以降は日次、それ以前は週末時点のデータ。 公表日と金額 6 項目は日次化以降の行にしか入らない
MarginInterestQuery
信用取引残高(/markets/margin-interest)の条件。 API の仕様上 code / date / published_date のいずれかの指定が必須。 published_date は date / from / to と同時指定できない(API 側でエラーになる)
MasterQuery
上場銘柄マスタ(/equities/master)の条件
MinuteBar
株価分足(/equities/bars/minute)
Options225Bar
日経225オプション四本値(/derivatives/bars/daily/options/225)
OptionsBar
オプション四本値(/derivatives/bars/daily/options)
OptionsBarsQuery
オプション四本値(/derivatives/bars/daily/options)の条件
PubReason
日々公表信用取引残高の公表理由。各フィールドは該当有無を示すフラグ
RangeQuery
期間のみの条件(/indices/bars/daily/topix)
ShortRatio
業種別空売り比率(/markets/short-ratio)
ShortRatioQuery
業種別空売り比率(/markets/short-ratio)の条件
ShortSaleReport
空売り残高報告(/markets/short-sale-report)
ShortSaleReportQuery
空売り残高報告(/markets/short-sale-report)の条件
StockMaster
上場銘柄マスタ(/equities/master)
TdBulk
適時開示一括ダウンロード情報(/td/bulk)
TdFiles
適時開示ファイル(/td/files)
TdFilesInner
適時開示ファイルの取得先 URL
TdList
適時開示一覧(/td/list)
TdListQuery
適時開示一覧(/td/list)の条件
TopixDailyBar
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