# Financial Report Snapshot

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

Get an AI-generated earnings summary, revenue/EBIT/EPS forecast vs actual (beat/miss analysis), and key financial ratios.

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | Security symbol, e.g. `AAPL.US` |
| `report` | string | No | Report type: `qf` (quarterly) / `saf` (semi-annual) / `af` (annual) |
| `fiscal_year` | integer | No | Fiscal year, e.g. `2024` |
| `fiscal_period` | string | No | Fiscal period, e.g. `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 | Security name. |
| `ticker` | string | No | Ticker symbol without market suffix, e.g. `AAPL` |
| `currency` | string | No | Currency code |
| `report` | string | No | Report period code (e.g. `af` = annual) |
| `fiscal_year` | integer | No | Fiscal year |
| `fiscal_period` | string | No | Fiscal period number within the fiscal year |
| `opt_reports` | array | No | Optional available report periods |
| `fp_start` | string | No | Fiscal period start date in `YYYY.MM.DD` format |
| `fp_end` | string | No | Fiscal period end date in `YYYY.MM.DD` format |
| `report_desc` | string | No | AI-generated earnings summary |
| `fo_revenue` | object | No | Revenue forecast vs actual |
| `└ value` | string | No | Actual value |
| `└ yoy` | string | No | Year-over-year growth as percentage, e.g. `16.6` |
| `└ est_value` | string | No | Consensus estimate (may be empty) |
| `└ est_yoy` | string | No | Estimated year-over-year change. |
| `└ cmp` | string | No | Comparison value. |
| `└ cmp_desc` | string | No | Beat/miss description (may be empty) |
| `fo_ebit` | object | No | EBIT forecast vs actual |
| `└ value` | string | No | Actual value |
| `└ yoy` | string | No | Year-over-year growth as percentage, e.g. `16.6` |
| `└ est_value` | string | No | Consensus estimate (may be empty) |
| `└ est_yoy` | string | No | Estimated year-over-year change. |
| `└ cmp` | string | No | Comparison value. |
| `└ cmp_desc` | string | No | Beat/miss description (may be empty) |
| `fo_eps` | object | No | EPS forecast vs actual |
| `└ value` | string | No | Actual value |
| `└ yoy` | string | No | Year-over-year growth as percentage, e.g. `16.6` |
| `└ est_value` | string | No | Consensus estimate (may be empty) |
| `└ est_yoy` | string | No | Estimated year-over-year change. |
| `└ cmp` | string | No | Comparison value. |
| `└ cmp_desc` | string | No | Beat/miss description (may be empty) |
| `fr_roe_ttm` | string | No | ROE TTM as percentage, e.g. `141.47` |
| `fr_asset_turn_ttm` | string | No | Asset turnover TTM as percentage |
| `fr_profit_margin_ttm` | string | No | Net profit margin TTM as percentage |
| `fr_leverage_ttm` | string | No | Leverage TTM as percentage |
| `fr_total_assets` | object | No | Total assets |
| `└ value` | string | No | Actual value |
| `└ yoy` | string | No | Year-over-year growth as percentage, e.g. `16.6` |
| `└ est_value` | string | No | Consensus estimate (may be empty) |
| `└ est_yoy` | string | No | Estimated year-over-year change. |
| `└ cmp` | string | No | Comparison value. |
| `└ cmp_desc` | string | No | Beat/miss description (may be empty) |
| `fr_total_liability` | object | No | Total liabilities |
| `└ value` | string | No | Actual value |
| `└ yoy` | string | No | Year-over-year growth as percentage, e.g. `16.6` |
| `└ est_value` | string | No | Consensus estimate (may be empty) |
| `└ est_yoy` | string | No | Estimated year-over-year change. |
| `└ cmp` | string | No | Comparison value. |
| `└ cmp_desc` | string | No | Beat/miss description (may be empty) |
| `fr_debt_assets_ratio` | string | No | Debt-to-assets ratio as percentage |
| `fr_revenue` | object | No | Reported revenue |
| `└ value` | string | No | Actual value |
| `└ yoy` | string | No | Year-over-year growth as percentage, e.g. `16.6` |
| `└ est_value` | string | No | Consensus estimate (may be empty) |
| `└ est_yoy` | string | No | Estimated year-over-year change. |
| `└ cmp` | string | No | Comparison value. |
| `└ cmp_desc` | string | No | Beat/miss description (may be empty) |
| `fr_profit` | object | No | Reported net profit |
| `└ value` | string | No | Actual value |
| `└ yoy` | string | No | Year-over-year growth as percentage, e.g. `16.6` |
| `└ est_value` | string | No | Consensus estimate (may be empty) |
| `└ est_yoy` | string | No | Estimated year-over-year change. |
| `└ cmp` | string | No | Comparison value. |
| `└ cmp_desc` | string | No | Beat/miss description (may be empty) |
| `fr_profit_margin` | string | No | Net profit margin as percentage |
| `fr_operate_cash` | object | No | Operating cash flow |
| `└ value` | string | No | Actual value |
| `└ yoy` | string | No | Year-over-year growth as percentage, e.g. `16.6` |
| `└ est_value` | string | No | Consensus estimate (may be empty) |
| `└ est_yoy` | string | No | Estimated year-over-year change. |
| `└ cmp` | string | No | Comparison value. |
| `└ cmp_desc` | string | No | Beat/miss description (may be empty) |
| `fr_finance_cash` | object | No | Financing cash flow |
| `└ value` | string | No | Actual value |
| `└ yoy` | string | No | Year-over-year growth as percentage, e.g. `16.6` |
| `└ est_value` | string | No | Consensus estimate (may be empty) |
| `└ est_yoy` | string | No | Estimated year-over-year change. |
| `└ cmp` | string | No | Comparison value. |
| `└ cmp_desc` | string | No | Beat/miss description (may be empty) |
| `fr_invest_cash` | object | No | Investing cash flow |
| `└ value` | string | No | Actual value |
| `└ yoy` | string | No | Year-over-year growth as percentage, e.g. `16.6` |
| `└ est_value` | string | No | Consensus estimate (may be empty) |
| `└ est_yoy` | string | No | Estimated year-over-year change. |
| `└ cmp` | string | No | Comparison value. |
| `└ cmp_desc` | string | No | Beat/miss description (may be empty) |
| `market` | string | No | Market: `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"
  }
}
```
