Financial Report Snapshot

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

SDK Links

Python	longbridge.openapi.FundamentalContext.financial_report_snapshot
Rust	longbridge::fundamental::FundamentalContext#financial_report_snapshot
Go	FundamentalContext.FinancialReportSnapshot
Node.js	FundamentalContext#financialReportSnapshot
Java	FundamentalContext.getFinancialReportSnapshot
C++	longbridge::fundamental::FundamentalContext::financial_report_snapshot

Parameters

SDK method 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	uint32	NO	Fiscal year, e.g. 2024
fiscal_period	string	NO	Fiscal period, e.g. 1 / 2 / 3 / 4

Request Example

from longbridge.openapi import FundamentalContext, Config, OAuthBuilder

oauth = OAuthBuilder("your-client-id").build(lambda url: print("Visit:", url))
config = Config.from_oauth(oauth)
ctx = FundamentalContext(config)

resp = ctx.financial_report_snapshot("AAPL.US", report="qf", fiscal_year=2024, fiscal_period="4")
print(resp)

import asyncio
from longbridge.openapi import AsyncFundamentalContext, Config, OAuthBuilder

async def main() -> None:
    oauth = await OAuthBuilder("your-client-id").build_async(lambda url: print("Visit:", url))
    config = Config.from_oauth(oauth)
    ctx = AsyncFundamentalContext.create(config)

    resp = await ctx.financial_report_snapshot("AAPL.US", report="qf", fiscal_year=2024, fiscal_period="4")
    print(resp)

if __name__ == "__main__":
    asyncio.run(main())

const { Config, FundamentalContext, OAuth } = require('longbridge')

async function main() {
  const oauth = await OAuth.build('your-client-id', (_, url) => {
    console.log('Open this URL to authorize: ' + url)
  })
  const config = Config.fromOAuth(oauth)
  const ctx = FundamentalContext.new(config)
  const resp = await ctx.financialReportSnapshot('AAPL.US', { report: 'qf', fiscalYear: 2024, fiscalPeriod: '4' })
  console.log(resp)
}
main().catch(console.error)

import com.longbridge.*;
import com.longbridge.fundamental.*;

class Main {
    public static void main(String[] args) throws Exception {
        try (OAuth oauth = new OAuthBuilder("your-client-id").build(url -> System.out.println("Open to authorize: " + url)).get();
             Config config = Config.fromOAuth(oauth);
             FundamentalContext ctx = FundamentalContext.create(config)) {
            var resp = ctx.getFinancialReportSnapshot("AAPL.US", "qf", 2024, "4").get();
            System.out.println(resp);
        }
    }
}

use std::sync::Arc;
use longbridge::{oauth::OAuthBuilder, fundamental::FundamentalContext, Config};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let oauth = OAuthBuilder::new("your-client-id").build(|url| println!("Open: {url}")).await?;
    let config = Arc::new(Config::from_oauth(oauth));
    let ctx = FundamentalContext::new(config);
    let resp = ctx.financial_report_snapshot("AAPL.US", Some("qf"), Some(2024), Some("4")).await?;
    println!("{:?}", resp);
    Ok(())
}

#include <iostream>
#include <longbridge.hpp>

using namespace longbridge;
using namespace longbridge::fundamental;

int main() {
    OAuthBuilder("your-client-id").build(
        [](const std::string& url) { std::cout << "Open: " << url << std::endl; },
        [](auto res) {
            if (!res) return;
            Config config = Config::from_oauth(*res);
            FundamentalContext ctx = FundamentalContext::create(config);
            ctx.financial_report_snapshot("AAPL.US", "qf", 2024, "4", [](auto resp) {
                if (resp) std::cout << "OK" << std::endl;
            });
        });
    std::cin.get();
}

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/longbridge/openapi-go/config"
	"github.com/longbridge/openapi-go/oauth"
	"github.com/longbridge/openapi-go/fundamental"
)

func main() {
	o := oauth.New("your-client-id").
		OnOpenURL(func(url string) { fmt.Println("Open this URL to authorize:", url) })
	if err := o.Build(context.Background()); err != nil {
		log.Fatal(err)
	}
	conf, err := config.New(config.WithOAuthClient(o))
	if err != nil {
		log.Fatal(err)
	}
	c, err := fundamental.NewFromCfg(conf)
	if err != nil {
		log.Fatal(err)
	}
	defer c.Close()
	resp, err := c.FinancialReportSnapshot(context.Background(), "AAPL.US", "qf", 2024, "4")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", resp)
}

Response

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "name": "苹果",
    "ticker": "AAPL",
    "fp_start": "2025.12.28",
    "fp_end": "2026.03.28",
    "currency": "USD",
    "report_desc": "概要：苹果（AAPL）的营业收入是 1112 亿（+16.6%）；每股收益是 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"
  }
}

Response Status

Status	Description	Schema
200	Success	FinancialReportSnapshotResponse
400	Bad request	None

Schemas

FinancialReportSnapshotResponse

Name	Type	Required	Description
name	string	false	Company name
ticker	string	false	Ticker symbol without market suffix, e.g. AAPL
fp_start	string	false	Fiscal period start date in YYYY.MM.DD format
fp_end	string	false	Fiscal period end date in YYYY.MM.DD format
currency	string	false	Currency code
report_desc	string	false	AI-generated earnings summary
fo_revenue	object	false	Revenue forecast vs actual, see ForecastMetric
fo_ebit	object	false	EBIT forecast vs actual, see ForecastMetric
fo_eps	object	false	EPS forecast vs actual, see ForecastMetric
fr_revenue	object	false	Reported revenue, see ReportedMetric
fr_profit	object	false	Reported net profit, see ReportedMetric
fr_operate_cash	object	false	Operating cash flow, see ReportedMetric
fr_invest_cash	object	false	Investing cash flow, see ReportedMetric
fr_finance_cash	object	false	Financing cash flow, see ReportedMetric
fr_total_assets	object	false	Total assets, see ReportedMetric
fr_total_liability	object	false	Total liabilities, see ReportedMetric
fr_roe_ttm	string	false	ROE TTM as percentage, e.g. 141.47
fr_profit_margin	string	false	Net profit margin as percentage
fr_profit_margin_ttm	string	false	Net profit margin TTM as percentage
fr_asset_turn_ttm	string	false	Asset turnover TTM as percentage
fr_leverage_ttm	string	false	Leverage TTM as percentage
fr_debt_assets_ratio	string	false	Debt-to-assets ratio as percentage

ForecastMetric

Name	Type	Required	Description
value	string	false	Actual value
yoy	string	false	Year-over-year growth as percentage, e.g. 16.6
cmp_desc	string	false	Beat/miss description (may be empty)
est_value	string	false	Consensus estimate (may be empty)

ReportedMetric

Name	Type	Required	Description
value	string	false	Value
yoy	string	false	Year-over-year growth as percentage