财务报表
GET/api/v1.0/quote/{symbol}/financials/statements获取公司的利润表 / 资产负债表 / 现金流量表 / 主要指标数据,按财报期返回。每条记录包含报告期、财年、财报期类型、币种与会计准则,以及 item_list(每个字段含 field_id、英文字段名 display_name、数值、同比 yoy、环比 qoq)。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 股票代码(路径参数),例: HK.00700 最长长度 32; 格式 ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$ |
statement_type | int | 查询 | 否 | 报表类型,默认 1。1=利润表 / 2=资产负债表 / 3=现金流量表 / 4=主要指标 默认 1; 取值 1, 2, 3, 4 |
financial_type | int | 查询 | 否 | 财报期类型。默认 10。详见命名词典。 默认 10; 取值 1, 2, 3, 4, 5, 6, 7, 9, 10, 11 |
currency_code | string | 查询 | 否 | 币种代码(不传由服务端按报表自带币种返回),例: CNY / USD / HKD 最长长度 10; 格式 ^$|^[A-Z]*$ |
next_key | string | 查询 | 否 | 翻页游标(首页留空)。下一页:把上一次响应的 pagination.next_key 原样回传;当 pagination.has_more=false 时即无更多页,停止翻页 最长长度 1000; 默认 "" |
limit | int | 查询 | 否 | 每页条数,默认 10,最小 1,最大 50 ≥ 1; ≤ 50; 默认 10 |
请求示例
bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/financials/statements?statement_type=1&financial_type=10&limit=1" | jq响应字段
返回 data.report_list[],每元素一份财报;翻页游标见顶层 pagination(has_more / next_key)。
report 字段:
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.report_list | object[] | |
data.report_list[].date_time | int | 财报报告期,毫秒时间戳,例: 1774886400000(对应 2026-03-30) |
data.report_list[].fiscal_year | string | 财年,例: 2026 |
data.report_list[].financial_type | string | 本期的具体财报期类型代码(出参恒为具体期 1~7): 1=Q1 / 2=Q2 / 3=Q3 / 4=Q4 / 5=Q6累计 / 6=Q9累计 / 7=年报 |
data.report_list[].structure | int | 本期所属财报结构编号(决定本期 item_list 的字段集,不同市场/行业结构不同),取值见枚举定义,例: 5 / 8 |
data.report_list[].structure_name | string | 财报结构名称(structure 的可读映射),例: 'NORMAL_HK' / 'NORMAL_MSTAR';未知结构为空串 |
data.report_list[].period_text | string | 财报期文本(财年 + 期类型后缀),例: 2026/Q1 |
data.report_list[].currency_code | string | 币种代码,例: CNY |
data.report_list[].accounting_standards | string | 会计准则,例: IAS / HKAS / US_GAAP / CAS (2007);主要指标(statement_type=4)无会计准则时为空串 |
data.report_list[].auditor_report | string | 审计意见(多按年报下发,季报常为空;按请求语言本地化),例: 'Unqualified opinion' / 'Unaudited opinion';无则为空 |
data.report_list[].item_list | object[] | |
data.report_list[].item_list[].field_id | int | 字段 ID,例: 1 / 17 |
data.report_list[].item_list[].display_name | string | 字段英文名(已解析为英文名),例: 'Total Revenue' / 'Cost of Revenue'。无对应名称时为空串 |
data.report_list[].item_list[].value_type | string | 数值类型(已解析),'amount'=金额(本位币单位) / 'percent'=百分数(已乘100)。据此判断 data 的口径,未知时为空串 |
data.report_list[].item_list[].data | string | 字段数值。当 value_type='amount' 为金额(本位币单位),当 value_type='percent' 为百分数(如 47.86 表示 47.86%),例: 196458000000 / 47.8624 |
data.report_list[].item_list[].yoy | string | 同比增长率(%),例: 9.129995222806102 |
data.report_list[].item_list[].qoq | string | 环比增长率(%),例: 1.0737198450386116 |
pagination | object | |
pagination.has_more | bool | |
pagination.next_key | string |
item_list 元素字段:
| 字段 | 类型 | 说明 |
|---|---|---|
field_id | int | 字段 ID。 |
display_name | string | 字段英文名,如 Total Revenue。 |
value_type | string | 数值口径:amount=金额 / percent=百分数。 |
data | number | 字段数值。 |
yoy | number | 同比增长率(%)。 |
qoq | number | 环比增长率(%)。 |
枚举 financial_structure(财报结构)
| 取值 | structure_name | 含义(市场 x 行业) |
|---|---|---|
| 1 | NORMAL_KCB | 科创板 - 普通 |
| 2 | BANK_KCB | 科创板 - 金融 |
| 3 | NORMAL_A | A股 - 普通 |
| 4 | BANK_A | A股 - 金融 |
| 5 | NORMAL_HK | 港股 - 普通 |
| 6 | BANK_HK | 港股 - 银行 |
| 7 | INSURANCE_HK | 港股 - 保险 |
| 8 | NORMAL_MSTAR | 美 / 新 / 加 / 澳股 - 普通 |
| 9 | BANK_MSTAR | 美 / 新 / 加 / 澳股 - 银行 |
| 10 | INSURANCE_MSTAR | 美 / 新 / 加 / 澳股 - 保险 |
| 11 | NONNORMAL_MSTAR | 美 / 新 / 加 / 澳股 - 普通(非标准) |
| 12 | NONBANK_MSTAR | 美 / 新 / 加 / 澳股 - 银行(非标准) |
| 13 | NONINSURANCE_MSTAR | 美 / 新 / 加 / 澳股 - 保险(非标准) |
| 14 | NORMAL_MAIN_INDEX_US | 美股主要指标 - 普通 |
| 15 | BANK_MAIN_INDEX_US | 美股主要指标 - 银行 |
| 16 | INSURANCE_MAIN_INDEX_US | 美股主要指标 - 保险 |
| 17 | NORMAL_MAIN_INDEX_MSTAR | 新 / 加 / 澳股主要指标 - 普通 |
| 18 | BANK_MAIN_INDEX_MSTAR | 新 / 加 / 澳股主要指标 - 银行 |
| 19 | INSURANCE_MAIN_INDEX_MSTAR | 新 / 加 / 澳股主要指标 - 保险 |
限制范围
- 支持市场:HK / US / SH / SZ / BJ / SG / JP / AU / CA。
- 支持品类:有公开财报的公司类标的(正股及等价品类)。
- 非公司品类(指数 / 板块 / ETF / 基金 / 窝轮 / 期权 / 期货 / 外汇 / 加密)或公司无该报表时返回 no_data。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| -3 | invalid_parameter | 缺 symbol / statement_type 不在 [1,2,3,4] / financial_type 不在允许范围 / num > 50 | 校正请求后重试 |
| -7 | invalid_symbol | symbol 解析不到对应证券 | 通过 search 接口确认代码合法性 |
| -10 | no_data | 合法标的但该报表/期无数据 | 属正常空结果,无需重试 |
| -4 / -6 | internal_error | 服务错误 | 重试;持续失败联系技术支持 |
响应示例
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"
}
}