jfinance

Ticker

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

Ticker

jfinance.Ticker(ticker, session=None)

1 社または 1 ファンドのデータを保持します。各属性のデータは最初に参照したときにサーバーから取得し、そのオブジェクトが存在する間は再利用します。

引数

名前	型	既定値	説明
`ticker`	`str`	—	証券コード（`"7203.T"`）、EDINET コード（`"E02144"`）、ISIN（`"JP3633400001"`）、ファンドコード（`"G02925"`）。証券コードを参照
`session`	`requests.Session`	`None`	再利用するセッション。省略時は共有セッションを作成する

import jfinance as jf

t = jf.Ticker("7203.T")
t.info["shortName"] # 'TOYOTA MOTOR CORPORATION'

多くの属性には同じ名前に get_ を付けたメソッドがあります。属性は引数を取らず、メソッドは各項目に記した引数を取ります。

一覧

属性・メソッド	掲載先
`info`、`isin`、`min_fiscal_year`、`shares`、`get_shares_full`	本ページ
`financials`、`balance_sheet`、`cashflow`、`quarterly_*`、`get_jp_financials`、`get_statements`、`get_segments`	財務データ
`major_holders`、`major_shareholders`、`institutional_holders`、`insider_roster_holders`、`large_holders`、`large_holder_transactions`、`large_holder_activity`、`large_holding_reports`	株主
`officers`、`officer_compensation`、`officer_remuneration`、`audit_fees`	役員と報酬
`sec_filings`、`filings`、`report_filing_dates`、`employees`、`emissions`、`dividend_resolutions`	提出書類と開示
`funds_data`、`get_fund_financials`	投資信託

株価、配当の履歴、株式分割、オプション、アナリスト予想、ニュース、決算発表予定、ESG スコアは EDINET に存在しません。yfinance の対応する属性は定義していません。参照すると AttributeError となります。

会社の概要

info

Ticker.info -> dict
Ticker.get_info() -> dict

会社の概要、主要な数値、役員の一覧を、yfinance のキー名で返します。上場会社では 52 個のキーを返します。EDINET に対応する記載がないキーは、空の値を入れるのではなくキー自体を返しません。

戻り値 — dict

キー	型	説明
`symbol`、`shortName`、`longName`	`str`	銘柄コードと会社名。`config.locale.lang` が `"ja-JP"` でなければ英語
`edinetCode`、`isin`、`corporateNumber`	`str`	EDINET コード、ISIN、法人番号
`sector`、`sectorKey`、`sectorCode`	`str`, `str`, `int`	TOPIX-17 の業種
`industry`、`industryKey`、`industryCode`	`str`, `str`, `int`	東証 33 業種
`market`、`marketSegment`、`topixScale`、`listingStatus`	`str`	市場と区分（`プライム（内国株式）`、`TOPIX Core30`、`listed` など）
`country`、`currency`、`financialCurrency`、`region`	`str`	日本・JPY・JP で固定
`fiscalYearEnd`	`str`	決算期。記載のまま（`3月31日`）
`lastFiscalYearEnd`、`nextFiscalYearEnd`	`int`	UNIX 秒
`fullTimeEmployees`	`int`	提出会社の従業員数
`longBusinessSummary`	`str`	事業の内容。言語設定にかかわらず日本語。EDINET に英語の原文がない
`businessSummaryDocumentId`	`str`	事業の内容の取得元となる書類の管理番号
`companyOfficers`	`list[dict]`	役員。`name`、`title`、`age`、記載があれば `totalPay` を持つ
`totalRevenue`、`grossProfits`、`netIncomeToCommon`、`operatingCashflow`、`totalCash`	`int`	直近の年度の値。単位は円
`sharesOutstanding`	`int`	発行済株式総数
`trailingEps`、`dilutedEps`、`bookValue`、`dividendRate`	`float`	1 株当たり。単位は円
`returnOnEquity`、`equityRatio`、`payoutRatio`	`float`	小数（`0.101` は 10.1%）
`capitalMillionJpy`	`int`	資本金。単位は百万円
`quoteType`	`str`	`"EQUITY"` または `"MUTUALFUND"`

