# 決算スナップショットを取得

**API:** Data API

**Endpoint:** `GET /v1/beta/financial/earnings`

**Tags:** Financial Data

1 銘柄について実際に発表された決算を、実績と予想の対比で示します。各エントリには `report_period`、`fiscal_period`、`filing_date`、`filing_url`、`accession_number`、`revenue`、`estimated_revenue`、`revenue_surprise`、`revenue_surprise_pct` を含む `quarterly` ブロック、`earnings_per_share` について同じ 3 項目、さらに前年比変化のフィールドが含まれます。`signals` も返します。これは EPS_BEAT のような上流で計算されたフラグで、`headline` とその背景にある `actual` / `estimate` / `surprise_pct` を伴います。`ticker` は必須で、唯一のパラメーターです。企業が実際に発表した内容を知るために使います。まだ発生していない前方視的なコンセンサス予想には `get_financial_analyst_estimates` を使います。

### 料金の参考情報

- 計量方式：成功リクエストあたりの固定コスト基準。
- 参考リクエスト見積もり：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 |
| --- | --- | --- | --- | --- |
| `cursor` | query | no | string | 以前のレスポンスの next_page_url から取得した不透明なページネーションカーソル。指定すると、他のクエリパラメータはすべて無視されます。カーソルには元のリクエストのフィルターが含まれます。不透明な値として扱い、構築や変更は行わないでください。 |
| `limit` | query | no | integer, default: 1 | 返す直近の **レポート期間** 分の提出書類の数。`(report_period DESC, filing_date ASC)` で並べ替えます。直近の期間に 8-K と 10-Q / 10-K の両方が含まれる場合、返される件数が `limit` を超えることがあります。40 を超える値は 40 に制限されます。正でない値または整数でない値は 400 を返します。これはページサイズではなく全ページの合計です。各ページには最大 10 件のレコードが含まれ、`next_page_url` でリンクされます。 |
| `ticker` | query | yes | string | ティッカーシンボル（例: `AAPL`）。 |

## Responses

### 200 — 決算のレスポンス

Headers:
- `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。

**application/json**

Schema: `ResponseE40Feb4D3D6B_EarningsResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_EarningsResponse`)

### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。

### 401 — 有効な Felo API キーが必要です。

### 402 — 請求要件が満たされていないため、リクエストを続行できません。

### 403 — このアカウントにはこの操作を行う権限がありません。

### 429 — リクエストまたは支出の上限に達しました。

### 502 — サービスがリクエストを完了できませんでした。

### 503 — API または請求サービスが一時的に利用できません。

### 504 — リクエストの処理中にサービスがタイムアウトしました。

### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_EarningsRecord

`#/components/schemas/ResponseE40Feb4D3D6B_EarningsRecord`

```json
{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "リクエストされた ticker シンボル。"
    },
    "report_period": {
      "type": "string",
      "format": "date",
      "description": "この提出書類が対象とする報告期間。"
    },
    "fiscal_period": {
      "type": "string",
      "description": "会計期間のラベル（例：2026-Q1 または 2025-FY）。"
    },
    "currency": {
      "type": "string",
      "description": "ISO 通貨コード（例：USD）。"
    },
    "source_type": {
      "type": "string",
      "description": "この提出書類の基になる SEC フォームの種類。",
      "enum": [
        "8-K",
        "10-Q",
        "10-K",
        "20-F"
      ]
    },
    "filing_date": {
      "type": "string",
      "format": "date",
      "description": "SEC が提出書類を受理した日（米国東部時間、SEC の運用タイムゾーン）。`filing_datetime` と対になる日単位の値。"
    },
    "filing_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "SEC が提出書類を受理した時刻を記録する、1 日未満の精度のタイムスタンプ（米国東部時間）。SEC の EDGAR submissions API の `acceptanceDateTime` フィールドから取得します。`filing_date` と対になります（同じイベントの日単位の精度）。"
    },
    "filing_window": {
      "type": [
        "string",
        "null"
      ],
      "description": "SEC が提出書類を受理した時点のマーケットセッションを、米国東部時間で評価したものです。PRE_MARKET = 平日 04:00–09:30 ET。DURING_MARKET = 平日 09:30–16:00 ET。AFTER_HOURS = 平日の通常取引時間外。WEEKEND = 土曜日または日曜日。filing_datetime が利用できない場合は null です。",
      "enum": [
        "PRE_MARKET",
        "DURING_MARKET",
        "AFTER_HOURS",
        "WEEKEND"
      ]
    },
    "signals": {
      "type": "array",
      "description": "この提出書類から抽出した、株価に影響しうる厳選されたインサイトです。各項目には、事前にレンダリングされた `headline`、構造化された `details`、`importance` ランキングが含まれます。このエントリで少なくとも 1 つのシグナルが発火した場合にのみ返され、それ以外の場合はこのフィールドが省略されます。1 エントリあたり最大 8 件で、HIGH → MEDIUM → LOW の順に並びます。",
      "items": {
        "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_Signal"
      }
    },
    "filing_url": {
      "type": "string",
      "format": "uri",
      "description": "SEC 提出書類の URL。"
    },
    "accession_number": {
      "type": "string",
      "description": "提出書類を識別する SEC accession number。"
    },
    "quarterly": {
      "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_EarningsTimeDimension"
    },
    "annual": {
      "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_EarningsTimeDimension"
    }
  },
  "required": [
    "ticker",
    "report_period",
    "source_type",
    "filing_date",
    "filing_url",
    "accession_number"
  ]
}
```

