Skip to content

Financial Statements ​

GET /api/v1.0/quote/{symbol}/financials/statements

Get the income statement / balance sheet / cash flow statement / key metrics data for a company, returned by reporting period. Each record includes report period, fiscal year, financial period type, currency and accounting standards, as well as item_list (each field contains field_id, English field name display_name, value, YoY, QoQ).

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesStock symbol (path param), e.g. HK.00700 Max length 32; Pattern ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$
statement_typeintquerynoStatement type, default 1. 1=Income statement / 2=Balance sheet / 3=Cash flow statement / 4=Key indicators Default 1; Values 1, 2, 3, 4
financial_typeintquerynoFinancial period type. Default 10. See Naming Dictionary. Default 10; Values 1, 2, 3, 4, 5, 6, 7, 9, 10, 11
currency_codestringquerynoCurrency code (if omitted, server returns the statement's native currency), e.g. CNY / USD / HKD Max length 10; Pattern ^$|^[A-Z]*$
next_keystringquerynoPagination cursor (empty for first page). For the next page, pass back pagination.next_key from the previous response verbatim; stop when pagination.has_more=false Max length 1000; Default ""
limitintquerynoPage size, default 10, min 1, max 50 ≥ 1; ≤ 50; Default 10

Request Example ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/financials/statements?statement_type=1&financial_type=10&limit=1" | jq

Response Fields ​

Returns data.report_list[], each element is one financial report; pagination cursor at top-level pagination (has_more / next_key).

report fields:

NameTypeDescription
dataobject
data.report_listobject[]
data.report_list[].date_timeintReporting period of the statement, millisecond timestamp, e.g. 1774886400000 (corresponds to 2026-03-30)
data.report_list[].fiscal_yearstringFiscal year, e.g. 2026
data.report_list[].financial_typestringConcrete fiscal period type code of this period (output is always a concrete period 1-7): 1=Q1 / 2=Q2 / 3=Q3 / 4=Q4 / 5=Q6 (cumulative) / 6=Q9 (cumulative) / 7=Annual
data.report_list[].structureintFinancial structure number this period uses (determines the field set of item_list; varies by market/industry), see enum definition, e.g. 5 / 8
data.report_list[].structure_namestringFinancial structure name (readable mapping of structure), e.g. 'NORMAL_HK' / 'NORMAL_MSTAR'; empty string when unknown
data.report_list[].period_textstringFiscal period text (fiscal year + period type suffix), e.g. 2026/Q1
data.report_list[].currency_codestringCurrency code, e.g. CNY
data.report_list[].accounting_standardsstringAccounting standards, e.g. IAS / HKAS / US_GAAP / CAS (2007); empty string for key indicators (statement_type=4) which have no accounting standard
data.report_list[].auditor_reportstringAuditor's opinion (usually present on annual reports, often empty for quarters; localized by request language), e.g. 'Unqualified opinion' / 'Unaudited opinion'; empty when unavailable
data.report_list[].item_listobject[]
data.report_list[].item_list[].field_idintField ID, e.g. 1 / 17
data.report_list[].item_list[].display_namestringField English name (resolved to English), e.g. 'Total Revenue' / 'Cost of Revenue'. Empty string when no name is available
data.report_list[].item_list[].value_typestringValue type (resolved to English), 'amount' = monetary (base currency unit) / 'percent' = percentage (already x100). Use it to interpret data; empty string when unknown
data.report_list[].item_list[].datastringField value. When value_type='amount' it is a monetary amount (base currency unit); when value_type='percent' it is a percentage (e.g. 47.86 = 47.86%), e.g. 196458000000 / 47.8624
data.report_list[].item_list[].yoystringYear-over-year (YoY) growth rate (%), e.g. 9.129995222806102
data.report_list[].item_list[].qoqstringQuarter-over-quarter (QoQ) growth rate (%), e.g. 1.0737198450386116
paginationobject
pagination.has_morebool
pagination.next_keystring

item_list element fields:

FieldTypeDescription
field_idintField ID.
display_namestringField English name, e.g. Total Revenue.
value_typestringValue type: amount=monetary amount / percent=percentage.
datanumberField value.
yoynumberYear-over-year growth rate (%).
qoqnumberQuarter-over-quarter growth rate (%).

Enum financial_structure (report structure)

Valuestructure_nameMeaning (Market x Industry)
1NORMAL_KCBSTAR Market - General
2BANK_KCBSTAR Market - Financial
3NORMAL_AA-shares - General
4BANK_AA-shares - Financial
5NORMAL_HKHong Kong - General
6BANK_HKHong Kong - Banking
7INSURANCE_HKHong Kong - Insurance
8NORMAL_MSTARUS / SG / CA / AU - General
9BANK_MSTARUS / SG / CA / AU - Banking
10INSURANCE_MSTARUS / SG / CA / AU - Insurance
11NONNORMAL_MSTARUS / SG / CA / AU - General (Non-standard)
12NONBANK_MSTARUS / SG / CA / AU - Banking (Non-standard)
13NONINSURANCE_MSTARUS / SG / CA / AU - Insurance (Non-standard)
14NORMAL_MAIN_INDEX_USUS Key Indicators - General
15BANK_MAIN_INDEX_USUS Key Indicators - Banking
16INSURANCE_MAIN_INDEX_USUS Key Indicators - Insurance
17NORMAL_MAIN_INDEX_MSTARSG / CA / AU Key Indicators - General
18BANK_MAIN_INDEX_MSTARSG / CA / AU Key Indicators - Banking
19INSURANCE_MAIN_INDEX_MSTARSG / CA / AU Key Indicators - Insurance

Supported Markets ​

  • Supported markets: HK / US / SH / SZ / BJ / SG / JP / AU / CA.
  • Supported categories: Company-type securities with public financial reports (common stocks and equivalent categories).
  • Non-company categories (indices / plates / ETFs / funds / warrants / options / futures / forex / crypto) or companies without the report return no_data.

Error Codes ​

ret_codeerror.codeTrigger ConditionSuggested Action
-3invalid_parameterMissing symbol / statement_type not in [1,2,3,4] / financial_type not in allowed range / num > 50Correct request and retry
-7invalid_symbolSymbol cannot resolve to a securityVerify code validity via search API
-10no_dataValid symbol but no data for this report/periodNormal empty result, no need to retry
-4 / -6internal_errorService errorRetry; contact support if persistent

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "report_list": [
      {
        "date_time": 1774886400000,
        "fiscal_year": "2026",
        "financial_type": "1",
        "structure": 5,
        "structure_name": "NORMAL_HK",
        "period_text": "2026/Q1",
        "currency_code": "CNY",
        "accounting_standards": "IAS",
        "auditor_report": "None",
        "item_list": [
          {
            "field_id": 1,
            "display_name": "Total Revenue",
            "value_type": "amount",
            "data": "196458000000",
            "yoy": "9.13",
            "qoq": "1.07"
          },
          {
            "field_id": 2,
            "display_name": "Operating Revenue",
            "value_type": "amount",
            "data": "196458000000",
            "yoy": "9.13",
            "qoq": "1.07"
          },
          {
            "field_id": 5,
            "display_name": "Cost of Revenue",
            "value_type": "amount",
            "data": "-85193000000",
            "yoy": "-7.12",
            "qoq": "1.03"
          }
        ]
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "2026_1"
  }
}