currentPrice、marketCap、trailingPE、fiftyTwoWeekHigh など株価から導くキーは返しません。

インストール

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

収録範囲

本ライブラリが返すデータは、すべて EDINET（金融庁の電子開示システム）に提出された書類に基づきます。

収録期間

2016 年度以降のデータを収録しています。

t.min_fiscal_year # 2016

これより前の期間を指定した場合、例外は送出せず空の結果を返します。下限は HTTP 応答の X-JF-Min-Fiscal-Year ヘッダーからも確認できます。 1997 年度まで遡るデータセットは別途提供します。

収録件数

項目	件数
会社（EDINET コード）	13,199
うち証券コードを持つ会社	5,290
投資信託	6,527
提出書類（2016 年以降）	469,653
大量保有の保有記録	245,804
大量保有の売買明細	1,920,873
役員の記録	649,095
役員の個別報酬	103,473
財務諸表の行	4,195 万
正規化した指標	876 万

書類の種類別の内訳（2016 年以降、上位 7 種）は次のとおりです。

種類	件数
四半期報告書	95,882
大量保有の変更報告書	92,365
有価証券報告書	85,261
有価証券届出書	47,844
臨時報告書	40,742
内部統制報告書	25,993
半期報告書	21,724

データは日次で更新し、EDINET に提出された書類を翌日までに取り込みます。

データの出所

データ	出所の書類
財務諸表・指標	有価証券報告書、半期報告書、四半期報告書の XBRL
役員、役員報酬、大株主、所有者別状況、事業の内容	有価証券報告書
大量保有	大量保有報告書、変更報告書
温室効果ガス排出量	有価証券報告書（2024 年度以降）
投資信託	有価証券報告書、半期報告書（ファンド）
業種、市場区分、ISIN	EDINET コードリスト等
業種の英語名	JPX「TOPIX Sector Indices / TOPIX-17 Series」

項目ごとの収録期間

項目	収録期間	理由
財務諸表・指標	2016 年度	サーバーの設定による
四半期	2023 年度まで	2024 年 4 月に四半期報告書の制度が廃止されたため
所有者別状況（`major_holders`）	2019 年度	有価証券報告書の様式による
温室効果ガス排出量（`emissions`）	2024 年度	XBRL の要素が新設された年度

対象外の項目

項目	理由
株価、配当履歴、株式分割、オプション	EDINET は開示書類のシステムであり、市場データを扱わない
アナリスト予想、目標株価	同上
ニュース、決算発表予定	同上
ESG スコア	評価機関が作成するものであり、開示書類に含まれない
役員の売買報告	日本では EDINET に提出されない
投資信託の組入銘柄、資産配分	書類本文の表にのみ記載され、数値として抽出していない

データ利用上の注意

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

データ利用上の注意

訂正報告書の反映

財務数値、役員情報、役員報酬には、訂正報告書の内容を反映しています。

反映の有無は次の項目で確認できます。

項目	内容
`isCorrected`	訂正により値が変更されたか
`sourceDocumentId`	値の出所となる書類

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

閲覧期間（有価証券報告書は 5 年）を経過した書類は EDINET から取得できません。古い年度ほど、訂正前の値が残っている可能性が高くなります。

出典で確認できた誤りについては、サーバー側で個別に修正し、該当する行に出典の URL を付けます（correctionSource、payCorrection）。

値の選択基準

連結の値を優先し、連結が存在しない場合に単体の値を用います。同一の期に複数の書類が存在する場合は、訂正を反映した値を 1 つ選択します。

会計基準は会社ごとに異なります（日本基準、IFRS、US GAAP）。各データの会計基準は accountingStandard で確認できます。比率は小数で返します（returnOnEquity の 0.101 は 10.1%）。設備投資および配当金の支払額は支出であるため負の値となります。

日本の開示制度に起因する差異

項目	内容
`major_shareholders`	大株主は名義で記載されるため、信託銀行の信託口が上位を占める
`institutional_holders`	5% 超を保有し、特例報告を提出した機関に限る
`companyOfficers[].totalPay`	報酬が 1 億円以上の役員のみ個別に開示される。それ以外は `None`
`totalRevenue`	対応する科目が業種により異なる（売上高、営業収益、経常収益）
`insider_roster_holders`	年 1 回の有価証券報告書時点の所有株式数であり、取引履歴ではない

