ドキュメント on jfinance

インストール

Mon, 01 Jan 0001 00:00:00 +0000

インストール

pip install jfinance

Python 3.9 以降に対応しています。pandas、numpy、requests および pytz は依存パッケージとして同時にインストールされます。curl_cffi がインストールされている環境では、通信に curl_cffi を使用します。

利用登録や API キーは不要です。

基本的な使い方

import jfinance as jf

t = jf.Ticker("7203.T") # トヨタ自動車

t.info # 会社の概要（dict）
t.financials # 損益計算書、年次（DataFrame）
t.balance_sheet # 貸借対照表
t.cashflow # キャッシュ・フロー計算書
t.quarterly_financials # 四半期（2023 年度まで）
t.major_holders # 所有者別状況
t.sec_filings # 提出書類

戻り値の型は yfinance と同一です（DataFrame、dict、list）。

言語設定

会社名と業種名は、既定では英語で返します。日本語で取得する場合は次のように設定します。

import jfinance as jf
jf.config.locale.lang = "ja-JP"

jf.Ticker("7203.T").info["shortName"] # 'トヨタ自動車株式会社'

事業の内容、役員および株主の氏名、書類の種類と表題、市場区分については英語の出典が存在しません。これらは言語設定にかかわらず日本語で返します。機械翻訳は行いません。

英文社名を届け出ていない会社（証券コードを持つ会社の約 23%）は、英語設定でも和文社名を返します。

複数銘柄の取得

ts = jf.Tickers("7203.T 6758.T 9984.T")
ts.tickers["7203.T"].financials

証券コード

Mon, 01 Jan 0001 00:00:00 +0000

証券コード

Ticker には、次のいずれかの形式で銘柄を指定できます。

形式	例	対象
証券コード + `.T`	`7203.T`	上場会社
証券コード（4 桁）	`7203`	上場会社
EDINET コード	`E02144`	会社（非上場を含む）
ISIN	`JP3633400001`	上場会社
ファンドコード	`G02925`	投資信託

jf.Ticker("7203.T") # いずれも同一の会社を指す
jf.Ticker("7203")
jf.Ticker("E02144")
jf.Ticker("JP3633400001")

2024 年以降に付番された英字を含む証券コードも、そのまま指定できます。

jf.Ticker("130A.T")

会社とファンドの区別

会社とファンドは、EDINET コードの先頭の文字で区別できます。

先頭	種別	取得できるデータ
`E`	会社	財務諸表、役員、株主、大量保有報告書など
`G`	ファンド	ファンドの財務（`get_fund_financials()`）

f = jf.Ticker("1306.T") # 上場投信。"G02925" でも指定できる
f.get_fund_financials()

ファンドに対して会社向けの属性を参照した場合、例外は送出せず空の結果を返します。

存在しない銘柄

存在しない証券コードを指定した場合、多くの属性は例外を送出せず空の結果を返します。

jf.Ticker("9ZZZ.T").financials # 空の DataFrame

銘柄の検索

コードがわからない場合は、検索機能を利用できます。

jf.Search("トヨタ").quotes
jf.Lookup("7203").all

詳細は検索・業種・スクリーナーを参照してください。

REST API

Mon, 01 Jan 0001 00:00:00 +0000

REST API

Python 以外の環境からも、HTTP API を通じて同じデータを取得できます。

https://query1.jfnc.org

認証は不要です。応答は JSON 形式で返します。

API リファレンスを開く

リファレンスには、すべてのエンドポイントと引数、そして実際の応答例が載っています。稼働しているサーバから生成しているため、実物とずれることがありません。 このページは入口だけです。

何があるか


Yahoo と同じ形のエンドポイント	yfinance のクライアントの接続先を `query1.finance.yahoo.com` からこのサーバに変えるだけで、そのまま動きます
`/jf/v1/…`	jfinance 独自のエンドポイント。役員、大株主、セグメント、財務諸表の全科目、提出書類、業種、スクリーナー
`/jf/v1/holders/…`	保有者起点。その保有者が何を持ち、何を提出し、何を売買したか

curl 'https://query1.jfnc.org/jf/v1/ticker/7203.T/officers'
curl 'https://query1.jfnc.org/ws/fundamentals-timeseries/v1/finance/timeseries/7203.T?type=annualTotalRevenue'

銘柄の書き方は Python クライアントと同じです。証券コードを参照してください。

応答ヘッダー

