Ticker

jfinance.Ticker(ticker, session=None)

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

引数

名前型既定値説明
tickerstr—証券コード（"7203.T"）、EDINET コード（"E02144"）、ISIN（"JP3633400001"）、ファンドコード（"G02925"）。証券コードを参照
sessionrequests.SessionNone再利用するセッション。省略時は共有セッションを作成する
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、longNamestr銘柄コードと会社名。config.locale.lang が "ja-JP" でなければ英語
edinetCode、isin、corporateNumberstrEDINET コード、ISIN、法人番号
sector、sectorKey、sectorCodestr, str, intTOPIX-17 の業種
industry、industryKey、industryCodestr, str, int東証 33 業種
market、marketSegment、topixScale、listingStatusstr市場と区分（プライム（内国株式）、TOPIX Core30、listed など）
country、currency、financialCurrency、regionstr日本・JPY・JP で固定
fiscalYearEndstr決算期。記載のまま（3月31日）
lastFiscalYearEnd、nextFiscalYearEndintUNIX 秒
fullTimeEmployeesint提出会社の従業員数
longBusinessSummarystr事業の内容。言語設定にかかわらず日本語。EDINET に英語の原文がない
businessSummaryDocumentIdstr事業の内容の取得元となる書類の管理番号
companyOfficerslist[dict]役員。name、title、age、記載があれば totalPay を持つ
totalRevenue、grossProfits、netIncomeToCommon、operatingCashflow、totalCashint直近の年度の値。単位は円
sharesOutstandingint発行済株式総数
trailingEps、dilutedEps、bookValue、dividendRatefloat1 株当たり。単位は円
returnOnEquity、equityRatio、payoutRatiofloat小数（0.101 は 10.1%）
capitalMillionJpyint資本金。単位は百万円
quoteTypestr"EQUITY" または "MUTUALFUND"

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

isin

Ticker.isin -> str | None
Ticker.get_isin() -> str | None

ISIN を返します。非上場の提出会社など、ISIN がない場合は None を返します。

min_fiscal_year

Ticker.min_fiscal_year -> int | None

サーバーから取得できる年度の下限です。これより前の年度を指定すると、例外を送出せず空の結果を返します。 https://query1.jfnc.org は 2016 を返します。自分で運用するサーバーは、既定では年度の制限がなく、None を 返します。また、初回のサーバーへの問い合わせが完了するまでは、下限を判定できないため None です。

株式数

shares

Ticker.shares -> pandas.DataFrame
Ticker.get_shares(as_dict=False) -> pandas.DataFrame | dict

有価証券報告書に基づく、年度ごとの発行済株式総数を返します。

引数

名前型既定値説明
as_dictboolFalseDataFrame ではなく dict で返す

get_shares_full

Ticker.get_shares_full(start=None, end=None) -> pandas.Series | None

期間を指定して発行済株式総数を返します。

引数

名前型既定値説明
startstr, datetime.dateNone開始日。省略時は最も古い年度から
endstr, datetime.dateNone終了日。省略時は当日

日本の開示では株式数の記載が年 1 回であるため、値が変わるのは各年度末に限られます。

Backward リファレンス 財務データ Forward