言語

既定の言語は英語です。会社名には EDINET に届け出られた英文社名を、業種名には JPX の英語名を使用します。

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

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

既知の制限

内容	影響する項目	備考
指標の従業員数が連結ではなく単体の人数となる年度がある	`get_jp_financials()` の `NumberOfEmployees`	有価証券報告書の「連結経営指標等」に従業員数が記載されない年度があるため。`info["fullTimeEmployees"]` および `employees` は「従業員の状況」から取得するため連結の人数となる
一部の会社で `insidersPercentHeld` を返さない	`major_holders`	役員の所有株式数の単位を判別できないため。推測による補完は行わない
投資信託の組入銘柄、資産配分、信託報酬率を返さない	`funds_data`	書類本文の表にのみ記載され、数値として抽出していない
半期報告書の期間が事業年度の期間となる	`report_filing_dates`	EDINET の書類一覧の値をそのまま用いるため
配当の基準日および株主総会の日を返さない	—	XBRL に基準日を持つ書類が 36 件にとどまり、株主総会の日に対応する要素が存在しないため

財務データ

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

財務データ

財務データを取得する方法は、大きく分けて次の 3 種類です。

属性・メソッド	内容
`financials`、`balance_sheet`、`cashflow`	財務諸表のデータを yfinance の科目に対応付けたもの
`get_jp_financials`	yfinance に同名の科目がない日本の開示項目
`get_statements`	提出された財務諸表の全科目を、提出書類と同じ順序で

財務諸表

get_income_stmt

Ticker.financials -> pandas.DataFrame
Ticker.income_stmt -> pandas.DataFrame
Ticker.get_income_stmt(as_dict=False, pretty=False, freq="yearly")
Ticker.get_financials(as_dict=False, pretty=False, freq="yearly")

損益計算書を返します。financials、income_stmt、incomestmt、get_financials は yfinance と同じく同一のデータを指す別名です。

引数

名前	型	既定値	説明
`as_dict`	`bool`	`False`	`DataFrame` ではなく `dict` で返す
`pretty`	`bool`	`False`	行名をキー（`TotalRevenue`）ではなく空白区切り（`Total Revenue`）にする
`freq`	`str`	`"yearly"`	`"yearly"`・`"semiannual"`・`"quarterly"`。`"trailing"` は `ValueError` となる

戻り値 — pandas.DataFrame。行は科目、列は期末日（新しい順）です。単位は円です。

 2026-03-31 2025-03-31
Total Revenue 48036704000000 45095325000000
Operating Income 4795586000000 5352934000000
Net Income 4765840000000 4765096000000

返される可能性のあるキーは財務項目のキーに掲載しています。対応するデータがないキーは、yfinance と同じく行そのものが出ません。そのため、どの行が並ぶかは会社と期間によって変わります。

証券コード

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

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

株主

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

株主

日本の開示では株主の情報が複数の書類に分かれています。jfinance はこれらを統合せず、書類ごとに分けて返します。

属性	出所
`major_holders`	有価証券報告書「所有者別状況」
`major_shareholders`	有価証券報告書「大株主の状況」
`institutional_holders`	大量保有報告書（特例対象株券等）
`insider_roster_holders`	有価証券報告書「役員の状況」
`large_holders`、`large_holder_transactions`、`large_holder_activity`、`large_holding_reports`	大量保有報告書

有価証券報告書に基づく情報

get_major_holders

Ticker.major_holders -> pandas.DataFrame
Ticker.get_major_holders(as_dict=False) -> pandas.DataFrame | dict

有価証券報告書の「所有者別状況」に基づく、区分ごとの所有割合を返します。2019 年度の有価証券報告書から取得できます。

引数

名前	型	既定値	説明
`as_dict`	`bool`	`False`	`DataFrame` ではなく `dict` で返す

戻り値 — pandas.DataFrame。列は Value の 1 列で、行は次のキーです。