ヘッダー	内容
`X-JF-Notice`	訂正報告書に関する注意
`X-JF-Min-Fiscal-Year`	収録期間の下限（`2016`）
`X-JF-Cache`	`hit`、`miss` または `stale`

言語

日本語で取得する場合は ?lang=ja を付けます。

制限

レート制限、1 リクエストあたりの上限および夜間の更新については利用条件を参照してください。

株価のエンドポイント

/v8/finance/chart/{symbol} および /v7/finance/options/{symbol} は、 yfinance 互換のクライアントが動作するよう空の応答を返します。データの値は含まれません。

利用条件

Mon, 01 Jan 0001 00:00:00 +0000

利用条件

最終更新 2026-09-25

本サービスについて

https://query1.jfnc.org は、EDINET の開示データを yfinance と同一の形式で返す API です。無料で利用でき、認証は不要です。個人が運営しており、法人の事業として提供するものではありません。

本サービスは投資助言を目的としません。投資判断に用いた結果について一切の責任を負いません。

免責

本サービスは現状有姿で提供します。データの正確性、完全性および最新性を保証しません。 SLA は定めません。予告なく停止、遅延、仕様変更または終了することがあります。

データに誤りがあった場合の修正義務を負いません。判明した範囲で修正しますが、期限は定めません。

特に、EDINET の閲覧期間が満了した書類に対する訂正報告書は取得できず、反映されない場合があります。

レート制限

項目	値
上限	IP アドレスごとに 60 回
回復	1 秒あたり 0.5 回
超過時	HTTP `429`（`Retry-After: 10`）
計上の対象	データベースを参照したリクエストのみ（キャッシュからの応答は計上しない）

通常の利用でも上限に達することがあります。info を 1 回参照するだけで複数のリクエストが発生するため、多数の銘柄を連続して処理すると上限に達します。Retry-After に従って待機するか、自身でサーバーを運用することを検討してください。

1 リクエストあたりの上限

項目	上限
`modules` の個数	40
`type` の個数	400
`symbols` の個数	20
銘柄の文字数	20

夜間の更新

毎日 20:30 頃から約 1 時間、データベースを更新します。この間はキャッシュから応答し、キャッシュが存在しないリクエストには 503 を返します。

ライセンスと出典

Mon, 01 Jan 0001 00:00:00 +0000

ライセンスと出典

ソースコードとデータではライセンスが異なります。

対象	ライセンス
`jfinance`（Python ライブラリ）	Apache License 2.0
API が返すデータ	EDINET の利用条件による（本ライブラリが許諾するものではない）
ラベル（科目名、財務諸表の名称等）	EDINET タクソノミの条件による

ソースコード

jfinance は Apache License 2.0 のもとで提供します。

同梱しているソフトウェアは次のとおりです。

jfinance は yfinance 1.5.2 のソースコードの一部を複製しています。複製の範囲および変更内容は、配布物の NOTICE と tools/vendor_yfinance.py に記録しています。

データの出典

本データを再配布または再公開する場合は、以下の出典表示が必要です。

出典：EDINET閲覧（提出）サイト（https://disclosure2.edinet-fsa.go.jp/）、
 PDL1.0（https://www.digital.go.jp/resources/open_data/public_data_license_v1.0）

EDINET閲覧（提出）サイト（https://disclosure2.edinet-fsa.go.jp/）をもとに jfinance 作成

EDINET のコンテンツは公共データ利用規約（第 1.0 版）に基づいて利用しています。

本ライブラリは値の選択、訂正報告書の反映および yfinance 形式への再構成を行っており、規約にいう編集・加工に該当します。

規約では、国が作成した未加工の情報として公表または利用することを禁止しています。

同じ出典表示は、API からも取得できます。

curl https://query1.jfnc.org/

EDINET タクソノミ

科目名、財務諸表の名称およびセグメント名等のラベルは、EDINET タクソノミからの引用です。

ドキュメント on jfinance

インストール

インストール

基本的な使い方

言語設定

複数銘柄の取得

関連ページ

証券コード

証券コード

会社とファンドの区別

存在しない銘柄

銘柄の検索

REST API

REST API

何があるか

応答ヘッダー

言語

制限

株価のエンドポイント

利用条件

利用条件

本サービスについて

免責

レート制限

1 リクエストあたりの上限

夜間の更新

ライセンスと出典

ライセンスと出典

ソースコード

データの出典

EDINET タクソノミ