Fundamental

Financial Report Snapshot

GEThttps://openapi.longbridge.com/v1/quote/financials/earnings-snapshot

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=.

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

>_ CLI
longbridge financial-report snapshot AAPL.US
longbridge financial-report snapshot AAPL.US --report qf --year 2024 --period 4

Request

Query parameters

NameTypeRequiredDescription
symbolstringRequiredSecurity symbol, e.g. `AAPL.US`
reportstringOptionalReport type: `qf` (quarterly) / `saf` (semi-annual) / `af` (annual)
fiscal_yearintegerOptionalFiscal year, e.g. `2024`
fiscal_periodstringOptionalFiscal period, e.g. `1` / `2` / `3` / `4`

Response

Response properties

NameTypeRequiredDescription
namestringOptionalSecurity name.
tickerstringOptionalTicker symbol without market suffix, e.g. `AAPL`
currencystringOptionalCurrency code
reportstringOptionalReport period code (e.g. `af` = annual)
fiscal_yearintegerOptionalFiscal year
fiscal_periodstringOptionalFiscal period number within the fiscal year
opt_reportsarrayOptionalOptional available report periods
fp_startstringOptionalFiscal period start date in `YYYY.MM.DD` format
fp_endstringOptionalFiscal period end date in `YYYY.MM.DD` format
report_descstringOptionalAI-generated earnings summary
fo_revenueobjectOptionalRevenue forecast vs actual
└ valuestringOptionalActual value
└ yoystringOptionalYear-over-year growth as percentage, e.g. `16.6`
└ est_valuestringOptionalConsensus estimate (may be empty)
└ est_yoystringOptionalEstimated year-over-year change.
└ cmpstringOptionalComparison value.
└ cmp_descstringOptionalBeat/miss description (may be empty)
fo_ebitobjectOptionalEBIT forecast vs actual
└ valuestringOptionalActual value
└ yoystringOptionalYear-over-year growth as percentage, e.g. `16.6`
└ est_valuestringOptionalConsensus estimate (may be empty)
└ est_yoystringOptionalEstimated year-over-year change.
└ cmpstringOptionalComparison value.
└ cmp_descstringOptionalBeat/miss description (may be empty)
fo_epsobjectOptionalEPS forecast vs actual
└ valuestringOptionalActual value
└ yoystringOptionalYear-over-year growth as percentage, e.g. `16.6`
└ est_valuestringOptionalConsensus estimate (may be empty)
└ est_yoystringOptionalEstimated year-over-year change.
└ cmpstringOptionalComparison value.
└ cmp_descstringOptionalBeat/miss description (may be empty)
fr_roe_ttmstringOptionalROE TTM as percentage, e.g. `141.47`
fr_asset_turn_ttmstringOptionalAsset turnover TTM as percentage
fr_profit_margin_ttmstringOptionalNet profit margin TTM as percentage
fr_leverage_ttmstringOptionalLeverage TTM as percentage
fr_total_assetsobjectOptionalTotal assets
└ valuestringOptionalActual value
└ yoystringOptionalYear-over-year growth as percentage, e.g. `16.6`
└ est_valuestringOptionalConsensus estimate (may be empty)
└ est_yoystringOptionalEstimated year-over-year change.
└ cmpstringOptionalComparison value.
└ cmp_descstringOptionalBeat/miss description (may be empty)
fr_total_liabilityobjectOptionalTotal liabilities
└ valuestringOptionalActual value
└ yoystringOptionalYear-over-year growth as percentage, e.g. `16.6`
└ est_valuestringOptionalConsensus estimate (may be empty)
└ est_yoystringOptionalEstimated year-over-year change.
└ cmpstringOptionalComparison value.
└ cmp_descstringOptionalBeat/miss description (may be empty)
fr_debt_assets_ratiostringOptionalDebt-to-assets ratio as percentage
fr_revenueobjectOptionalReported revenue
└ valuestringOptionalActual value
└ yoystringOptionalYear-over-year growth as percentage, e.g. `16.6`
└ est_valuestringOptionalConsensus estimate (may be empty)
└ est_yoystringOptionalEstimated year-over-year change.
└ cmpstringOptionalComparison value.
└ cmp_descstringOptionalBeat/miss description (may be empty)
fr_profitobjectOptionalReported net profit
└ valuestringOptionalActual value
└ yoystringOptionalYear-over-year growth as percentage, e.g. `16.6`
└ est_valuestringOptionalConsensus estimate (may be empty)
└ est_yoystringOptionalEstimated year-over-year change.
└ cmpstringOptionalComparison value.
└ cmp_descstringOptionalBeat/miss description (may be empty)
fr_profit_marginstringOptionalNet profit margin as percentage
fr_operate_cashobjectOptionalOperating cash flow
└ valuestringOptionalActual value
└ yoystringOptionalYear-over-year growth as percentage, e.g. `16.6`
└ est_valuestringOptionalConsensus estimate (may be empty)
└ est_yoystringOptionalEstimated year-over-year change.
└ cmpstringOptionalComparison value.
└ cmp_descstringOptionalBeat/miss description (may be empty)
fr_finance_cashobjectOptionalFinancing cash flow
└ valuestringOptionalActual value
└ yoystringOptionalYear-over-year growth as percentage, e.g. `16.6`
└ est_valuestringOptionalConsensus estimate (may be empty)
└ est_yoystringOptionalEstimated year-over-year change.
└ cmpstringOptionalComparison value.
└ cmp_descstringOptionalBeat/miss description (may be empty)
fr_invest_cashobjectOptionalInvesting cash flow
└ valuestringOptionalActual value
└ yoystringOptionalYear-over-year growth as percentage, e.g. `16.6`
└ est_valuestringOptionalConsensus estimate (may be empty)
└ est_yoystringOptionalEstimated year-over-year change.
└ cmpstringOptionalComparison value.
└ cmp_descstringOptionalBeat/miss description (may be empty)
marketstringOptionalMarket: `US`, `HK`, `CN`, `SG`

Response JSON example

{
  "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"
  }
}

Error code

See the Error Codes page for the full list of error codes.