行	型	説明
`institutionsPercentHeld`	`float`	金融機関＋証券会社＋外国法人
`institutionsCount`	`float`	その所有者数
`insidersPercentHeld`	`float`	役員の所有分
`financialInstitutionsPercentHeld`	`float`	金融機関
`financialServiceProvidersPercentHeld`	`float`	証券会社
`otherCorporationsPercentHeld`	`float`	その他の法人
`foreignCorporationsPercentHeld`	`float`	外国法人
`foreignIndividualsPercentHeld`	`float`	外国人個人
`individualsAndOthersPercentHeld`	`float`	個人その他
`asOfDate`	`int`	基準日。UNIX 秒
`sourceDocumentId`	`str`	EDINET の書類管理番号

割合は小数で表します（0.8669 は 86.69%）。役員の所有株式数の単位が書類から読み取れない場合、 insidersPercentHeld は返しません。値を推測して補完することはありません。

役員と報酬

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

役員と報酬

役員情報は、有価証券報告書で年 1 回開示されます。これらのメソッドは各年度の開示時点の情報を返すもので、就任・退任の履歴は含みません。いずれも訂正報告書を反映した値を返します。

役員

get_officers

Ticker.officers -> pandas.DataFrame
Ticker.get_officers(year=None) -> pandas.DataFrame

有価証券報告書の「役員の状況」を返します。

引数

名前	型	既定値	説明
`year`	`int`	`None`	会計年度。省略時は最新の有価証券報告書。指定できる年度は `.attrs["years"]` で確認できる

戻り値 — pandas.DataFrame。1 名につき 1 行です。

列	型	説明
`Name`	`str`	氏名。提出書類の記載どおり
`Title`	`str`	役職
`Birth Date`	`datetime64`	生年月日
`Term Of Office`	`str`	任期。提出書類の記載どおり
`Shares Held`	`float`	所有株式数（株に換算）。単位が読み取れない場合は `NaN`
`Shares Held Raw`、`Shares Unit`	`float`, `str`	提出書類に記載された数値と単位
`Is Proposal`	`bool`	株主総会で選任される予定の候補は `True`
`Source`	`str`	XBRL の値なら `xbrl`、書類の HTML から読んだ値なら `textblock_html`
`Document ID`	`str`	EDINET の書類管理番号

報酬

get_officer_compensation

Ticker.officer_compensation -> pandas.DataFrame
Ticker.get_officer_compensation(as_dict=False) -> pandas.DataFrame | dict

役員の個別報酬を全年度について返します。日本では連結報酬等の総額が 1 億円以上の役員に限って個別開示が義務づけられるため、大半の役員は結果に含まれません。

提出書類と開示

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

提出書類と開示

提出書類の一覧と、有価証券報告書に記載された従業員、配当、温室効果ガス排出量の情報を扱います。

提出書類

sec_filings

Ticker.sec_filings -> list[dict]
Ticker.get_sec_filings() -> list[dict]

直近 100 件の提出書類を新しい順に、yfinance のキー名で返します。絞り込みとページ送りには get_filings を用います。

戻り値 — list[dict]

キー	型	説明
`date`	`datetime.date`	提出日
`epochDate`	`int`	提出日。UNIX 秒
`type`	`str`	書類の種類（`自己株券買付状況報告書` など）
`title`	`str`	書類の表題
`documentId`	`str`	EDINET の書類管理番号（`S100Z1LW` など）
`docTypeCode`	`str`	EDINET の書類種別コード（`"220"` など）
`edgarUrl`	`None`	yfinance との互換性を保つために設けたキーで、常に `None`

get_filings

Ticker.filings -> pandas.DataFrame
Ticker.get_filings(types=None, year=None, limit=100, offset=0) -> pandas.DataFrame

その会社について提出された書類を新しい順に返します。limit と offset で取得する範囲を指定できます。総件数は .attrs["total"] で確認できます。

引数

名前	型	既定値	説明
`types`	`list[str]`	`None`	書類種別コードのリスト（`["120", "130"]` で有価証券報告書とその訂正）。省略時はすべて
`year`	`int`	`None`	会計年度。省略時はすべての年度
`limit`	`int`	`100`	返す行数。最大 1000
`offset`	`int`	`0`	読み飛ばす行数

戻り値 — pandas.DataFrame

投資信託

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

投資信託

