財務情報(/fins/summary)
GET /v2/fins/summary
APIの概要
財務情報の開示日・銘柄コードを指定して、決算短信などの財務情報サマリーを取得できます。
銘柄コード(code)または日付(date)のいずれか一方、もしくは両方の指定が必要です。
本APIの留意点
- 会計基準について
- APIから出力される各項目名は日本基準(JGAAP)の開示項目が基準となっています。そのため、IFRSや米国基準(USGAAP)の開示データにおいては、経常利益の概念がありませんので、データが空欄となっています。
- 開示書類(XBRL)との関係について
- 本APIの各項目は、上場会社が提出したXBRLデータの値に基づいているため、決算短信のPDFと異なる場合がございます。
- XBRLデータが提出されていない開示(PDFのみの開示等)は、本APIの収録対象外です。
- 項目のスケール、単位について
- 金額項目は、決算短信の表示単位(百万円・千円等)に関わらず、開示されたXBRLデータの値に基づき円単位で収録しています。(外国会社の開示を含む)
- 当社側での単位換算・追加の丸め処理は行っておりません。
- 各項目の会計上の定義・記載基準につきましては、原典である当該決算短信をご参照ください。
- 連結・非連結の項目について
- 決算短信(連結)を提出する企業では、接頭辞
NCがない項目(Sales・OP・TA等)に連結の値を、接頭辞NCがある項目に個別の値を収録します。 - 決算短信(非連結)を提出する企業では、接頭辞
NCがない項目に個別の値を収録し、接頭辞NCがある項目は空文字列となります。 - 業績予想の修正においては、XBRL定義に従い、接頭辞
NCがない項目に連結の値、接頭辞NCがある項目に個別の値を収録します。
- 決算短信(連結)を提出する企業では、接頭辞
- 決算期変更について
- 本APIには決算期変更を直接示す項目はありません。同一銘柄の開示を時系列で確認し、会計年度終了日(
CurFYEn)の変化でご判断ください。
- 本APIには決算期変更を直接示す項目はありません。同一銘柄の開示を時系列で確認し、会計年度終了日(
- 開示順序について
- 開示番号は開示順序を保証するものではございません。開示順序の判定には開示日時・時刻(
DiscDate・DiscTime)をご参照ください。
- 開示番号は開示順序を保証するものではございません。開示順序の判定には開示日時・時刻(
- 記載のない項目について
- 各レコードには当該開示書類に記載された値のみを収録しており、記載のない項目は空文字列となります。空文字列は値の記載がなかったことのみを示す仕様であり、前回開示からの変更の有無や、予想の撤回・未定といった状態を表すものではありません。
- 業績予想の収録形式について
- 業績予想の各項目には、単一の値で開示された予想値を収録しています。レンジ(幅)形式で開示された予想値は収録されません。
- 予想項目について
- 接頭辞
Nxがない項目(FSales・FOP・FDivFY等)は当事業年度(CurFYSt〜CurFYEn)の予想値、接頭辞Nxがある項目(NxFSales・NxFOP・NxFDivFY等)は翌事業年度(NxtFYSt〜NxtFYEn)の予想値です。 - 通期決算短信(開示書類種別に
FYFinancialStatementsを含む開示)では、翌事業年度の予想として接頭辞Nxのある項目のみ収録され、接頭辞Nxのない項目は空文字列となります。 - 通期決算短信の翌事業年度の予想(
NxFOP等)とその後の業績予想の修正(FOP等)を比較する場合は、銘柄コードに加えて、通期決算短信のレコードのNxtFYSt・NxtFYEnと業績予想修正のレコードのCurFYSt・CurFYEnを照合してください。なお、決算期変更があった場合は事業年度の期間が変わるため、この照合では対応付けられません。
- 接頭辞
- 有無を示す項目について
MatChgSub・SigChgInC・ChgByASRev・ChgNoASRev・ChgAcEst・RetroRstは、決算短信の記載が「有」の場合は"true"、「無」の場合は"false"の文字列を返却します。決算短信への記載がない場合は空文字列("")となります。
- 一株あたり配当実績について
- 決算短信に記載された値をそのまま収録しており、当社側で株式分割・株式併合を反映した遡及調整は行っておりません。事業年度の途中や決算期末の後に株式分割・併合が行われた場合、決算短信の配当欄をどのように記載するかは開示会社の判断によって異なります。当該配当の基準日時点の金額をそのまま記載する例と、分割・併合後の株式数に換算して記載する例のいずれも存在するため、一律に開示時点の値、あるいは基準日時点の値と定まるものではございません。
- 適時開示インデックス一覧との同期について
- TDnet/適時開示インデックス一覧(/td/list)と本APIは同期しておりません。そのため、適時開示インデックス一覧での新規開示検知時点では当該開示の財務情報を取得できない可能性があります。取得できない場合は、時間を置いて再度ご確認ください。なお、同じ開示には本APIと適時開示インデックス一覧・TDnet/適時開示ファイル取得(/td/files)で同じ開示番号(
DiscNo)が付与されるため、DiscNoをキーに対応付けることができます。
- TDnet/適時開示インデックス一覧(/td/list)と本APIは同期しておりません。そのため、適時開示インデックス一覧での新規開示検知時点では当該開示の財務情報を取得できない可能性があります。取得できない場合は、時間を置いて再度ご確認ください。なお、同じ開示には本APIと適時開示インデックス一覧・TDnet/適時開示ファイル取得(/td/files)で同じ開示番号(
- レートリミットについて
- 本APIには個別のレートリミットが適用されます。過去データの一括取得など効率的なデータ取得についてはベストプラクティスをご参照ください。
- 四半期開示見直し対応に伴うAPI項目の追加について
- 四半期開示見直し対応において、決算短信サマリー様式の記載事項が以下のとおり変更されます。
- 変更前: 重要な⼦会社の異動(連結範囲の変更を伴う特定⼦会社の異動)
- 変更後: 連結範囲の重要な変更
- この対応に伴い、2024/7/22より本APIのレスポンス項目に"SigChgInC"(期中における連結範囲の重要な変更)を追加いたします。
- 詳細は、データ項目概要欄をご覧ください。
- 四半期開示見直し対応において、決算短信サマリー様式の記載事項が以下のとおり変更されます。
- 各データがJ-Quantsで利用可能となった日時は提供しておりません。更新頻度および更新時刻の目安は提供データの更新タイミングをご参照ください。
- データ仕様について過去にお問い合わせのあった内容は、FAQ(データ内容・仕様)にも記載しておりますので、あわせてご参照ください。
データ訂正のポリシー
- 本APIは、各社が開示した決算短信のデータを提供しております。当社で分割調整や訂正等による過去データの遡及修正は行っておらず、各レコードは開示時点の基準の値を保持しております。
- 訂正開示には新しい開示番号(
DiscNo)が割り振られ、既存レコードは上書きされません。訂正前のレコードも残るため、開示番号(DiscNo)・開示日(DiscDate)により、どの時点の開示に基づく値かを識別できます。 - ただし、本APIでは開示が訂正であることを示す項目・フラグはございません。訂正前後の値を比較する場合は、同一銘柄の同一会計期間のレコードを開示日時順に並べてご確認ください。
- 本サービスにおいて、データ不備・不足によるデータの追加・上書き修正を行う場合がございます。その場合には、データ修正履歴・制約事項に修正履歴を記載しておりますのでご参照ください。
※ 本ケースにおいては、API/CSV等での訂正履歴、訂正前データの提供は行っておりません。
財務情報データを取得します
GET https://api.jquants.com/v2/fins/summary
銘柄コード(code)または日付(date)の指定が必須となります。
パラメータ及びレスポンス
銘柄コード(code)または日付(date)の指定が必須となります。
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
| code | date | cursor | レスポンスの結果 |
|---|---|---|---|
| 指定された銘柄について全期間分の財務情報データ | |||
| 指定された銘柄について指定された日付の財務情報データ | |||
| 全上場銘柄について指定された日付の財務情報データ | |||
| 前回リクエスト以降の財務情報データを取得(Premiumプランのみ) |
cursorを使った財務情報の取得
cursorを使った差分取得の仕様については、cursorを使った差分取得をご参照ください。
cursorパラメータはPremiumプランでのみ利用可能です。
Requests
Headers
- x-api-keystringrequired
APIキー
Query Parameters
code または date のいずれか一つの指定が必須です。
- codestringoptional
銘柄コード(e.g. 86970 or 8697)
4桁もしくは5桁の銘柄コード- datestringoptional
開示日付の指定(e.g. 2022-01-05 or 20220105)
- cursorstringoptional
差分取得のカーソル(Premiumプランのみ)
前回のレスポンスで返却されたcursorを指定することで前回のリクエスト以降に配信されたデータを取得できます。pagination_keyと同時指定不可。
詳細はcursorを使った差分取得をご参照ください。- pagination_keystringoptional
検索の先頭を指定する文字列
過去の検索で返却されたpagination_keyを設定
APIコールサンプルコード
Request
curl -G https://api.jquants.com/v2/fins/summary \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="2024-10-25"Responses
データ項目概要
- 本APIのレスポンスは、すべての項目をJSON文字列(string)で返却します。金額・株数・比率などの数値項目も、数値型ではなく文字列です(例:
"Sales": "100529000000")。 - 欠損値・レコード不在について
- 値が存在しない項目は
nullではなく空文字列("")が返却されます。 - 数値として扱う場合は、利用者側で空文字列の判定と数値への変換を行ってください。
- 値が存在しない項目は
- DiscDatestring
TDnetの開示日(JST)
- DiscTimestring
TDnetの開示時刻(JST)
秒は原データのまま収録しており、値は常に00です。- Codestring
- 銘柄コード(5桁)
- DiscNostring
開示番号
APIから出力されるjsonは開示番号で昇順に並んでいます。- DocTypestring
開示書類種別
開示書類種別一覧- CurPerTypestring
当会計期間の種類
[1Q, 2Q, 3Q, 4Q, 5Q, FY]- CurPerStstring
- 当会計期間開始日
- CurPerEnstring
- 当会計期間終了日
- CurFYStstring
- 当事業年度開始日
- CurFYEnstring
- 当事業年度終了日
- NxtFYStstring
翌事業年度開始日
開示レコードに翌事業年度の開示情報がない場合空欄になります。- NxtFYEnstring
翌事業年度終了日
開示レコードに翌事業年度の開示情報がない場合空欄になります。- Salesstring
- 売上高
- OPstring
- 営業利益
- OdPstring
- 経常利益
- NPstring
当期純利益
親会社株主に帰属する当期純利益です。非支配株主持分を含む合計値ではありません。- EPSstring
- 一株あたり当期純利益
- DEPSstring
- 潜在株式調整後一株あたり当期純利益
- TAstring
- 総資産
- Eqstring
- 純資産
- EqARstring
- 自己資本比率
- BPSstring
- 一株あたり純資産
- CFOstring
- 営業活動によるキャッシュ・フロー
- CFIstring
- 投資活動によるキャッシュ・フロー
- CFFstring
- 財務活動によるキャッシュ・フロー
- CashEqstring
- 現金及び現金同等物期末残高
- Div1Qstring
- 一株あたり配当実績_第1四半期末(日本円、1株当たり)
- Div2Qstring
- 一株あたり配当実績_第2四半期末(日本円、1株当たり)
- Div3Qstring
- 一株あたり配当実績_第3四半期末(日本円、1株当たり)
- DivFYstring
- 一株あたり配当実績_期末(日本円、1株当たり)
- DivAnnstring
- 一株あたり配当実績_合計(日本円、1株当たり)
- DivUnitstring
- 1口当たり分配金
- DivTotalAnnstring
- 配当金総額
- PayoutRatioAnnstring
- 配当性向
- FDiv1Qstring
- 一株あたり配当予想_第1四半期末
- FDiv2Qstring
- 一株あたり配当予想_第2四半期末
- FDiv3Qstring
- 一株あたり配当予想_第3四半期末
- FDivFYstring
- 一株あたり配当予想_期末
- FDivAnnstring
一株あたり配当予想_合計(日本円、1株当たり)
- FDivUnitstring
- 1口当たり予想分配金
- FDivTotalAnnstring
- 予想配当金総額
- FPayoutRatioAnnstring
- 予想配当性向
- NxFDiv1Qstring
- 一株あたり配当予想_翌事業年度第1四半期末
- NxFDiv2Qstring
- 一株あたり配当予想_翌事業年度第2四半期末
- NxFDiv3Qstring
- 一株あたり配当予想_翌事業年度第3四半期末
- NxFDivFYstring
- 一株あたり配当予想_翌事業年度期末
- NxFDivAnnstring
一株あたり配当予想_翌事業年度合計(日本円、1株当たり)
- NxFDivUnitstring
- 1口当たり翌事業年度予想分配金
- NxFPayoutRatioAnnstring
- 翌事業年度予想配当性向
- FSales2Qstring
- 売上高_予想_第2四半期末
- FOP2Qstring
- 営業利益_予想_第2四半期末
- FOdP2Qstring
- 経常利益_予想_第2四半期末
- FNP2Qstring
- 当期純利益_予想_第2四半期末
- FEPS2Qstring
- 一株あたり当期純利益_予想_第2四半期末
- NxFSales2Qstring
売上高_予想_翌事業年度第2四半期末
- NxFOP2Qstring
営業利益_予想_翌事業年度第2四半期末
- NxFOdP2Qstring
経常利益_予想_翌事業年度第2四半期末
- NxFNp2Qstring
当期純利益_予想_翌事業年度第2四半期末
- NxFEPS2Qstring
一株あたり当期純利益_予想_翌事業年度第2四半期末
- FSalesstring
- 売上高_予想_期末
- FOPstring
- 営業利益_予想_期末
- FOdPstring
- 経常利益_予想_期末
- FNPstring
- 当期純利益_予想_期末
- FEPSstring
- 一株あたり当期純利益_予想_期末
- NxFSalesstring
- 売上高_予想_翌事業年度期末
- NxFOPstring
- 営業利益_予想_翌事業年度期末
- NxFOdPstring
- 経常利益_予想_翌事業年度期末
- NxFNpstring
- 当期純利益_予想_翌事業年度期末
- NxFEPSstring
一株あたり当期純利益_予想_翌事業年度期末
- MatChgSubstring
- 期中における重要な子会社の異動
- SigChgInCstring
期中における連結範囲の重要な変更
*指定されたdateが2024-07-21以前のレスポンスは、当該項目には値が収録されず空文字列となります(項目自体は省略されません)。- ChgByASRevstring
会計基準等の改正に伴う会計方針の変更
- ChgNoASRevstring
会計基準等の改正に伴う変更以外の会計方針の変更
- ChgAcEststring
- 会計上の見積りの変更
- RetroRststring
- 修正再表示
- ShOutFYstring
- 期末発行済株式数
- TrShFYstring
- 期末自己株式数
- AvgShstring
- 期中平均株式数
- NCSalesstring
- 売上高_非連結
- NCOPstring
- 営業利益_非連結
- NCOdPstring
- 経常利益_非連結
- NCNPstring
- 当期純利益_非連結
- NCEPSstring
- 一株あたり当期純利益_非連結
- NCTAstring
- 総資産_非連結
- NCEqstring
- 純資産_非連結
- NCEqARstring
- 自己資本比率_非連結
- NCBPSstring
- 一株あたり純資産_非連結
- FNCSales2Qstring
売上高_予想_第2四半期末_非連結
- FNCOP2Qstring
営業利益_予想_第2四半期末_非連結
- FNCOdP2Qstring
経常利益_予想_第2四半期末_非連結
- FNCNP2Qstring
当期純利益_予想_第2四半期末_非連結
- FNCEPS2Qstring
一株あたり当期純利益_予想_第2四半期末_非連結
- NxFNCSales2Qstring
売上高_予想_翌事業年度第2四半期末_非連結
- NxFNCOP2Qstring
営業利益_予想_翌事業年度第2四半期末_非連結
- NxFNCOdP2Qstring
経常利益_予想_翌事業年度第2四半期末_非連結
- NxFNCNP2Qstring
当期純利益_予想_翌事業年度第2四半期末_非連結
- NxFNCEPS2Qstring
一株あたり当期純利益_予想_翌事業年度第2四半期末_非連結
- FNCSalesstring
- 売上高_予想_期末_非連結
- FNCOPstring
- 営業利益_予想_期末_非連結
- FNCOdPstring
- 経常利益_予想_期末_非連結
- FNCNPstring
- 当期純利益_予想_期末_非連結
- FNCEPSstring
一株あたり当期純利益_予想_期末_非連結
- NxFNCSalesstring
売上高_予想_翌事業年度期末_非連結
- NxFNCOPstring
営業利益_予想_翌事業年度期末_非連結
- NxFNCOdPstring
経常利益_予想_翌事業年度期末_非連結
- NxFNCNPstring
当期純利益_予想_翌事業年度期末_非連結
- NxFNCEPSstring
一株あたり当期純利益_予想_翌事業年度期末_非連結
- ShEqstring
- 自己資本
- NCShEqstring
- 自己資本_非連結
- ROEstring
- 自己資本利益率
- NCROEstring
- 自己資本利益率_非連結
レスポンスサンプル
{
"data": [
{
"DiscDate": "2023-01-30",
"DiscTime": "12:00:00",
"Code": "86970",
"DiscNo": "20230127594871",
"DocType": "3QFinancialStatements_Consolidated_IFRS",
"CurPerType": "3Q",
"CurPerSt": "2022-04-01",
"CurPerEn": "2022-12-31",
"CurFYSt": "2022-04-01",
"CurFYEn": "2023-03-31",
"NxtFYSt": "",
"NxtFYEn": "",
"Sales": "100529000000",
"OP": "51765000000",
"OdP": "",
"NP": "35175000000",
"EPS": "66.76",
"DEPS": "",
"TA": "79205861000000",
"Eq": "320021000000",
"EqAR": "0.004",
"BPS": "",
"CFO": "",
"CFI": "",
"CFF": "",
"CashEq": "91135000000",
"Div1Q": "",
"Div2Q": "26.0",
"Div3Q": "",
"DivFY": "",
"DivAnn": "",
"DivUnit": "",
"DivTotalAnn": "",
"PayoutRatioAnn": "",
"FDiv1Q": "",
"FDiv2Q": "",
"FDiv3Q": "",
"FDivFY": "36.0",
"FDivAnn": "62.0",
"FDivUnit": "",
"FDivTotalAnn": "",
"FPayoutRatioAnn": "",
"NxFDiv1Q": "",
"NxFDiv2Q": "",
"NxFDiv3Q": "",
"NxFDivFY": "",
"NxFDivAnn": "",
"NxFDivUnit": "",
"NxFPayoutRatioAnn": "",
"FSales2Q": "",
"FOP2Q": "",
"FOdP2Q": "",
"FNP2Q": "",
"FEPS2Q": "",
"NxFSales2Q": "",
"NxFOP2Q": "",
"NxFOdP2Q": "",
"NxFNp2Q": "",
"NxFEPS2Q": "",
"FSales": "132500000000",
"FOP": "65500000000",
"FOdP": "",
"FNP": "45000000000",
"FEPS": "85.42",
"NxFSales": "",
"NxFOP": "",
"NxFOdP": "",
"NxFNp": "",
"NxFEPS": "",
"MatChgSub": "false",
"SigChgInC": "",
"ChgByASRev": "false",
"ChgNoASRev": "false",
"ChgAcEst": "true",
"RetroRst": "",
"ShOutFY": "528578441",
"TrShFY": "1861043",
"AvgSh": "526874759",
"NCSales": "",
"NCOP": "",
"NCOdP": "",
"NCNP": "",
"NCEPS": "",
"NCTA": "",
"NCEq": "",
"NCEqAR": "",
"NCBPS": "",
"FNCSales2Q": "",
"FNCOP2Q": "",
"FNCOdP2Q": "",
"FNCNP2Q": "",
"FNCEPS2Q": "",
"NxFNCSales2Q": "",
"NxFNCOP2Q": "",
"NxFNCOdP2Q": "",
"NxFNCNP2Q": "",
"NxFNCEPS2Q": "",
"FNCSales": "",
"FNCOP": "",
"FNCOdP": "",
"FNCNP": "",
"FNCEPS": "",
"NxFNCSales": "",
"NxFNCOP": "",
"NxFNCOdP": "",
"NxFNCNP": "",
"NxFNCEPS": "",
"ShEq": "318500000000",
"NCShEq": "",
"ROE": "0.112",
"NCROE": ""
}
],
"cursor": "eyJkIjoiMjAyNS0wNC0wMSIsInQiOiIyMDI1LTA0LTAxVDA4OjAwOjAwWiMyMDI1MDQwMTEzMDEwMCJ9"
}