### ResponseE40Feb4D3D6B_EarningsResponse

`#/components/schemas/ResponseE40Feb4D3D6B_EarningsResponse`

```json
{
  "type": "object",
  "properties": {
    "earnings": {
      "type": "array",
      "description": "その ticker の SEC 提出書類のフラットなリストで、(report_period DESC, filing_date ASC) で並べ替えられます。`limit=N` の場合、最大 N 報告期間分の提出書類が返されます。直近の期間に 8-K と 10-Q/10-K の両方が含まれる場合、エントリ数が N を超えることがあります。",
      "items": {
        "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_EarningsRecord"
      }
    },
    "next_page_url": {
      "type": "string",
      "description": "次の結果ページの絶対 URL。さらに結果が残っている場合にのみ含まれます。そのままリクエストすると続行できます。各ページには最大 10 件のレコードが含まれます。"
    }
  }
}
```

### ResponseE40Feb4D3D6B_EarningsTimeDimension

`#/components/schemas/ResponseE40Feb4D3D6B_EarningsTimeDimension`

```json
{
  "type": "object",
  "properties": {
    "revenue": {
      "type": [
        "number",
        "null"
      ]
    },
    "revenue_chg": {
      "type": "number",
      "description": "売上高の前期に対する変化率（小数、例：0.10 = +10%）。四半期ペイロードでは前期比、年次ペイロードでは前年比です。計算可能な場合にのみ返されます。"
    },
    "revenue_yoy_chg": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する売上高の前年比変化（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "earnings_per_share": {
      "type": [
        "number",
        "null"
      ]
    },
    "earnings_per_share_chg": {
      "type": "number",
      "description": "EPS の前期に対する変化率（小数）。四半期ペイロードでは前期比、年次ペイロードでは前年比です。計算可能な場合にのみ返されます。"
    },
    "earnings_per_share_yoy_chg": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する EPS の前年比変化（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "gross_profit": {
      "type": [
        "number",
        "null"
      ]
    },
    "gross_profit_chg": {
      "type": "number",
      "description": "売上総利益の前期に対する変化率（小数）。四半期ペイロードでは前期比、年次ペイロードでは前年比です。計算可能な場合にのみ返されます。"
    },
    "gross_profit_yoy_chg": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する売上総利益の前年比変化（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "gross_margin": {
      "type": "number",
      "description": "売上総利益率（小数、gross_profit / revenue）。計算可能な場合にのみ返されます。"
    },
    "gross_margin_chg_bps": {
      "type": "number",
      "description": "売上総利益率の前期に対する絶対変化（ベーシスポイント、例：200.0 = マージンが 200 bps 拡大）。計算可能な場合にのみ返されます。"
    },
    "gross_margin_chg_pct": {
      "type": "number",
      "description": "売上総利益率の前期に対する変化率（小数）。計算可能な場合にのみ返されます。"
    },
    "gross_margin_yoy_chg_bps": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する売上総利益率の前年比変化（ベーシスポイント）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "gross_margin_yoy_chg_pct": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する売上総利益率の前年比変化率（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "operating_income": {
      "type": [
        "number",
        "null"
      ]
    },
    "operating_income_chg": {
      "type": "number",
      "description": "営業利益の前期に対する変化率（小数）。四半期ペイロードでは前期比、年次ペイロードでは前年比です。計算可能な場合にのみ返されます。"
    },
    "operating_income_yoy_chg": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する営業利益の前年比変化（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "operating_margin": {
      "type": "number",
      "description": "営業利益率（小数、operating_income / revenue）。計算可能な場合にのみ返されます。"
    },
    "operating_margin_chg_bps": {
      "type": "number",
      "description": "営業利益率の前期に対する絶対変化（ベーシスポイント）。計算可能な場合にのみ返されます。"
    },
    "operating_margin_chg_pct": {
      "type": "number",
      "description": "営業利益率の前期に対する変化率（小数）。計算可能な場合にのみ返されます。"
    },
    "operating_margin_yoy_chg_bps": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する営業利益率の前年比変化（ベーシスポイント）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "operating_margin_yoy_chg_pct": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する営業利益率の前年比変化率（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "net_income": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_income_chg": {
      "type": "number",
      "description": "純利益の前期に対する変化率（小数）。四半期ペイロードでは前期比、年次ペイロードでは前年比です。計算可能な場合にのみ返されます。"
    },
    "net_income_yoy_chg": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する純利益の前年比変化（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "net_margin": {
      "type": "number",
      "description": "純利益率（小数、net_income / revenue）。計算可能な場合にのみ返されます。"
    },
    "net_margin_chg_bps": {
      "type": "number",
      "description": "純利益率の前期に対する絶対変化（ベーシスポイント）。計算可能な場合にのみ返されます。"
    },
    "net_margin_chg_pct": {
      "type": "number",
      "description": "純利益率の前期に対する変化率（小数）。計算可能な場合にのみ返されます。"
    },
    "net_margin_yoy_chg_bps": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する純利益率の前年比変化（ベーシスポイント）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "net_margin_yoy_chg_pct": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する純利益率の前年比変化率（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "weighted_average_shares": {
      "type": [
        "number",
        "null"
      ]
    },
    "weighted_average_shares_diluted": {
      "type": [
        "number",
        "null"
      ]
    },
    "cash_and_equivalents": {
      "type": [
        "number",
        "null"
      ]
    },
    "change_in_cash_and_equivalents": {
      "type": [
        "number",
        "null"
      ]
    },
    "total_debt": {
      "type": [
        "number",
        "null"
      ]
    },
    "total_assets": {
      "type": [
        "number",
        "null"
      ]
    },
    "total_liabilities": {
      "type": [
        "number",
        "null"
      ]
    },
    "shareholders_equity": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_cash_flow_from_operations": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_cash_flow_from_operations_chg": {
      "type": "number",
      "description": "営業活動による純キャッシュフローの前期に対する変化率（小数）。四半期ペイロードでは前期比、年次ペイロードでは前年比です。計算可能な場合にのみ返されます。"
    },
    "net_cash_flow_from_operations_yoy_chg": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する営業活動による純キャッシュフローの前年比変化（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "net_cash_flow_from_investing": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_cash_flow_from_investing_chg": {
      "type": "number",
      "description": "投資活動による純キャッシュフローの前期に対する変化率（小数）。四半期ペイロードでは前期比、年次ペイロードでは前年比です。計算可能な場合にのみ返されます。"
    },
    "net_cash_flow_from_investing_yoy_chg": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する投資活動による純キャッシュフローの前年比変化（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "net_cash_flow_from_financing": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_cash_flow_from_financing_chg": {
      "type": "number",
      "description": "財務活動による純キャッシュフローの前期に対する変化率（小数）。四半期ペイロードでは前期比、年次ペイロードでは前年比です。計算可能な場合にのみ返されます。"
    },
    "net_cash_flow_from_financing_yoy_chg": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する財務活動による純キャッシュフローの前年比変化（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "capital_expenditure": {
      "type": [
        "number",
        "null"
      ]
    },
    "capital_expenditure_chg": {
      "type": "number",
      "description": "設備投資の前期に対する変化率（小数）。四半期ペイロードでは前期比、年次ペイロードでは前年比です。計算可能な場合にのみ返されます。"
    },
    "capital_expenditure_yoy_chg": {
      "type": "number",
      "description": "前年同期の同じ四半期に対する設備投資の前年比変化（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    },
    "free_cash_flow": {
      "type": [
        "number",
        "null"
      ]
    },
    "free_cash_flow_chg": {
      "type": "number",
      "description": "フリーキャッシュフローの前期に対する変化率（小数）。四半期ペイロードでは前期比、年次ペイロードでは前年比です。計算可能な場合にのみ返されます。"
    },
    "free_cash_flow_yoy_chg": {
      "type": "number",
      "description": "前年同期の同じ四半期に対するフリーキャッシュフローの前年比変化（小数）。四半期ペイロードのみ。計算可能な場合にのみ返されます。"
    }
  }
}
```

