# 財務指標を取得 **API:** Data API **Endpoint:** `GET /v1/beta/financial/financial-metrics` **Tags:** Financial Data 1 社について時系列で計算された比率で、期間ごとに約 49 項目です。`market_cap`、`enterprise_value`、`price_to_earnings_ratio`、`price_to_book_ratio`、`price_to_sales_ratio`、`enterprise_value_to_ebitda_ratio`、`free_cash_flow_yield`、`peg_ratio`、`gross_margin`、`operating_margin`、`net_margin`、`return_on_equity`、`return_on_assets`、`return_on_invested_capital`、回転率と流動性比率を含み、それぞれに `report_period` と `fiscal_period` が付きます。`period` は必須です。`ticker` または `cik` で企業を指定します。比率の期間をまたいだ傾向を見るために使います。現在値だけが必要な場合、`get_financial_financial_metrics_snapshot` は 1 行だけで、はるかに小さくなります。 ### 料金の参考情報 - 計量方式：成功リクエストあたりの固定コスト基準。 - 参考リクエスト見積もり：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）。ticker の代わりに使用できます。 | | `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 | 返す最大結果数。これはページサイズではなく全ページの合計です。各ページには最大 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 — ある ticker の過去の財務指標と比率 Headers: - `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。 **application/json** Schema: `ResponseE40Feb4D3D6B_FinancialMetricsResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_FinancialMetricsResponse`) ### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。 ### 401 — 有効な Felo API キーが必要です。 ### 402 — 請求要件が満たされていないため、リクエストを続行できません。 ### 403 — このアカウントにはこの操作を行う権限がありません。 ### 429 — リクエストまたは支出の上限に達しました。 ### 502 — サービスがリクエストを完了できませんでした。 ### 503 — API または請求サービスが一時的に利用できません。 ### 504 — リクエストの処理中にサービスがタイムアウトしました。 ### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります **application/json** Schema: ```json {} ``` ## Schema definitions ### ResponseE40Feb4D3D6B_FinancialMetricsResponse `#/components/schemas/ResponseE40Feb4D3D6B_FinancialMetricsResponse` ```json { "type": "object", "properties": { "ticker": { "type": "string", "description": "会社の ticker シンボル。" }, "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` と対になります（同じイベントの日単位の精度）。" }, "enterprise_value": { "type": "number", "description": "会社の総価値（時価総額 + 債務 - 現金）。" }, "price_to_earnings_ratio": { "type": "number", "description": "株価収益率。" }, "price_to_book_ratio": { "type": "number", "description": "株価純資産倍率。" }, "price_to_sales_ratio": { "type": "number", "description": "株価売上高倍率。" }, "enterprise_value_to_ebitda_ratio": { "type": "number", "description": "企業価値対 EBITDA 比率。" }, "enterprise_value_to_revenue_ratio": { "type": "number", "description": "企業価値対売上高比率。" }, "free_cash_flow_yield": { "type": "number", "description": "フリーキャッシュフロー利回り。" }, "peg_ratio": { "type": "number", "description": "株価収益成長率（PEG）。" }, "gross_margin": { "type": "number", "description": "売上総利益の売上高に対する比率。" }, "operating_margin": { "type": "number", "description": "営業利益の売上高に対する比率。" }, "net_margin": { "type": "number", "description": "純利益の売上高に対する比率。" }, "return_on_equity": { "type": "number", "description": "純利益の株主資本に対する比率。" }, "return_on_assets": { "type": "number", "description": "純利益の総資産に対する比率。" }, "return_on_invested_capital": { "type": "number", "description": "税引後営業利益の投下資本に対する比率。" }, "asset_turnover": { "type": "number", "description": "売上高を平均総資産で割った値。" }, "inventory_turnover": { "type": "number", "description": "売上原価を平均棚卸資産で割った値。" }, "receivables_turnover": { "type": "number", "description": "売上高を平均売掛金で割った値。" }, "days_sales_outstanding": { "type": "number", "description": "期間中の平均売掛金を売上高で割った値。" }, "operating_cycle": { "type": "number", "description": "棚卸資産回転率 + 売上債権回転率。" }, "working_capital_turnover": { "type": "number", "description": "売上高を平均運転資本で割った値。" }, "current_ratio": { "type": "number", "description": "流動資産を流動負債で割った値。" }, "quick_ratio": { "type": "number", "description": "当座資産を流動負債で割った値。" }, "cash_ratio": { "type": "number", "description": "現金および現金同等物を流動負債で割った値。" }, "operating_cash_flow_ratio": { "type": "number", "description": "営業キャッシュフローを流動負債で割った値。" }, "debt_to_equity": { "type": "number", "description": "総債務を株主資本で割った値。" }, "debt_to_assets": { "type": "number", "description": "総債務を総資産で割った値。" }, "interest_coverage": { "type": "number", "description": "EBIT を支払利息で割った値。" }, "revenue_growth": { "type": "number", "description": "売上高の前年比成長率。" }, "earnings_growth": { "type": "number", "description": "利益の前年比成長率。" }, "book_value_growth": { "type": "number", "description": "簿価の前年比成長率。" }, "earnings_per_share_growth": { "type": "number", "description": "期間中の 1 株当たり利益の成長率。" }, "free_cash_flow_growth": { "type": "number", "description": "期間中のフリーキャッシュフローの成長率。" }, "operating_income_growth": { "type": "number", "description": "期間中の営業利益の成長率。" }, "ebitda_growth": { "type": "number", "description": "期間中の EBITDA の成長率。" }, "payout_ratio": { "type": "number", "description": "支払配当金の純利益に対する比率。" }, "earnings_per_share": { "type": "number", "description": "純利益を加重平均発行済株式数で割った値。" }, "book_value_per_share": { "type": "number", "description": "株主資本を発行済株式数で割った値。" }, "free_cash_flow_per_share": { "type": "number", "description": "フリーキャッシュフローを発行済株式数で割った値。" }, "next_page_url": { "type": "string", "description": "次の結果ページの絶対 URL。さらに結果が残っている場合にのみ含まれます。そのままリクエストすると続行できます。各ページには最大 10 件のレコードが含まれます。" } } } ```