Fundamental
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-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.
longbridge financial-report snapshot AAPL.US
longbridge financial-report snapshot AAPL.US --report qf --year 2024 --period 4
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `AAPL.US` |
report | string | Optional | Report type: `qf` (quarterly) / `saf` (semi-annual) / `af` (annual) |
fiscal_year | integer | Optional | Fiscal year, e.g. `2024` |
fiscal_period | string | Optional | Fiscal period, e.g. `1` / `2` / `3` / `4` |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Optional | Security name. |
ticker | string | Optional | Ticker symbol without market suffix, e.g. `AAPL` |
currency | string | Optional | Currency code |
report | string | Optional | Report period code (e.g. `af` = annual) |
fiscal_year | integer | Optional | Fiscal year |
fiscal_period | string | Optional | Fiscal period number within the fiscal year |
opt_reports | array | Optional | Optional available report periods |
fp_start | string | Optional | Fiscal period start date in `YYYY.MM.DD` format |
fp_end | string | Optional | Fiscal period end date in `YYYY.MM.DD` format |
report_desc | string | Optional | AI-generated earnings summary |
fo_revenue | object | Optional | Revenue forecast vs actual |
└ value | string | Optional | Actual value |
└ yoy | string | Optional | Year-over-year growth as percentage, e.g. `16.6` |
└ est_value | string | Optional | Consensus estimate (may be empty) |
└ est_yoy | string | Optional | Estimated year-over-year change. |
└ cmp | string | Optional | Comparison value. |
└ cmp_desc | string | Optional | Beat/miss description (may be empty) |
fo_ebit | object | Optional | EBIT forecast vs actual |
└ value | string | Optional | Actual value |
└ yoy | string | Optional | Year-over-year growth as percentage, e.g. `16.6` |
└ est_value | string | Optional | Consensus estimate (may be empty) |
└ est_yoy | string | Optional | Estimated year-over-year change. |
└ cmp | string | Optional | Comparison value. |
└ cmp_desc | string | Optional | Beat/miss description (may be empty) |
fo_eps | object | Optional | EPS forecast vs actual |
└ value | string | Optional | Actual value |
└ yoy | string | Optional | Year-over-year growth as percentage, e.g. `16.6` |
└ est_value | string | Optional | Consensus estimate (may be empty) |
└ est_yoy | string | Optional | Estimated year-over-year change. |
└ cmp | string | Optional | Comparison value. |
└ cmp_desc | string | Optional | Beat/miss description (may be empty) |
fr_roe_ttm | string | Optional | ROE TTM as percentage, e.g. `141.47` |
fr_asset_turn_ttm | string | Optional | Asset turnover TTM as percentage |
fr_profit_margin_ttm | string | Optional | Net profit margin TTM as percentage |
fr_leverage_ttm | string | Optional | Leverage TTM as percentage |
fr_total_assets | object | Optional | Total assets |
└ value | string | Optional | Actual value |
└ yoy | string | Optional | Year-over-year growth as percentage, e.g. `16.6` |
└ est_value | string | Optional | Consensus estimate (may be empty) |
└ est_yoy | string | Optional | Estimated year-over-year change. |
└ cmp | string | Optional | Comparison value. |
└ cmp_desc | string | Optional | Beat/miss description (may be empty) |
fr_total_liability | object | Optional | Total liabilities |
└ value | string | Optional | Actual value |
└ yoy | string | Optional | Year-over-year growth as percentage, e.g. `16.6` |
└ est_value | string | Optional | Consensus estimate (may be empty) |
└ est_yoy | string | Optional | Estimated year-over-year change. |
└ cmp | string | Optional | Comparison value. |
└ cmp_desc | string | Optional | Beat/miss description (may be empty) |
fr_debt_assets_ratio | string | Optional | Debt-to-assets ratio as percentage |
fr_revenue | object | Optional | Reported revenue |
└ value | string | Optional | Actual value |
└ yoy | string | Optional | Year-over-year growth as percentage, e.g. `16.6` |
└ est_value | string | Optional | Consensus estimate (may be empty) |
└ est_yoy | string | Optional | Estimated year-over-year change. |
└ cmp | string | Optional | Comparison value. |
└ cmp_desc | string | Optional | Beat/miss description (may be empty) |
fr_profit | object | Optional | Reported net profit |
└ value | string | Optional | Actual value |
└ yoy | string | Optional | Year-over-year growth as percentage, e.g. `16.6` |
└ est_value | string | Optional | Consensus estimate (may be empty) |
└ est_yoy | string | Optional | Estimated year-over-year change. |
└ cmp | string | Optional | Comparison value. |
└ cmp_desc | string | Optional | Beat/miss description (may be empty) |
fr_profit_margin | string | Optional | Net profit margin as percentage |
fr_operate_cash | object | Optional | Operating cash flow |
└ value | string | Optional | Actual value |
└ yoy | string | Optional | Year-over-year growth as percentage, e.g. `16.6` |
└ est_value | string | Optional | Consensus estimate (may be empty) |
└ est_yoy | string | Optional | Estimated year-over-year change. |
└ cmp | string | Optional | Comparison value. |
└ cmp_desc | string | Optional | Beat/miss description (may be empty) |
fr_finance_cash | object | Optional | Financing cash flow |
└ value | string | Optional | Actual value |
└ yoy | string | Optional | Year-over-year growth as percentage, e.g. `16.6` |
└ est_value | string | Optional | Consensus estimate (may be empty) |
└ est_yoy | string | Optional | Estimated year-over-year change. |
└ cmp | string | Optional | Comparison value. |
└ cmp_desc | string | Optional | Beat/miss description (may be empty) |
fr_invest_cash | object | Optional | Investing cash flow |
└ value | string | Optional | Actual value |
└ yoy | string | Optional | Year-over-year growth as percentage, e.g. `16.6` |
└ est_value | string | Optional | Consensus estimate (may be empty) |
└ est_yoy | string | Optional | Estimated year-over-year change. |
└ cmp | string | Optional | Comparison value. |
└ cmp_desc | string | Optional | Beat/miss description (may be empty) |
market | string | Optional | Market: `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.