# 财报快照（AI 摘要 + 预测对比）

`GET` `/v1/quote/financials/earnings-snapshot`

获取 AI 生成的财报摘要、营收/EBIT/EPS 预测对比（超预期/低于预期），以及关键财务指标。

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | 证券代码，例如 `AAPL.US` |
| `report` | string | No | 报告类型：`qf`（季报）/ `saf`（半年报）/ `af`（年报） |
| `fiscal_year` | integer | No | 财政年度，例如 `2024` |
| `fiscal_period` | string | No | 财政季度，例如 `1` / `2` / `3` / `4` |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/quote/financials/earnings-snapshot?symbol=<symbol>' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | No | 标的名称。 |
| `ticker` | string | No | 证券代码（不含市场后缀，例如 `AAPL`） |
| `currency` | string | No | 货币代码 |
| `report` | string | No | 报告期代码（如 `af` = 年报） |
| `fiscal_year` | integer | No | 财年 |
| `fiscal_period` | string | No | 财年内的财季序号 |
| `opt_reports` | array | No | 可选的报告期列表 |
| `fp_start` | string | No | 财政期开始日期，格式 `YYYY.MM.DD` |
| `fp_end` | string | No | 财政期结束日期，格式 `YYYY.MM.DD` |
| `report_desc` | string | No | AI 生成的财报摘要 |
| `fo_revenue` | object | No | 营收预测对比， |
| `└ value` | string | No | 实际值 |
| `└ yoy` | string | No | 同比增速（百分比，例如 `16.6`） |
| `└ est_value` | string | No | 一致预期值（可能为空） |
| `└ est_yoy` | string | No | 预估同比变化。 |
| `└ cmp` | string | No | 对比值。 |
| `└ cmp_desc` | string | No | 超预期/低于预期描述（可能为空） |
| `fo_ebit` | object | No | EBIT 预测对比， |
| `└ value` | string | No | 实际值 |
| `└ yoy` | string | No | 同比增速（百分比，例如 `16.6`） |
| `└ est_value` | string | No | 一致预期值（可能为空） |
| `└ est_yoy` | string | No | 预估同比变化。 |
| `└ cmp` | string | No | 对比值。 |
| `└ cmp_desc` | string | No | 超预期/低于预期描述（可能为空） |
| `fo_eps` | object | No | EPS 预测对比， |
| `└ value` | string | No | 实际值 |
| `└ yoy` | string | No | 同比增速（百分比，例如 `16.6`） |
| `└ est_value` | string | No | 一致预期值（可能为空） |
| `└ est_yoy` | string | No | 预估同比变化。 |
| `└ cmp` | string | No | 对比值。 |
| `└ cmp_desc` | string | No | 超预期/低于预期描述（可能为空） |
| `fr_roe_ttm` | string | No | 净资产收益率 TTM（百分比，例如 `141.47`） |
| `fr_asset_turn_ttm` | string | No | 资产周转率 TTM（百分比） |
| `fr_profit_margin_ttm` | string | No | 净利率 TTM（百分比） |
| `fr_leverage_ttm` | string | No | 杠杆率 TTM（百分比） |
| `fr_total_assets` | object | No | 总资产， |
| `└ value` | string | No | 实际值 |
| `└ yoy` | string | No | 同比增速（百分比，例如 `16.6`） |
| `└ est_value` | string | No | 一致预期值（可能为空） |
| `└ est_yoy` | string | No | 预估同比变化。 |
| `└ cmp` | string | No | 对比值。 |
| `└ cmp_desc` | string | No | 超预期/低于预期描述（可能为空） |
| `fr_total_liability` | object | No | 总负债， |
| `└ value` | string | No | 实际值 |
| `└ yoy` | string | No | 同比增速（百分比，例如 `16.6`） |
| `└ est_value` | string | No | 一致预期值（可能为空） |
| `└ est_yoy` | string | No | 预估同比变化。 |
| `└ cmp` | string | No | 对比值。 |
| `└ cmp_desc` | string | No | 超预期/低于预期描述（可能为空） |
| `fr_debt_assets_ratio` | string | No | 资产负债率（百分比） |
| `fr_revenue` | object | No | 营收财务数据， |
| `└ value` | string | No | 实际值 |
| `└ yoy` | string | No | 同比增速（百分比，例如 `16.6`） |
| `└ est_value` | string | No | 一致预期值（可能为空） |
| `└ est_yoy` | string | No | 预估同比变化。 |
| `└ cmp` | string | No | 对比值。 |
| `└ cmp_desc` | string | No | 超预期/低于预期描述（可能为空） |
| `fr_profit` | object | No | 净利润财务数据， |
| `└ value` | string | No | 实际值 |
| `└ yoy` | string | No | 同比增速（百分比，例如 `16.6`） |
| `└ est_value` | string | No | 一致预期值（可能为空） |
| `└ est_yoy` | string | No | 预估同比变化。 |
| `└ cmp` | string | No | 对比值。 |
| `└ cmp_desc` | string | No | 超预期/低于预期描述（可能为空） |
| `fr_profit_margin` | string | No | 净利率（百分比） |
| `fr_operate_cash` | object | No | 经营现金流， |
| `└ value` | string | No | 实际值 |
| `└ yoy` | string | No | 同比增速（百分比，例如 `16.6`） |
| `└ est_value` | string | No | 一致预期值（可能为空） |
| `└ est_yoy` | string | No | 预估同比变化。 |
| `└ cmp` | string | No | 对比值。 |
| `└ cmp_desc` | string | No | 超预期/低于预期描述（可能为空） |
| `fr_finance_cash` | object | No | 融资现金流， |
| `└ value` | string | No | 实际值 |
| `└ yoy` | string | No | 同比增速（百分比，例如 `16.6`） |
| `└ est_value` | string | No | 一致预期值（可能为空） |
| `└ est_yoy` | string | No | 预估同比变化。 |
| `└ cmp` | string | No | 对比值。 |
| `└ cmp_desc` | string | No | 超预期/低于预期描述（可能为空） |
| `fr_invest_cash` | object | No | 投资现金流， |
| `└ value` | string | No | 实际值 |
| `└ yoy` | string | No | 同比增速（百分比，例如 `16.6`） |
| `└ est_value` | string | No | 一致预期值（可能为空） |
| `└ est_yoy` | string | No | 预估同比变化。 |
| `└ cmp` | string | No | 对比值。 |
| `└ cmp_desc` | string | No | 超预期/低于预期描述（可能为空） |
| `market` | string | No | 市场：`US`、`HK`、`CN`、`SG` |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "name": "Apple",
    "ticker": "AAPL",
    "fp_start": "2025.12.28",
    "fp_end": "2026.03.28",
    "currency": "USD",
    "report_desc": "Summary: Apple (AAPL) revenue was 111.18B (+16.6%); EPS was 2.01 (+21.82%).",
    "fo_revenue": {
      "value": "111184000000.0000",
      "yoy": "16.6",
      "cmp_desc": "",
      "est_value": ""
    },
    "fo_ebit": {
      "value": "35885000000.0000",
      "yoy": "21.28",
      "cmp_desc": "",
      "est_value": ""
    },
    "fo_eps": {
      "value": "2.0100",
      "yoy": "21.82",
      "cmp_desc": "",
      "est_value": ""
    },
    "fr_revenue": {
      "value": "111184000000.0000",
      "yoy": "16.6"
    },
    "fr_profit": {
      "value": "29578000000.0000",
      "yoy": "19.36"
    },
    "fr_roe_ttm": "141.4705",
    "fr_profit_margin": "26.6027",
    "fr_debt_assets_ratio": "71.3025"
  }
}
```