ファンドは、G で始まる EDINET のファンドコードで指定します。上場しているファンドは、証券コードでも指定できます。

f = jf.Ticker("1306.T") # "G02925" でも同じ
f.get_fund_financials()

get_fund_financials

Ticker.get_fund_financials(freq="yearly", start=None) -> pandas.DataFrame

ファンドの報告書に記載される25 の財務項目を返します。

引数

名前	型	既定値	説明
`freq`	`str`	`"yearly"`	`"yearly"` または `"semiannual"`。ファンドに四半期の報告書はなく、直近 12 か月の値も存在しない
`start`	`str`	`None`	返す期末日の下限（`"2020-07-10"` など）。省略時はすべての期

戻り値 — pandas.DataFrame。行は項目、列は期末日（新しい順）です。

行	説明
`FundNetAssets`、`FundTotalAssets`、`FundTotalLiabilities`	純資産、資産、負債の合計
`FundPrincipal`、`FundPrincipalAndOther`、`FundSurplus`	元本と剰余金
`FundNavPerUnit`	1 口当たり純資産額
`FundDividends`、`FundUnpaidDividends`、`FundReserveForDistribution`	分配金、未払分配金、分配準備積立金
`FundManagementFee`、`FundTrusteeFee`、`FundOperatingExpenses`、`FundOtherExpenses`	信託報酬と費用
`FundOperatingRevenue`、`FundOperatingIncome`、`FundOrdinaryIncome`、`FundProfitLoss`	営業収益、営業利益、経常利益、当期純利益
`FundInterestIncome`、`FundInterestExpenses`、`FundDividendsIncome`	受取利息、支払利息、受取配当金
`FundTradingPl`、`FundFxPl`	売買損益、為替差損益
`FundCallLoans`、`FundParentTrustSecurities`	コール・ローン、親投資信託受益証券

金額の単位は円です。

シリーズ

1 つのファンドコードが複数のシリーズを含む場合、シリーズ番号を付けて指定します。

jf.Ticker("G07695-001").get_fund_financials()

シリーズを指定しない場合は、シリーズに属さない行だけを返します。

funds_data

Ticker.funds_data -> FundsData | None
Ticker.get_funds_data() -> FundsData | None

ファンドの概要を yfinance の FundsData 形式で返します。

検索・業種・スクリーナー

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

検索・業種・スクリーナー

検索

Search

jfinance.Search(query, max_results=8, session=None, timeout=30, raise_errors=True)

名称またはコードから会社・ファンドを検索します。

引数

名前	型	既定値	説明
`query`	`str`	—	会社名、証券コード、EDINET コード
`max_results`	`int`	`8`	返す件数の上限
`session`	`requests.Session`	`None`	再利用するセッション
`timeout`	`int`	`30`	秒
`raise_errors`	`bool`	`True`	HTTP エラー時に例外を送出する。`False` なら空の結果を返す

news_count、lists_count、include_research など yfinance のその他の引数も受け取りますが、処理には使用しません。EDINET に該当するデータがないためです。

属性

名前	型	説明
`quotes`	`list[dict]`	該当した銘柄。`symbol`、`shortname`、`longname`、`quoteType`、`exchange`、`score` を持つ
`all`	`dict`	`{"quotes": [...]}`。`news`・`lists`・`research` は含まない
`response`	`dict`	サーバーの応答そのもの

jf.Search("トヨタ").quotes[0]["symbol"] # '3116.T'

Lookup

jfinance.Lookup(query, session=None, timeout=30, raise_errors=True)

Search と同じ検索結果を表形式で返します。

メソッド

メソッド	取得対象
`get_all(count=25)`	すべて
`get_stock(count=25)`	株式
`get_etf(count=25)`	ETF
`get_mutualfund(count=25)`	投資信託

all、stock、etf、mutualfund は、それぞれ対応するメソッドを既定の件数で呼び出した結果を返します。

設定

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

設定

設定はプロセス全体に適用されます。

設定項目

config

jfinance.config

yfinance と共通の設定オブジェクトです。

