リファレンス on 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

財務データ

財務データを取得する方法は、大きく分けて次の 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

株主

日本の開示では株主の情報が複数の書類に分かれています。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）。