财务报表

POST /v1/quote/f10/statements

获取公司的利润表 / 资产负债表 / 现金流量表 / 主要指标数据，按财报期返回。每条记录包含报告期、财年、财报期类型、币种与会计准则，以及 item_list（每个字段含 field_id、英文字段名 display_name、数值、同比 yoy、环比 qoq）。

请求参数

参数	类型	位置	必填	说明
symbol	string	请求体	是	股票代码，如 HK.00700。
statement_type	int	请求体	否	报表类型。默认 1。1=利润表，2=资产负债表，3=现金流量表，4=主要指标。
financial_type	int	请求体	否	财报期类型。默认 10。详见命名词典。
currency_code	string	请求体	否	货币代码（ISO 4217），如 CNY、USD。默认按报表自带币种。
next_key	string	请求体	否	翻页游标。首页留空；下一页把上次响应的 pagination.next_key 原样回传。
limit	int	请求体	否	每页数量。默认 10，最大 50。

请求示例

curl -X POST "$ip/v1/quote/f10/statements" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"HK.00700","statement_type":1,"financial_type":10,"limit":1}' | jq

响应字段

返回 data.report_list[]，每元素一份财报；翻页游标见顶层 pagination（has_more / next_key）。

report 字段：

字段	类型	说明
date_time	int	财报报告期，毫秒时间戳。
fiscal_year	int	财年，如 2026。
financial_type	int	本期具体财报期类型，详见命名词典。
structure	int	财报结构编号（由市场 x 行业决定），详见下方 financial_structure 枚举表。
structure_name	string	structure 的可读名，如 NORMAL_HK。
period_text	string	财报期文本，如 2026/Q1。
currency_code	string	币种代码，如 CNY。
accounting_standards	string	会计准则，如 IAS、US_GAAP。
auditor_report	string	审计意见。
item_list	array	字段明细数组。

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	网关内部错误	重试；持续失败联系网关方

响应示例

{
  "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": null,
        "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" }
}