設定	型	既定値	説明
`config.locale.lang`	`str`	`"en-US"`	`"ja-JP"` にすると会社名と業種名を日本語で返す
`config.locale.region`	`str`	`"US"`	地域
`config.network.proxy`	`str`	`None`	HTTP プロキシ
`config.network.retries`	`int`	`0`	失敗したリクエストの再試行回数
`config.debug.logging`	`bool`	`False`	リクエストと応答を記録する
`config.debug.hide_exceptions`	`bool`	`True`	属性の参照中に発生した例外を抑制する

jf.config.locale.lang = "ja-JP"
jf.Ticker("7203.T").info["shortName"] # 'トヨタ自動車株式会社'

英語の原文がない値（事業の内容、役員・株主の氏名）は、言語設定にかかわらず日本語で返します。

set_base_url

jfinance.set_base_url(url) -> None
jfinance.get_base_url() -> str

接続先のサーバーを変更します。既定値は jfinance.DEFAULT_BASE_URL（https://query1.jfnc.org）です。

引数

名前	型	説明
`url`	`str`	接続先（`"http://localhost:8080"` など）

jf.set_base_url("http://localhost:8080")

enable_debug_mode

jfinance.enable_debug_mode() -> None

リクエストと応答をすべて記録します。config.debug.logging を True に設定するのと同じです。

例外

yfinance 向けに書かれたコードがそのまま動くよう、例外の名前は YF の接頭辞を含め yfinance のままとしています。

例外	基底クラス	送出される場面
`YFException`	`Exception`	以下の例外に共通する基底クラス
`YFRateLimitError`	`YFException`	レート制限（HTTP 429）。`Retry-After` ヘッダーの秒数だけ待って再試行する
`YFDataException`	`YFException`	応答が想定した形式と異なる
`YFTickerMissingError`	`YFException`	指定した銘柄が存在しない
`YFNotImplementedError`	`NotImplementedError`	互換性を保つために設けたが、EDINET に対応するデータがない

from jfinance.exceptions import YFRateLimitError

try:
 t.info
except YFRateLimitError:
 ...

その他の HTTP エラーでは requests.HTTPError がそのまま伝播します。レート制限については利用条件を参照してください。

財務項目のキー

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

財務項目のキー

yfinance 1.5.2 が要求する 371 個の財務キーのうち、jfinance が値を返すキーを掲載しています。ここにないキーは、行そのものが出ません（yfinance と同じ挙動です）。表に並ぶのは、その会社が実際に開示している項目だけで、順序は yfinance に合わせています。

科目：日本の開示書類で使われる名称です。概念辞書とスクリーナーの表示名に基づきます。
Ticker.financials などの行名は、英語のキーを単語ごとに空白で区切った表記です（TotalRevenue なら Total Revenue）。get_financials(pretty=False) ではキーをそのまま使います。
状態：「対応」は意味が一致する項目、「注意」は値を返すものの、会計基準・業種・符号によって解釈に注意が必要な項目です。
金額と 1 株当たりの値の単位は円、株式数の単位は株です。比率は小数で表します（0.101 は 10.1%）。

損益計算書（income_stmt / financials）

キー	科目	状態	備考
`NetIncomeFromContinuingOperationNetMinorityInterest`	当期純利益	注意	非継続事業を分けていない
`ReconciledDepreciation`	減価償却費	対応
`ReconciledCostOfRevenue`	売上原価	対応
`InterestExpense`	支払利息	対応
`InterestIncome`	資金運用収益	対応
`TotalOperatingIncomeAsReported`	営業利益	対応
`DilutedEPS`	潜在株式調整後EPS	対応
`BasicEPS`	1株当たり純利益(EPS)	対応
`NetIncomeCommonStockholders`	当期純利益	対応
`NetIncome`	当期純利益	対応	親会社株主に帰属する当期純利益
`MinorityInterests`	非支配株主帰属当期純利益	対応	非支配株主に帰属する当期純利益
`TaxProvision`	法人税等合計	対応
`PretaxIncome`	税引前利益	対応
`InterestExpenseNonOperating`	支払利息	対応
`InterestIncomeNonOperating`	資金運用収益	対応
`OperatingIncome`	営業利益	対応	IFRS 採用企業では、営業利益の定義が日本基準と異なる
`DepreciationAndAmortizationInIncomeStatement`	減価償却費	注意	キャッシュ・フロー計算書の減価償却費を使用する
`ResearchAndDevelopment`	研究開発費	注意	販売費及び一般管理費の内訳ではなく、注記に記載された研究開発費の総額を使用する
`SellingGeneralAndAdministration`	販売費及び一般管理費	対応
`GrossProfit`	売上総利益	対応
`CostOfRevenue`	売上原価	対応
`TotalRevenue`	売上高	注意	業種によって対応する科目が異なる（売上高・営業収益・経常収益）。業種ごとの代表科目を使用する
`OperatingRevenue`	売上高	注意	TotalRevenue と同じ値を返す

