財務報告

獲取任意上市公司的利潤表、資產負債表和現金流量表。

SDK Links

Python	longport.openapi.FundamentalContext.financial_report
Rust	longport::fundamental::FundamentalContext#financial_report
Go	FundamentalContext.FinancialReport
Node.js	FundamentalContext#financialReport

Parameters

SDK 方法參數。

Name	Type	Required	Description
symbol	string	是	證券代碼，例如 AAPL.US
kind	string	是	報表類型：IncomeStatement（利潤表）、BalanceSheet（資產負債表）、CashFlow（現金流量表）、All（全部）
period	string	是	報告期：Annual（年報）、SemiAnnual（中報）、Q1/Q2/Q3/ThreeQ（季報）、QuarterlyFull（累計季報）

Request Example

from longport.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("AAPL.US")
print(resp)

import asyncio
from longport.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("AAPL.US")
    print(resp)

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

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

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.financial_report('AAPL.US')
  console.log(resp)
}
main().catch(console.error)

import com.longport.*;
import com.longport.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.getFinancialReport("AAPL.US").get();
            System.out.println(resp);
        }
    }
}

use std::sync::Arc;
use longport::{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("AAPL.US").await?;
    println!("{:?}", resp);
    Ok(())
}

#include <iostream>
#include <longport.hpp>

using namespace longport;
using namespace longport::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("AAPL.US", [](auto resp) {
                if (resp) std::cout << "OK" << std::endl;
            });
        });
    std::cin.get();
}

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/longportapp/openapi-go/config"
	"github.com/longportapp/openapi-go/oauth"
	"github.com/longportapp/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.FinancialReport(context.Background(), "AAPL.US")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", resp)
}

Response

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "list": {
      "IS": {
        "indicators": [
          {
            "title": "Income Statement",
            "short_title": "IS",
            "currency": "USD",
            "has_yoy": true,
            "entry": "IS",
            "periods": [
              "FY2025",
              "FY2024"
            ],
            "accounts": [
              {
                "field": "EPS",
                "name": "Earnings Per Share(USD)",
                "percent": false,
                "tip": "",
                "values": [
                  {
                    "period": "FY 2025",
                    "year": 2025,
                    "fp_end": "1758945600",
                    "value": "7.46",
                    "ratio": "",
                    "yoy": "0.227"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  }
}

Response Status

Status	Description	Schema
200	成功	FinancialReportsResponse
400	請求錯誤	None

Schemas

FinancialReportsResponse

Name	Type	Required	Description
list	object	true	按報表類型分組的數據（key 為報表類型代碼，如 IS、BS、CF）

FinancialReportIndicator

Name	Type	Required	Description
title	string	false	指標標題
short_title	string	false	短標題
currency	string	false	貨幣
has_yoy	boolean	false	是否有同比數據
entry	string	false	條目標識符
periods	string[]	false	可用報告期列表
accounts	object[]	false	財務科目列表，見 FinancialAccount

FinancialAccount

Name	Type	Required	Description
field	string	true	字段標識符
name	string	false	字段顯示名稱
percent	boolean	false	是否為百分比值
tip	string	false	提示說明
values	object[]	false	按報告期的歷史數值，見 FinancialValue

FinancialValue

Name	Type	Required	Description
period	string	true	報告期標簽（如 FY 2024）
year	integer	false	財政年度
fp_end	string	false	報告期結束時間戳
value	string	false	報告值
ratio	string	false	比率值
yoy	string	false	同比增長率