財務データ
財務データを取得する方法は、大きく分けて次の 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 と同じく行そのものが出ません。 そのため、どの行が並ぶかは会社と期間によって変わります。
get_balance_sheet
Ticker.balance_sheet -> pandas.DataFrame
Ticker.get_balance_sheet(as_dict=False, pretty=False, freq="yearly")貸借対照表を返します。balancesheet、get_balancesheet は別名です。引数と戻り値の形式は
get_income_stmt と同じです。
get_cash_flow
Ticker.cashflow -> pandas.DataFrame
Ticker.get_cash_flow(as_dict=False, pretty=False, freq="yearly")キャッシュ・フロー計算書を返します。cash_flow、get_cashflow は別名です。引数と戻り値の形式は
get_income_stmt と同じです。
四半期・半期の属性
quarterly_financials、quarterly_income_stmt、quarterly_balance_sheet、
quarterly_cashflow は、それぞれ対応するメソッドを freq="quarterly" で呼ぶのと同じです。
四半期報告書は 2024 年 4 月に廃止され半期報告書に移行したため、四半期のデータは 2023 年度までです。
2024 年度以降は freq="semiannual" を用います。
get_jp_financials
Ticker.get_jp_financials(freq="yearly", start=None) -> pandas.DataFrameyfinance に同名の科目がない、日本の開示項目を返します。経常利益、1 株当たり純資産、従業員数、 銀行業・保険業に固有の科目などです。
引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
freq | str | "yearly" | "yearly"・"semiannual"・"quarterly" |
start | str | None | 返す期末日の下限("2020-03-31" など)。省略時はすべての年度 |
戻り値 — pandas.DataFrame。行はキー、列は期末日です。
値がまったくないキーは行に出ません(銀行・保険に固有の科目など、業種によって使う科目が違うため)。
get_statements
Ticker.statements -> pandas.DataFrame
Ticker.get_statements(freq="yearly", consolidated=None) -> pandas.DataFrame提出された財務諸表の全科目を、書類に表示される順序と階層を保ったまま返します(XBRL の表示リンクに基づきます)。 値には訂正報告書を反映します。行の構成は最新の書類に基づきます。
引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
freq | str | "yearly" | "yearly"・"semiannual"・"quarterly" |
consolidated | str | None | None(連結を優先し、なければ単体)・"consolidated"・"standalone" |
戻り値 — pandas.DataFrame。各行は、書類に表示される各行に対応します。
| 列 | 型 | 説明 |
|---|---|---|
Role | str | その行が属する表の名前 |
Label | str | 書類に表示される科目名 |
Local Name | str | XBRL の要素名 |
Depth | int | 書類上の階層 |
Is Abstract | bool | 値を持たない見出し行 |
| 年度 | float | 年度ごとに 1 列。列名は年度(int) |
get_segments
Ticker.segments -> pandas.DataFrame
Ticker.get_segments(freq="yearly", consolidated=None) -> pandas.DataFrame全年度のセグメント情報を返します。年度ごとに書類を 1 件選び、その書類の行だけを返すため、原本と 訂正報告書の行が混ざることはありません。
引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
freq | str | "yearly" | "yearly"・"semiannual"・"quarterly" |
consolidated | str | None | None・"consolidated"・"standalone" |
戻り値 — pandas.DataFrame。年度・セグメント・指標の組み合わせごとに 1 行です。
| 列 | 型 | 説明 |
|---|---|---|
Fiscal Year | int | 会計年度 |
Period End | datetime64 | 期末日 |
Segment、Segment Label | str | セグメントのキーと、提出書類に記載された名称 |
Role | str | segment・other・subtotal・total・adjustment |
Is Adjustment | bool | 調整額の行 |
Metric | str | 指標のキー(seg_revenue など) |
Value | float | 値 |
Unit | str | 単位 |
Consolidated | str | consolidated または standalone |
Accounting Standard | str | 日本基準・IFRS・米国基準 |
Document ID | str | EDINET の書類管理番号 |
調整額とセグメント間取引があるため、セグメントの値の合計は連結の値と一致しません。 セグメント名は提出書類の記載どおりであり、年度をまたいだ名寄せは行いません。
既定値
set_financials_start
jfinance.set_financials_start(start) -> None財務諸表のメソッドが返す期間の下限を設定します。
引数
| 名前 | 型 | 説明 |
|---|---|---|
start | str, datetime, None | 期末日の下限。None で既定(サーバーにあるすべての年度)に戻す |
yfinance はこれを 2016-12-31 に固定しています。jfinance は固定しないため、financials は
既定ですべての年度を返します。
jf.set_financials_start("2020-03-31")set_financials_basis
jfinance.set_financials_basis(consolidation="auto", version="latest") -> None財務諸表のメソッドが返す連結区分とデータの版を設定します。プロセス全体に適用されます。
引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
consolidation | str | "auto" | "auto"(連結を優先し、なければ単体)・"consolidated"・"standalone" |
version | str | "latest" | "latest" は訂正報告書を反映した値を返す。"as_filed" は提出時の値を返す |
これ以外の値を渡すと ValueError となります。
jf.set_financials_basis(consolidation="standalone", version="as_filed")閲覧期間を過ぎた書類への訂正報告書は取得できないため、
version="latest"であっても 古い年度には訂正前の値が残っている場合があります。 データ利用上の注意を参照してください。