J-Quants CLI

J-Quants API V2 を利用して日本株式市場のデータを取得できる CLI ツール jquants の使い方を説明します。

前提条件

• アカウント登録: J-Quants API V2 を利用するにはアカウント登録が必要です。
• プラン選択: データ取得には Free / Light / Standard / Premium のいずれかのプランを選択してください。なお、プランによってアクセスできるエンドポイントが異なりますので、ご注意ください。

インストール

Homebrew（macOS / Linux）

brew install J-Quants/tap/jquants

GitHub Releases

Releases ページから各プラットフォーム向けのビルド済みバイナリをダウンロードし、PATH の通ったディレクトリに配置してください。

認証(セットアップ)

推奨: OAuth2 ブラウザログイン

jquants login

実行するとブラウザが自動で開き、J-Quants アカウントでログインすると API Key が ~/.config/jquants/credentials.json に保存されます。以降は API Key を明示的に指定する必要はありません。

API Key を直接指定（代替手段）

環境変数または .env ファイルで設定できます。

export JQUANTS_API_KEY=your_api_key_here

API Key は J-Quants Dashboard から取得してください。

認証優先順位: ~/.config/jquants/credentials.json の api_key → JQUANTS_API_KEY 環境変数 → エラー

ログアウト

jquants logout

ブラウザでログインセッションをクリアし、~/.config/jquants/credentials.json を削除します。

AI Agent 連携

本ツールには AI Agent（Claude Code 等）向けの Skills ファイルが同梱されています。以下のコマンドでインストールしてください。

npx skills add J-Quants/j-quants-cli

基本的な使い方

グローバルオプションの位置

--output、--save、--fields はすべてサブコマンドの前に指定する必要があります。

# ✅ 正しい
jquants --output csv eq daily --code 86970
jquants --output json --save out.json eq master

出力フォーマット

--output（-o）フラグで出力形式を選択します。

jquants eq daily --code 86970                       # テーブル表示（デフォルト）
jquants --output json eq daily --code 86970         # JSON 出力（全フィールド）
jquants --output csv eq master                      # CSV 出力
jquants --output parquet --save out.parquet eq daily --code 86970  # Parquet 保存

フィールド選択

--fields（-f）で取得するフィールドを絞り込めます。フィールド名は JSON / CSV のキー名（API のフィールド名）を使用します。テーブル表示の省略列名とは異なります。

# 銘柄コード・日付・調整済み終値のみ取得
jquants -f Date,Code,AdjC eq daily --code 86970

# 複数フィールドを CSV で保存
jquants --output csv --save prices.csv -f Date,Code,Open,High,Low,Close,Volume eq daily --code 86970

フィールド名の確認方法

jquants schema <endpoint> でフィールド一覧を確認できます（例: jquants schema eq.daily）。
存在しないフィールド名を -f に指定すると、「利用可能フィールド」がエラーメッセージに一覧表示されます。

ファイル保存

--save <PATH> でファイルに保存します。--output と組み合わせて使用します。

jquants --output csv --save master.csv eq master
jquants --output json --save daily.json eq daily --code 86970
jquants --output parquet --save daily.parquet eq daily --code 86970

パイプ接続時の自動 CSV 切替

stdout がパイプ先に接続されている場合（TTY 非検出）、--output table でも自動的に CSV 形式で出力されます。

jquants eq master | head -5
jquants eq master | awk -F, '{print $3}'
jquants eq daily --code 86970 | python3 script.py

コマンドリファレンス

eq — 株式

株価・株式銘柄一覧・投資部門別データを取得します。

mkt — 市場

売買内訳・信用残高・空売り・取引カレンダーなどの市場データを取得します。

fins — 財務

財務諸表・配当情報・財務サマリーを取得します。

idx — 指数

TOPIX および各種指数の日次データを取得します。

deriv — デリバティブ

先物・オプションの日次データを取得します。

bulk — バルクダウンロード

複数銘柄・長期間などを GZ 圧縮 CSV で一括取得するためのコマンドです。

シェル補完の設定

jquants completions でシェル補完スクリプトを生成できます。

jquants completions bash > ~/.config/bash/completions/jquants.bash
# ~/.bashrc に追記
source ~/.config/bash/completions/jquants.bash

よくある間違いと対処法