財務情報(/fins/summary)
GET /v2/fins/summary
APIの概要
財務情報の開示日・銘柄コードを指定して、決算短信などの財務情報サマリーを取得できます。
銘柄コード（code）または日付（date）のいずれか一方、もしくは両方の指定が必要です。
本APIの留意点
- 会計基準について： APIから出力される各項目名は日本基準（JGAAP）の開示項目が基準となっています。そのため、IFRSや米国基準（USGAAP）の開示データにおいては、経常利益の概念がありませんので、データが空欄となっています。
- 項目のスケール、単位について： 当社側での単位換算・追加の丸め処理は行っておりません。各項目の正確な基準につきましては、原典である当該決算短信をご参照ください。
- 決算期変更について： 本APIには決算期変更を直接示す項目はありません。
- 開示順序について： 開示番号は開示順序を保証するものではございません。開示順序の判定には開示日時・時刻（
DiscDate・DiscTime）をご参照ください。 - 一株あたり配当実績について： 決算短信に記載された値をそのまま収録しており、当社側で株式分割・株式併合を反映した遡及調整は行っておりません。事業年度の途中や決算期末の後に株式分割・併合が行われた場合、決算短信の配当欄をどのように記載するかは開示会社の判断によって異なります。当該配当の基準日時点の金額をそのまま記載する例と、分割・併合後の株式数に換算して記載する例のいずれも存在するため、一律に開示時点の値、あるいは基準日時点の値と定まるものではございません。
- 適時開示インデックス一覧との同期について： TDnet/適時開示インデックス一覧(/td/list)と本APIは同期しておりません。そのため、適時開示インデックス一覧での新規開示検知時点では当該開示の財務情報を取得できない可能性があります。取得できない場合は、時間を置いて再度ご確認ください。
- レートリミットについて： 本APIには個別のレートリミットが適用されます。過去データの一括取得など効率的なデータ取得についてはベストプラクティスをご参照ください。
- 四半期開示見直し対応に伴うAPI項目の追加について：
- 四半期開示見直し対応において、決算短信サマリー様式の記載事項が以下のとおり変更されます。
- 変更前： 重要な⼦会社の異動（連結範囲の変更を伴う特定⼦会社の異動）
- 変更後： 連結範囲の重要な変更
- この対応に伴い、2024/7/22より本APIのレスポンス項目に"SignificantChangesInTheScopeOfConsolidation"（期中における連結範囲の重要な変更）を追加いたします。
- 詳細は、データ項目概要欄をご覧ください。
- 四半期開示見直し対応において、決算短信サマリー様式の記載事項が以下のとおり変更されます。
データ更新・訂正のポリシー
- 本APIは、各社が開示した決算短信のデータを提供しております。当社で分割調整や訂正等による過去データの遡及修正は行っておらず、各レコードは開示時点の基準の値を保持しております。
- 訂正開示には新しい開示番号（
DiscNo）が割り振られ、既存レコードは上書きされません。訂正前のレコードも残るため、開示番号（DiscNo）・開示日（DiscDate）により、どの時点の開示に基づく値かを識別できます。 - ただし、本APIでは開示が訂正であることを示す項目・フラグはございません。訂正前後の値を比較する場合は、同一銘柄の同一会計期間のレコードを開示日時順に並べてご確認ください。
- データ不備・不足等によるデータの追加・上書き修正の履歴については、データ修正履歴・制約事項をご参照ください。
- データ仕様について過去にお問い合わせのあった内容は、FAQ（データ内容・仕様）にも記載しておりますので、あわせてご参照ください。
財務情報データを取得します
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
GET
/v2/fins/summarycurl -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)
- 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"
}