検索・業種・スクリーナー
検索
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 は、それぞれ対応するメソッドを既定の件数で呼び出した結果を返します。
戻り値 — pandas.DataFrame。インデックスは symbol、列は shortName、quoteType、
exchange、industryName です。
業種
会社は、TOPIX-17 業種と東証 33 業種の 2 つの分類で整理されています。
JpSector
jfinance.JpSector(key, session=None)TOPIX-17 の 1 業種を表します。
引数
| 名前 | 型 | 説明 |
|---|---|---|
key | str | 業種のキー（"automobiles-transportation-equipment" など） |
属性
| 名前 | 型 | 説明 |
|---|---|---|
key、name | str | キーと表示名 |
overview | dict | companiesCount、industriesCount、および top_companies の並べ方を示す topCompaniesBasis |
top_companies | pandas.DataFrame | 属する上場会社。列は name、edinetCode、revenue、fiscalYear |
industries | pandas.DataFrame | 属する東証 33 業種。インデックスが key、列は name、companiesCount |
静的メソッド
JpSector.all(session=None) -> pandas.DataFrame17 業種の一覧を返します。インデックスは業種のキー、列は name、companiesCount、industriesCount です。
JpIndustry
jfinance.JpIndustry(key, session=None)東証 33 業種の 1 つを表します。key、name、overview、top_companies は JpSector と同じで、
sector_key と sector_name は、その業種が属する TOPIX-17 業種を示します。
jf.JpIndustry("transportation-equipment").top_companies
top_companiesは直近の年度の売上高（連結を優先）の順です。EDINET に株価がないため、 時価総額の順ではありません。
スクリーナー
edinet_screen
jfinance.edinet_screen(query, offset=None, size=None, sortField=None,
sortAsc=None, year=None, scope="consolidated",
session=None) -> dict開示された数値で会社を絞り込みます。書き方は yfinance の screen と同じです。
引数
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
query | EdinetQuery | — | 条件 |
offset | int | None | 読み飛ばす行数 |
size | int | None | 返す行数 |
sortField | str | None | 並べ替えに使う項目 |
sortAsc | bool | None | 昇順にする |
year | int | None | 会計年度。省略時は最新 |
scope | str | "consolidated" | "consolidated" または "standalone" |
session | requests.Session | None | 再利用するセッション |
戻り値 — dict。start、count、total、fiscalYear、scope、quotes を持ちます。
quotes の各要素は symbol、shortName、longName、edinetCode、industry、sector、
marketSegment、accountingStandard、fiscalYear、fiscalYearEnd に加え、条件と
sortField で指定した項目を持ちます。
jf.edinet_screen(
jf.EdinetQuery("gt", ["roe", 0.2]),
sortField="revenue",
size=50,
)EdinetQuery
jfinance.EdinetQuery(operator, operand)引数
| 名前 | 型 | 説明 |
|---|---|---|
operator | str | "eq"・"is-in"・"btwn"・"gt"・"lt"・"gte"・"lte"・"and"・"or" |
operand | list | 比較では [項目, 値]。and・or では EdinetQuery のリスト |
q = jf.EdinetQuery("and", [
jf.EdinetQuery("gt", ["roe", 0.15]),
jf.EdinetQuery("is-in", ["sector", ["banks", "insurance"]]),
])
jf.edinet_screen(q)属性
| 名前 | 型 | 説明 |
|---|---|---|
valid_fields | dict | 指定できる項目。分類ごとに、名称と単位を持つ |
valid_values | dict | カテゴリ項目に指定できる値 |
to_dict() | dict | サーバーへ送信する形式に変換した条件 |
項目の分類と件数は次のとおりです。
| 分類 | 件数 | 例 |
|---|---|---|
pl | 19 | revenue、operatingIncome、ordinaryIncome、netIncome、grossProfit |
bs | 8 | totalAssets、netAssets、capitalStock、bs_retainedEarnings |
cf | 7 | operatingCF、investingCF、financingCF、capex |
perShare | 5 | eps、epsDiluted、bps、dividendPerShare |
ratio | 5 | roe、equityRatio、payoutRatio、per、tsr |
shares | 1 | issuedShares |
workforce | 2 | employees、temporaryEmployees |
statement | 14 | 銀行業・保険業の科目（deposits、loans、net_premiums_written など） |
categorical | 6 | sector、industry、market、listing、accountingStandard、fiscalMonth |
カテゴリ項目に指定できる値は次のとおりです。
| 項目 | 値 |
|---|---|
market | prime、standard、growth、pro |
listing | listed、unlisted |
accountingStandard | Japan GAAP、IFRS、US GAAP |
sector、industry | TOPIX-17 と東証 33 業種のキー |
fiscalMonth | 決算月 |
時価総額・PER・株価など株価から導く項目は、EDINET に株価がないため扱いません。
perは 有価証券報告書に記載された株価収益率であり、jfinance が株価から算出した値ではありません。