貸借対照表（balance_sheet）

キー	科目	状態	備考
`OrdinarySharesNumber`	発行済株式総数	注意	発行済株式総数（自己株式を含む）
`ShareIssued`	発行済株式総数	対応
`TotalEquityGrossMinorityInterest`	純資産	対応	純資産合計（非支配株主持分を含む）
`MinorityInterest`	非支配株主持分	対応
`RetainedEarnings`	利益剰余金	対応
`CapitalStock`	資本金	対応
`CommonStock`	資本金	対応
`TotalLiabilitiesNetMinorityInterest`	負債合計	対応
`TotalAssets`	総資産	対応
`Goodwill`	のれん	対応
`CashAndCashEquivalents`	現金及び現金同等物	注意	キャッシュ・フロー計算書の期末残高。貸借対照表の現金及び預金とは異なる
`CashFinancial`	現金及び預金	注意	日本基準の貸借対照表に記載された現金及び預金

キャッシュ・フロー計算書（cashflow）

キー	科目	状態	備考
`CapitalExpenditure`	有形固定資産の取得による支出	注意	支出のため負の値。キャッシュ・フロー計算書に記載された値を使用する
`EndCashPosition`	現金及び現金同等物	対応
`FinancingCashFlow`	財務CF	対応
`CashFlowFromContinuingFinancingActivities`	財務CF	対応
`CashDividendsPaid`	配当金の支払額	注意	支出のため負の値
`CommonStockDividendPaid`	配当金の支払額	注意	同上
`InvestingCashFlow`	投資CF	対応
`CashFlowFromContinuingInvestingActivities`	投資CF	対応
`OperatingCashFlow`	営業CF	対応
`CashFlowFromContinuingOperatingActivities`	営業CF	対応
`DepreciationAmortizationDepletion`	減価償却費	対応
`DepreciationAndAmortization`	減価償却費	対応

日本の開示に固有の項目（企業）

Yahoo に同名のキーがない、日本の開示に固有の項目です。Ticker.get_jp_financials() で取得できます。HTTP では annual・quarterly・semiannual の接頭辞を付けて type= に指定します（例：annualOrdinaryIncome）。

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 タクソノミからの引用です。

jfinance

Ticker

Ticker

一覧

会社の概要

info

インストール

インストール

基本的な使い方

言語設定

複数銘柄の取得

関連ページ

収録範囲

収録範囲

収録期間

収録件数

データの出所

項目ごとの収録期間

対象外の項目

データ利用上の注意

データ利用上の注意

訂正報告書の反映

値の選択基準

日本の開示制度に起因する差異

言語

既知の制限

財務データ

財務データ

財務諸表

get_income_stmt

証券コード

証券コード

会社とファンドの区別

存在しない銘柄

銘柄の検索

株主

株主

有価証券報告書に基づく情報

get_major_holders

役員と報酬

役員と報酬

役員

get_officers

報酬

get_officer_compensation

提出書類と開示

提出書類と開示

提出書類

sec_filings

get_filings

投資信託

投資信託

get_fund_financials

シリーズ

funds_data

検索・業種・スクリーナー

検索・業種・スクリーナー

検索

Search

Lookup

設定

設定

設定項目

config

set_base_url

enable_debug_mode

例外

財務項目のキー

財務項目のキー

損益計算書（income_stmt / financials）

貸借対照表（balance_sheet）

キャッシュ・フロー計算書（cashflow）

日本の開示に固有の項目（企業）

REST API

REST API

何があるか

応答ヘッダー

言語

制限

株価のエンドポイント