財務報表

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`。

請求示例

bash

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	網關內部錯誤	重試；持續失敗聯繫網關方

響應示例

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": 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" }
}

財務報表 ​

請求參數 ​

請求示例 ​

響應字段 ​

限制範圍 ​

錯誤碼 ​

響應示例 ​