# すべての財務諸表を取得 **API:** Data API **Endpoint:** `GET /v1/beta/financial/financials` **Tags:** Financial Data 1 社の 3 つの財務諸表を 1 回の呼び出しで取得します。`income_statements`、`balance_sheets`、`cash_flow_statements` を保持する `financials` オブジェクトを返し、それぞれ専用ツールが返す形と同じです。`period` は必須（annual、quarterly、ttm）です。`ticker` または `cik` で企業を指定し、`limit` で上限を設定します。全体像が必要で、そうでなければ 3 回呼び出すことになる場合に使います。財務諸表が 1 つだけ必要な場合は、`get_financial_financials_income_statements`、`get_financial_financials_balance_sheets`、`get_financial_financials_cash_flow_statements` の方がはるかに少ないデータを返します。複数企業にまたがる少数の指定フィールドが必要な場合は、`post_financial_financials_search_line_items` の方がさらに範囲が狭くなります。 ### 料金の参考情報 - 計量方式：成功リクエストあたりの固定コスト基準。 - 参考リクエスト見積もり：USD 0.02。 - 参照用の顧客乗数：1.0。確定済みの顧客金額には再適用しないでください。 参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。 ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `cik` | query | no | string | 企業の Central Index Key（CIK）。 | | `cursor` | query | no | string | 以前のレスポンスの next_page_url から取得した不透明なページネーションカーソル。指定すると、他のクエリパラメータはすべて無視されます。カーソルには元のリクエストのフィルターが含まれます。不透明な値として扱い、構築や変更は行わないでください。 | | `filing_date` | query | no | string, (date) | SEC 申告日の完全一致でフィルターします。形式は YYYY-MM-DD です。申告日が不明な行は除外されます。 | | `filing_date_gt` | query | no | string, (date) | SEC 申告日が指定日より後のものでフィルターします。形式は YYYY-MM-DD です。申告日が不明な行は除外されます。 | | `filing_date_gte` | query | no | string, (date) | SEC 申告日が指定日以降のものでフィルターします。形式は YYYY-MM-DD です。申告日が不明な行は除外されます。 | | `filing_date_lt` | query | no | string, (date) | SEC 申告日が指定日より前のものでフィルターします。形式は YYYY-MM-DD です。申告日が不明な行は除外されます。 | | `filing_date_lte` | query | no | string, (date) | SEC 申告日が指定日以前のものでフィルターします。形式は YYYY-MM-DD です。時点指定の照会に適しており、その日までに公開申告されたデータのみを返します。申告日が不明な行は除外されます。 | | `limit` | query | no | integer, (int32) | 返す財務諸表の最大数。これはページサイズではなく全ページの合計です。各ページには最大 10 件のレコードが含まれ、`next_page_url` でリンクされます。 | | `period` | query | yes | string, enum: "annual", "quarterly", "ttm" | 財務諸表の期間。 | | `report_period` | query | no | string, (date) | 報告期間の日付の完全一致でフィルターします。形式は YYYY-MM-DD です。 | | `report_period_gt` | query | no | string, (date) | レポート期間が YYYY-MM-DD 形式の日付より大きいものでフィルタします。 | | `report_period_gte` | query | no | string, (date) | レポート期間が YYYY-MM-DD 形式の日付以上であるものでフィルタします。 | | `report_period_lt` | query | no | string, (date) | レポート期間が YYYY-MM-DD 形式の日付より小さいものでフィルタします。 | | `report_period_lte` | query | no | string, (date) | レポート期間が YYYY-MM-DD 形式の日付以下であるものでフィルタします。 | | `ticker` | query | no | string | ティッカーシンボル。cik が指定されていない場合は必須です。 | ## Responses ### 200 — 財務諸表のレスポンス Headers: - `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。 **application/json** Schema: `ResponseE40Feb4D3D6B_FinancialsResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_FinancialsResponse`) ### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。 ### 401 — 有効な Felo API キーが必要です。 ### 402 — 請求要件が満たされていないため、リクエストを続行できません。 ### 403 — このアカウントにはこの操作を行う権限がありません。 ### 429 — リクエストまたは支出の上限に達しました。 ### 502 — サービスがリクエストを完了できませんでした。 ### 503 — API または請求サービスが一時的に利用できません。 ### 504 — リクエストの処理中にサービスがタイムアウトしました。 ### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります **application/json** Schema: ```json {} ``` ## Schema definitions ### ResponseE40Feb4D3D6B_BalanceSheet `#/components/schemas/ResponseE40Feb4D3D6B_BalanceSheet` ```json { "type": "object", "properties": { "ticker": { "type": "string", "description": "ティッカーシンボル。" }, "report_period": { "type": "string", "format": "date", "description": "貸借対照表の報告期間。" }, "fiscal_period": { "type": "string", "description": "貸借対照表の会計期間。" }, "period": { "type": "string", "enum": [ "quarterly", "ttm", "annual" ], "description": "貸借対照表の期間。" }, "currency": { "type": "string", "description": "財務データが報告される通貨。" }, "accession_number": { "type": [ "string", "null" ], "description": "提出書類の SEC accession number。" }, "form_type": { "type": [ "string", "null" ], "description": "この行の取得元となった SEC フォーム（`10-K`、`10-Q/A`、`20-F`、`S-1` など）。提出時そのままのフォームであるため、修正版には `/A` サフィックスが付きます。`period` が `ttm` の場合は null です。直近 12 か月のウィンドウは複数の提出書類にまたがる可能性があるため、1 つの書類に帰属させません。第 4 四半期が会計年度の提出書類から導出される場合、`quarterly` の行に `10-K` が付くことがあります。" }, "filing_url": { "type": [ "string", "null" ], "format": "uri", "description": "SEC 提出書類の URL。" }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "SEC が提出書類を受理した日（米国東部時間、SEC の運用タイムゾーン）。`filing_datetime` と対になる日単位の値。行に日付のある SEC 提出書類がリンクされていない場合は null です。" }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "SEC が提出書類を受理した時刻を記録する、1 日未満の精度のタイムスタンプ（米国東部時間）。SEC の EDGAR submissions API の `acceptanceDateTime` フィールドから取得します。`filing_date` と対になります（同じイベントの日単位の精度）。" }, "total_assets": { "type": "number", "description": "会社の総資産。" }, "current_assets": { "type": "number", "description": "会社の流動資産。" }, "cash_and_equivalents": { "type": "number", "description": "会社の現金および現金同等物。" }, "inventory": { "type": "number", "description": "会社の棚卸資産。" }, "current_investments": { "type": "number", "description": "会社の流動投資。" }, "trade_and_non_trade_receivables": { "type": "number", "description": "会社の営業債権および非営業債権。" }, "non_current_assets": { "type": "number", "description": "会社の非流動資産。" }, "property_plant_and_equipment": { "type": "number", "description": "会社の有形固定資産。" }, "goodwill_and_intangible_assets": { "type": "number", "description": "会社ののれんおよび無形資産。" }, "investments": { "type": "number", "description": "会社の投資。" }, "non_current_investments": { "type": "number", "description": "会社の非流動投資。" }, "outstanding_shares": { "type": "number", "description": "会社の発行済株式数。" }, "tax_assets": { "type": "number", "description": "会社の税務資産。" }, "total_liabilities": { "type": "number", "description": "会社の総負債。" }, "current_liabilities": { "type": "number", "description": "会社の流動負債。" }, "current_debt": { "type": "number", "description": "会社の短期債務。" }, "trade_and_non_trade_payables": { "type": "number", "description": "会社の営業債務および非営業債務。" }, "deferred_revenue": { "type": "number", "description": "会社の繰延収益。" }, "deposit_liabilities": { "type": "number", "description": "会社の預金負債。" }, "non_current_liabilities": { "type": "number", "description": "会社の非流動負債。" }, "non_current_debt": { "type": "number", "description": "会社の非流動債務。" }, "tax_liabilities": { "type": "number", "description": "会社の税務負債。" }, "shareholders_equity": { "type": "number", "description": "会社の株主資本。" }, "retained_earnings": { "type": "number", "description": "会社の利益剰余金。" }, "accumulated_other_comprehensive_income": { "type": "number", "description": "会社のその他の包括利益累計額。" }, "total_debt": { "type": "number", "description": "会社の総債務。" } } } ``` ### ResponseE40Feb4D3D6B_CashFlowStatement `#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatement` ```json { "type": "object", "properties": { "ticker": { "type": "string", "description": "ティッカーシンボル。" }, "report_period": { "type": "string", "format": "date", "description": "キャッシュ・フロー計算書の報告期間。" }, "fiscal_period": { "type": "string", "description": "キャッシュ・フロー計算書の会計期間。" }, "period": { "type": "string", "enum": [ "quarterly", "ttm", "annual" ], "description": "キャッシュ・フロー計算書の期間。" }, "currency": { "type": "string", "description": "財務データが報告される通貨。" }, "accession_number": { "type": [ "string", "null" ], "description": "提出書類の SEC accession number。" }, "form_type": { "type": [ "string", "null" ], "description": "この行の取得元となった SEC フォーム（`10-K`、`10-Q/A`、`20-F`、`S-1` など）。提出時そのままのフォームであるため、修正版には `/A` サフィックスが付きます。`period` が `ttm` の場合は null です。直近 12 か月のウィンドウは複数の提出書類にまたがる可能性があるため、1 つの書類に帰属させません。第 4 四半期が会計年度の提出書類から導出される場合、`quarterly` の行に `10-K` が付くことがあります。" }, "filing_url": { "type": [ "string", "null" ], "format": "uri", "description": "SEC 提出書類の URL。" }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "SEC が提出書類を受理した日（米国東部時間、SEC の運用タイムゾーン）。`filing_datetime` と対になる日単位の値。行に日付のある SEC 提出書類がリンクされていない場合は null です。" }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "SEC が提出書類を受理した時刻を記録する、1 日未満の精度のタイムスタンプ（米国東部時間）。SEC の EDGAR submissions API の `acceptanceDateTime` フィールドから取得します。`filing_date` と対になります（同じイベントの日単位の精度）。" }, "net_income": { "type": "number", "description": "会社の純利益。" }, "depreciation_and_amortization": { "type": "number", "description": "会社の減価償却費および償却費。" }, "share_based_compensation": { "type": "number", "description": "会社の株式報酬費用。" }, "net_cash_flow_from_operations": { "type": "number", "description": "会社の営業活動による純キャッシュフロー。" }, "capital_expenditure": { "type": "number", "description": "会社の設備投資。" }, "business_acquisitions_and_disposals": { "type": "number", "description": "会社の事業の取得および売却。" }, "investment_acquisitions_and_disposals": { "type": "number", "description": "会社の投資の取得および売却。" }, "net_cash_flow_from_investing": { "type": "number", "description": "会社の投資活動による純キャッシュフロー。" }, "issuance_or_repayment_of_debt_securities": { "type": "number", "description": "会社の債務証券の発行または償還。" }, "issuance_or_purchase_of_equity_shares": { "type": "number", "description": "会社の普通株式の発行または買戻し。" }, "dividends_and_other_cash_distributions": { "type": "number", "description": "会社の配当およびその他の現金分配。" }, "net_cash_flow_from_financing": { "type": "number", "description": "会社の財務活動による純キャッシュフロー。" }, "change_in_cash_and_equivalents": { "type": "number", "description": "会社の現金および現金同等物の増減。" }, "effect_of_exchange_rate_changes": { "type": "number", "description": "会社の為替レート変動の影響。" }, "ending_cash_balance": { "type": "number", "description": "会社の期末現金残高。" }, "free_cash_flow": { "type": "number", "description": "会社のフリーキャッシュフロー。" } } } ``` ### ResponseE40Feb4D3D6B_FinancialsResponse `#/components/schemas/ResponseE40Feb4D3D6B_FinancialsResponse` ```json { "type": "object", "properties": { "financials": { "type": "object", "properties": { "income_statements": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_IncomeStatement" } }, "balance_sheets": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_BalanceSheet" } }, "cash_flow_statements": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatement" } } } }, "next_page_url": { "type": "string", "description": "次の結果ページの絶対 URL。さらに結果が残っている場合にのみ含まれます。そのままリクエストすると続行できます。各ページには最大 10 件のレコードが含まれます。" } } } ``` ### ResponseE40Feb4D3D6B_IncomeStatement `#/components/schemas/ResponseE40Feb4D3D6B_IncomeStatement` ```json { "type": "object", "properties": { "ticker": { "type": "string", "description": "ティッカーシンボル。" }, "report_period": { "type": "string", "format": "date", "description": "損益計算書の報告期間。" }, "fiscal_period": { "type": "string", "description": "損益計算書の会計期間。" }, "period": { "type": "string", "enum": [ "quarterly", "ttm", "annual" ], "description": "損益計算書の期間。" }, "currency": { "type": "string", "description": "財務データが報告される通貨。" }, "accession_number": { "type": [ "string", "null" ], "description": "提出書類の SEC accession number。" }, "form_type": { "type": [ "string", "null" ], "description": "この行の取得元となった SEC フォーム（`10-K`、`10-Q/A`、`20-F`、`S-1` など）。提出時そのままのフォームであるため、修正版には `/A` サフィックスが付きます。`period` が `ttm` の場合は null です。直近 12 か月のウィンドウは複数の提出書類にまたがる可能性があるため、1 つの書類に帰属させません。第 4 四半期が会計年度の提出書類から導出される場合、`quarterly` の行に `10-K` が付くことがあります。" }, "filing_url": { "type": [ "string", "null" ], "format": "uri", "description": "SEC 提出書類の URL。" }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "SEC が提出書類を受理した日（米国東部時間、SEC の運用タイムゾーン）。`filing_datetime` と対になる日単位の値。行に日付のある SEC 提出書類がリンクされていない場合は null です。" }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "SEC が提出書類を受理した時刻を記録する、1 日未満の精度のタイムスタンプ（米国東部時間）。SEC の EDGAR submissions API の `acceptanceDateTime` フィールドから取得します。`filing_date` と対になります（同じイベントの日単位の精度）。" }, "revenue": { "type": "number", "description": "会社の総売上高。" }, "cost_of_revenue": { "type": "number", "description": "会社の売上原価。" }, "gross_profit": { "type": "number", "description": "会社の売上総利益。" }, "operating_expense": { "type": "number", "description": "会社の営業費用。" }, "selling_general_and_administrative_expenses": { "type": "number", "description": "会社の販売費および一般管理費。" }, "research_and_development": { "type": "number", "description": "会社の研究開発費。" }, "operating_income": { "type": "number", "description": "会社の営業利益。" }, "interest_expense": { "type": "number", "description": "会社の支払利息。" }, "ebit": { "type": "number", "description": "会社の利息および税引前利益。" }, "income_tax_expense": { "type": "number", "description": "会社の法人所得税費用。" }, "net_income_discontinued_operations": { "type": "number", "description": "会社の非継続事業からの純利益。" }, "net_income_non_controlling_interests": { "type": "number", "description": "会社の非支配持分からの純利益。" }, "net_income": { "type": "number", "description": "会社の純利益。" }, "net_income_common_stock": { "type": "number", "description": "会社の普通株主に帰属する純利益。" }, "preferred_dividends_impact": { "type": "number", "description": "優先配当が会社の純利益に与える影響。" }, "consolidated_income": { "type": "number", "description": "会社の連結利益。" }, "earnings_per_share": { "type": "number", "description": "会社の 1 株当たり利益。" }, "earnings_per_share_diluted": { "type": "number", "description": "会社の希薄化後 1 株当たり利益。" }, "dividends_per_common_share": { "type": "number", "description": "会社の普通株式 1 株当たり配当金。" }, "weighted_average_shares": { "type": "number", "description": "会社の加重平均株式数。" }, "weighted_average_shares_diluted": { "type": "number", "description": "会社の希薄化後加重平均株式数。" } } } ```