https://jfnc.org/ja/docs/data/Recent content in データ on jfinanceHugojahttps://jfnc.org/ja/docs/data/coverage/Mon, 01 Jan 0001 00:00:00 +0000https://jfnc.org/ja/docs/data/coverage/<h1 id="収録範囲">収録範囲<a class="anchor" href="#%e5%8f%8e%e9%8c%b2%e7%af%84%e5%9b%b2"></a></h1> <p>本ライブラリが返すデータは、すべて EDINET（金融庁の電子開示システム）に提出された書類に 基づきます。</p> <h2 id="収録期間">収録期間<a class="anchor" href="#%e5%8f%8e%e9%8c%b2%e6%9c%9f%e9%96%93"></a></h2> <p>2016 年度以降のデータを収録しています。</p> <div class="highlight"><pre tabindex="0" style="color:#e2e4e5;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>t<span style="color:#ff6ac1">.</span>min_fiscal_year <span style="color:#78787e"># 2016</span></span></span></code></pre></div><p>これより前の期間を指定した場合、例外は送出せず空の結果を返します。 下限は HTTP 応答の <code>X-JF-Min-Fiscal-Year</code> ヘッダーからも確認できます。 1997 年度まで遡るデータセットは別途提供します。</p> <h2 id="収録件数">収録件数<a class="anchor" href="#%e5%8f%8e%e9%8c%b2%e4%bb%b6%e6%95%b0"></a></h2> <table> <thead> <tr> <th>項目</th> <th>件数</th> </tr> </thead> <tbody> <tr> <td>会社（EDINET コード）</td> <td>13,199</td> </tr> <tr> <td>うち証券コードを持つ会社</td> <td>5,290</td> </tr> <tr> <td>投資信託</td> <td>6,527</td> </tr> <tr> <td>提出書類（2016 年以降）</td> <td>469,653</td> </tr> <tr> <td>大量保有の保有記録</td> <td>245,804</td> </tr> <tr> <td>大量保有の売買明細</td> <td>1,920,873</td> </tr> <tr> <td>役員の記録</td> <td>649,095</td> </tr> <tr> <td>役員の個別報酬</td> <td>103,473</td> </tr> <tr> <td>財務諸表の行</td> <td>4,195 万</td> </tr> <tr> <td>正規化した指標</td> <td>876 万</td> </tr> </tbody> </table> <p>書類の種類別の内訳（2016 年以降、上位 7 種）は次のとおりです。</p> <table> <thead> <tr> <th>種類</th> <th>件数</th> </tr> </thead> <tbody> <tr> <td>四半期報告書</td> <td>95,882</td> </tr> <tr> <td>大量保有の変更報告書</td> <td>92,365</td> </tr> <tr> <td>有価証券報告書</td> <td>85,261</td> </tr> <tr> <td>有価証券届出書</td> <td>47,844</td> </tr> <tr> <td>臨時報告書</td> <td>40,742</td> </tr> <tr> <td>内部統制報告書</td> <td>25,993</td> </tr> <tr> <td>半期報告書</td> <td>21,724</td> </tr> </tbody> </table> <p>データは日次で更新し、EDINET に提出された書類を翌日までに取り込みます。</p> <h2 id="データの出所">データの出所<a class="anchor" href="#%e3%83%87%e3%83%bc%e3%82%bf%e3%81%ae%e5%87%ba%e6%89%80"></a></h2> <table> <thead> <tr> <th>データ</th> <th>出所の書類</th> </tr> </thead> <tbody> <tr> <td>財務諸表・指標</td> <td>有価証券報告書、半期報告書、四半期報告書の XBRL</td> </tr> <tr> <td>役員、役員報酬、大株主、所有者別状況、事業の内容</td> <td>有価証券報告書</td> </tr> <tr> <td>大量保有</td> <td>大量保有報告書、変更報告書</td> </tr> <tr> <td>温室効果ガス排出量</td> <td>有価証券報告書（2024 年度以降）</td> </tr> <tr> <td>投資信託</td> <td>有価証券報告書、半期報告書（ファンド）</td> </tr> <tr> <td>業種、市場区分、ISIN</td> <td>EDINET コードリスト等</td> </tr> <tr> <td>業種の英語名</td> <td>JPX「TOPIX Sector Indices / TOPIX-17 Series」</td> </tr> </tbody> </table> <h2 id="項目ごとの収録期間">項目ごとの収録期間<a class="anchor" href="#%e9%a0%85%e7%9b%ae%e3%81%94%e3%81%a8%e3%81%ae%e5%8f%8e%e9%8c%b2%e6%9c%9f%e9%96%93"></a></h2> <table> <thead> <tr> <th>項目</th> <th>収録期間</th> <th>理由</th> </tr> </thead> <tbody> <tr> <td>財務諸表・指標</td> <td>2016 年度</td> <td>サーバーの設定による</td> </tr> <tr> <td>四半期</td> <td>2023 年度まで</td> <td>2024 年 4 月に四半期報告書の制度が廃止されたため</td> </tr> <tr> <td>所有者別状況（<code>major_holders</code>）</td> <td>2019 年度</td> <td>有価証券報告書の様式による</td> </tr> <tr> <td>温室効果ガス排出量（<code>emissions</code>）</td> <td>2024 年度</td> <td>XBRL の要素が新設された年度</td> </tr> </tbody> </table> <h2 id="対象外の項目">対象外の項目<a class="anchor" href="#%e5%af%be%e8%b1%a1%e5%a4%96%e3%81%ae%e9%a0%85%e7%9b%ae"></a></h2> <table> <thead> <tr> <th>項目</th> <th>理由</th> </tr> </thead> <tbody> <tr> <td>株価、配当履歴、株式分割、オプション</td> <td>EDINET は開示書類のシステムであり、市場データを扱わない</td> </tr> <tr> <td>アナリスト予想、目標株価</td> <td>同上</td> </tr> <tr> <td>ニュース、決算発表予定</td> <td>同上</td> </tr> <tr> <td>ESG スコア</td> <td>評価機関が作成するものであり、開示書類に含まれない</td> </tr> <tr> <td>役員の売買報告</td> <td>日本では EDINET に提出されない</td> </tr> <tr> <td>投資信託の組入銘柄、資産配分</td> <td>書類本文の表にのみ記載され、数値として抽出していない</td> </tr> </tbody> </table>https://jfnc.org/ja/docs/data/notes/Mon, 01 Jan 0001 00:00:00 +0000https://jfnc.org/ja/docs/data/notes/<h1 id="データ利用上の注意">データ利用上の注意<a class="anchor" href="#%e3%83%87%e3%83%bc%e3%82%bf%e5%88%a9%e7%94%a8%e4%b8%8a%e3%81%ae%e6%b3%a8%e6%84%8f"></a></h1> <h2 id="訂正報告書の反映">訂正報告書の反映<a class="anchor" href="#%e8%a8%82%e6%ad%a3%e5%a0%b1%e5%91%8a%e6%9b%b8%e3%81%ae%e5%8f%8d%e6%98%a0"></a></h2> <p>財務数値、役員情報、役員報酬には、訂正報告書の内容を反映しています。</p> <p>反映の有無は次の項目で確認できます。</p> <table> <thead> <tr> <th>項目</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td><code>isCorrected</code></td> <td>訂正により値が変更されたか</td> </tr> <tr> <td><code>sourceDocumentId</code></td> <td>値の出所となる書類</td> </tr> </tbody> </table> <blockquote class='book-hint warning'> <p>EDINET の閲覧期間が満了した書類に対する訂正報告書は取得できず、反映されない場合があります。</p> <p>閲覧期間（有価証券報告書は 5 年）を経過した書類は EDINET から取得できません。 古い年度ほど、訂正前の値が残っている可能性が高くなります。</p></blockquote><p>出典で確認できた誤りについては、サーバー側で個別に修正し、該当する行に出典の URL を 付けます（<code>correctionSource</code>、<code>payCorrection</code>）。</p> <h2 id="値の選択基準">値の選択基準<a class="anchor" href="#%e5%80%a4%e3%81%ae%e9%81%b8%e6%8a%9e%e5%9f%ba%e6%ba%96"></a></h2> <p>連結の値を優先し、連結が存在しない場合に単体の値を用います。 同一の期に複数の書類が存在する場合は、訂正を反映した値を 1 つ選択します。</p> <p>会計基準は会社ごとに異なります（日本基準、IFRS、US GAAP）。各データの会計基準は <code>accountingStandard</code> で確認できます。比率は小数で返します（<code>returnOnEquity</code> の 0.101 は 10.1%）。 設備投資および配当金の支払額は支出であるため負の値となります。</p> <h2 id="日本の開示制度に起因する差異">日本の開示制度に起因する差異<a class="anchor" href="#%e6%97%a5%e6%9c%ac%e3%81%ae%e9%96%8b%e7%a4%ba%e5%88%b6%e5%ba%a6%e3%81%ab%e8%b5%b7%e5%9b%a0%e3%81%99%e3%82%8b%e5%b7%ae%e7%95%b0"></a></h2> <table> <thead> <tr> <th>項目</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td><code>major_shareholders</code></td> <td>大株主は名義で記載されるため、信託銀行の信託口が上位を占める</td> </tr> <tr> <td><code>institutional_holders</code></td> <td>5% 超を保有し、特例報告を提出した機関に限る</td> </tr> <tr> <td><code>companyOfficers[].totalPay</code></td> <td>報酬が 1 億円以上の役員のみ個別に開示される。それ以外は <code>None</code></td> </tr> <tr> <td><code>totalRevenue</code></td> <td>対応する科目が業種により異なる（売上高、営業収益、経常収益）</td> </tr> <tr> <td><code>insider_roster_holders</code></td> <td>年 1 回の有価証券報告書時点の所有株式数であり、取引履歴ではない</td> </tr> </tbody> </table> <h2 id="言語">言語<a class="anchor" href="#%e8%a8%80%e8%aa%9e"></a></h2> <p>既定の言語は英語です。会社名には EDINET に届け出られた英文社名を、業種名には JPX の英語名を使用します。</p> <p>事業の内容、役員の氏名と役職、株主の名称、書類の種類と表題および市場区分については 英語の出典が存在しません。これらは言語設定にかかわらず日本語で返し、機械翻訳は行いません。</p> <p>英文社名を届け出ていない会社（証券コードを持つ会社の約 23%）は、英語設定でも和文社名を返します。</p> <h2 id="既知の制限">既知の制限<a class="anchor" href="#%e6%97%a2%e7%9f%a5%e3%81%ae%e5%88%b6%e9%99%90"></a></h2> <table> <thead> <tr> <th>内容</th> <th>影響する項目</th> <th>備考</th> </tr> </thead> <tbody> <tr> <td>指標の従業員数が連結ではなく単体の人数となる年度がある</td> <td><code>get_jp_financials()</code> の <code>NumberOfEmployees</code></td> <td>有価証券報告書の「連結経営指標等」に従業員数が記載されない年度があるため。<code>info[&quot;fullTimeEmployees&quot;]</code> および <code>employees</code> は「従業員の状況」から取得するため連結の人数となる</td> </tr> <tr> <td>一部の会社で <code>insidersPercentHeld</code> を返さない</td> <td><code>major_holders</code></td> <td>役員の所有株式数の単位を判別できないため。推測による補完は行わない</td> </tr> <tr> <td>投資信託の組入銘柄、資産配分、信託報酬率を返さない</td> <td><code>funds_data</code></td> <td>書類本文の表にのみ記載され、数値として抽出していない</td> </tr> <tr> <td>半期報告書の期間が事業年度の期間となる</td> <td><code>report_filing_dates</code></td> <td>EDINET の書類一覧の値をそのまま用いるため</td> </tr> <tr> <td>配当の基準日および株主総会の日を返さない</td> <td>—</td> <td>XBRL に基準日を持つ書類が 36 件にとどまり、株主総会の日に対応する要素が存在しないため</td> </tr> </tbody> </table>