Financial Statements
GET/api/v1.0/quote/{symbol}/financials/statementsGet 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
| Name | Type | In | Required | Description |
|---|---|---|---|---|
symbol | string | path | yes | Stock symbol (path param), e.g. HK.00700 Max length 32; Pattern ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$ |
statement_type | int | query | no | Statement type, default 1. 1=Income statement / 2=Balance sheet / 3=Cash flow statement / 4=Key indicators Default 1; Values 1, 2, 3, 4 |
financial_type | int | query | no | Financial period type. Default 10. See Naming Dictionary. Default 10; Values 1, 2, 3, 4, 5, 6, 7, 9, 10, 11 |
currency_code | string | query | no | Currency code (if omitted, server returns the statement's native currency), e.g. CNY / USD / HKD Max length 10; Pattern ^$|^[A-Z]*$ |
next_key | string | query | no | Pagination 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 "" |
limit | int | query | no | Page 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" | jqResponse Fields
Returns data.report_list[], each element is one financial report; pagination cursor at top-level pagination (has_more / next_key).
report fields:
| Name | Type | Description |
|---|---|---|
data | object | |
data.report_list | object[] | |
data.report_list[].date_time | int | Reporting period of the statement, millisecond timestamp, e.g. 1774886400000 (corresponds to 2026-03-30) |
data.report_list[].fiscal_year | string | Fiscal year, e.g. 2026 |
data.report_list[].financial_type | string | Concrete 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[].structure | int | Financial 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_name | string | Financial structure name (readable mapping of structure), e.g. 'NORMAL_HK' / 'NORMAL_MSTAR'; empty string when unknown |
data.report_list[].period_text | string | Fiscal period text (fiscal year + period type suffix), e.g. 2026/Q1 |
data.report_list[].currency_code | string | Currency code, e.g. CNY |
data.report_list[].accounting_standards | string | Accounting 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_report | string | Auditor'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_list | object[] | |
data.report_list[].item_list[].field_id | int | Field ID, e.g. 1 / 17 |
data.report_list[].item_list[].display_name | string | Field 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_type | string | Value 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[].data | string | Field 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[].yoy | string | Year-over-year (YoY) growth rate (%), e.g. 9.129995222806102 |
data.report_list[].item_list[].qoq | string | Quarter-over-quarter (QoQ) growth rate (%), e.g. 1.0737198450386116 |
pagination | object | |
pagination.has_more | bool | |
pagination.next_key | string |
item_list element fields:
| Field | Type | Description |
|---|---|---|
field_id | int | Field ID. |
display_name | string | Field English name, e.g. Total Revenue. |
value_type | string | Value type: amount=monetary amount / percent=percentage. |
data | number | Field value. |
yoy | number | Year-over-year growth rate (%). |
qoq | number | Quarter-over-quarter growth rate (%). |
Enum financial_structure (report structure)
| Value | structure_name | Meaning (Market x Industry) |
|---|---|---|
| 1 | NORMAL_KCB | STAR Market - General |
| 2 | BANK_KCB | STAR Market - Financial |
| 3 | NORMAL_A | A-shares - General |
| 4 | BANK_A | A-shares - Financial |
| 5 | NORMAL_HK | Hong Kong - General |
| 6 | BANK_HK | Hong Kong - Banking |
| 7 | INSURANCE_HK | Hong Kong - Insurance |
| 8 | NORMAL_MSTAR | US / SG / CA / AU - General |
| 9 | BANK_MSTAR | US / SG / CA / AU - Banking |
| 10 | INSURANCE_MSTAR | US / SG / CA / AU - Insurance |
| 11 | NONNORMAL_MSTAR | US / SG / CA / AU - General (Non-standard) |
| 12 | NONBANK_MSTAR | US / SG / CA / AU - Banking (Non-standard) |
| 13 | NONINSURANCE_MSTAR | US / SG / CA / AU - Insurance (Non-standard) |
| 14 | NORMAL_MAIN_INDEX_US | US Key Indicators - General |
| 15 | BANK_MAIN_INDEX_US | US Key Indicators - Banking |
| 16 | INSURANCE_MAIN_INDEX_US | US Key Indicators - Insurance |
| 17 | NORMAL_MAIN_INDEX_MSTAR | SG / CA / AU Key Indicators - General |
| 18 | BANK_MAIN_INDEX_MSTAR | SG / CA / AU Key Indicators - Banking |
| 19 | INSURANCE_MAIN_INDEX_MSTAR | SG / 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_code | error.code | Trigger Condition | Suggested Action |
|---|---|---|---|
| -3 | invalid_parameter | Missing symbol / statement_type not in [1,2,3,4] / financial_type not in allowed range / num > 50 | Correct request and retry |
| -7 | invalid_symbol | Symbol cannot resolve to a security | Verify code validity via search API |
| -10 | no_data | Valid symbol but no data for this report/period | Normal empty result, no need to retry |
| -4 / -6 | internal_error | Service error | Retry; 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"
}
}