### ResponseE40Feb4D3D6B_Signal

`#/components/schemas/ResponseE40Feb4D3D6B_Signal`

```json
{
  "type": "object",
  "description": "この提出書類から抽出した、株価に影響しうる厳選されたインサイトです。事前にレンダリングされた `headline` はそのまま表示でき、`details` にはフィルタリングやプログラムでの利用に適した構造化フィールドが入ります。シグナルは優先順位順（重要なものから）で返され、`type` 自体が規模を表します（例：`STRONG_REVENUE_INCREASE` と `REVENUE_INCREASE`）。",
  "required": [
    "type",
    "headline"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "シグナルのカテゴリ。MARGIN_EXPANSION/MARGIN_CONTRACTION：売上総利益率、営業利益率、純利益率のいずれかが前年比で ≥100bps 変動した場合。GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED：提出書類で報告された前方視的なガイダンスの変更。SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE：オーガニック売上高成長率で最も良いまたは最も悪い報告セグメント。NON_GAAP_DIVERGENCE：調整後/非 GAAP の数値が、同期間の GAAP の対応する数値と大きく異なる場合。BACKLOG_SURGE/BACKLOG_DECLINE：受注残または残存履行義務が前年比で ≥20% 変動した場合。REVENUE_INCREASE/STRONG_REVENUE_INCREASE および DECLINE 系：段階別の売上高の前年比変化（≥10% / ≥20% の規模）。NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE および DECLINE 系：段階別の純利益の前年比変化（≥15% / ≥30%）。EPS_INCREASE/STRONG_EPS_INCREASE および DECLINE 系：段階別の EPS の前年比変化（≥15% / ≥30%）。純利益とは独立しています。自己株式取得が EPS の変動を増幅することがあるためです。CAPEX_INCREASE/STRONG_CAPEX_INCREASE および DECLINE 系：段階別の設備投資の前年比変化（支出規模で ≥15% / ≥30%）。",
      "enum": [
        "MARGIN_EXPANSION",
        "MARGIN_CONTRACTION",
        "GUIDANCE_RAISED",
        "GUIDANCE_LOWERED",
        "GUIDANCE_REAFFIRMED",
        "GUIDANCE_INITIATED",
        "SEGMENT_OUTPERFORMANCE",
        "SEGMENT_UNDERPERFORMANCE",
        "NON_GAAP_DIVERGENCE",
        "BACKLOG_SURGE",
        "BACKLOG_DECLINE",
        "REVENUE_INCREASE",
        "REVENUE_DECLINE",
        "STRONG_REVENUE_INCREASE",
        "STRONG_REVENUE_DECLINE",
        "NET_INCOME_INCREASE",
        "NET_INCOME_DECLINE",
        "STRONG_NET_INCOME_INCREASE",
        "STRONG_NET_INCOME_DECLINE",
        "EPS_INCREASE",
        "EPS_DECLINE",
        "STRONG_EPS_INCREASE",
        "STRONG_EPS_DECLINE",
        "CAPEX_INCREASE",
        "CAPEX_DECLINE",
        "STRONG_CAPEX_INCREASE",
        "STRONG_CAPEX_DECLINE"
      ]
    },
    "metric": {
      "type": [
        "string",
        "null"
      ],
      "description": "該当する場合に、このシグナルが参照する指標（例：`revenue`、`earnings_per_share`、`operating_margin`、またはガイダンス/KPI 指標名）。"
    },
    "period": {
      "type": [
        "string",
        "null"
      ],
      "description": "このシグナルが参照する会計期間（例：`2026-Q1`、`FY 2026`）。前方視的なガイダンスのシグナルはガイダンス対象期間を参照し、財務のシグナルはこの提出書類の報告期間を参照します。"
    },
    "headline": {
      "type": "string",
      "description": "事前にレンダリングされた、そのまま表示できる人間が読めるサマリー。"
    },
    "details": {
      "type": "object",
      "description": "シグナルタイプに固有の構造化フィールドです。内容はタイプによって異なります。ガイダンスのシグナルには `low`、`high`、`point_estimate`、`prior_value`、`revision_pct`、セグメントのシグナルには `best`、`worst`、`spread_pp`、非 GAAP のシグナルには `gaap_field`、`non_gaap_value`、`gaap_value`、`divergence_pct`、成長のシグナルには `current`、`yoy_chg` が含まれます。null 値は省略されます。タイプ別の例を参照してください。",
      "additionalProperties": true
    }
  }
}
```