Hk balance

查询港股资产负债表（宽表，按公司类型分子接口）

接口说明

项目	说明
接口名称	对外接口-查询港股资产负债表
外部接口	GET /api/v1/market/data/hk/hk-balance-{gene|bank|insur}
请求方式	GET
适用场景	查询港股上市公司资产负债表（时点数据）。gene 一般企业 150 字段、bank 银行 84 字段、insur 保险 85 字段。用 --company_type 选择。

请求参数

参数名	类型	是否必填	描述	取值示例	备注
trade_code	string	否	港股代码	00700.HK	支持 00700.HK 或 700
year	int	否	报告期年份（日历年）	2025	仅当前年及前 2 年；须与 report_type 成对
report_type	string	否	报告类型	annual	annual/semi；须与 year 成对
company_type	string	否	公司类型/子接口	gene	gene(默认)/bank/insur
start_date	int	否	起始截止日	20250101	YYYYMMDD
end_date	int	否	结束截止日	20251231	YYYYMMDD
page / page_size	int	否	分页	1 / 20	默认 1 / 20

至少需要一个过滤条件，否则 400。

执行方式

# 腾讯 00700 资产负债表（最近 3 年）
python scripts/handler.py --trade_code 00700.HK
# 腾讯 2024 年报资产负债表
python scripts/handler.py --trade_code 00700.HK --year 2024 --report_type annual
# 银行业
python scripts/handler.py --trade_code 2388 --company_type bank

响应结构（宽表，时点数据）

{
  "items": [
    { "trade_code": "00700.HK", "security_name": "腾讯控股", "fiscal_y": 2024,
      "rpt_period": "2024-12-31", "report_type": "annual", "publish_date": "2025-03-19",
      "end_date": "2024-12-31", "currency": "CNY", "company_type": "一般企业", "account_std": "IFRS",
      "fixed_assets": "5286100", "total_assets": "128537200", "accounts_payabl": "3895200",
      "sharecapital": "94200", "retained_profit": "75321800" }
  ],
  "total_pages": 5, "total_items": 98
}

公共字段

trade_code、security_name、publish_date、end_date、rpt_period、fiscal_y、company_type、report_type、currency、account_std。

主要财务字段（gene 一般企业，Decimal 字符串或 null）

资产：fixed_assets 固定资产、invest_property 投资性房地产、total_assets 资产总计、商誉、存货、应收/应付等。 负债/权益：accounts_payabl 应付账款、sharecapital 股本、retained_profit 留存收益、totalintanctliability 负债及权益总计 等（共 150 字段）。

bank（现金/同业存放/发放贷款/客户存款/已发行债券 等 84 字段）、insur（存款/储备金/再保险资产/保险合同负债 等 85 字段）字段集不同。

注意事项

• 宽表、时点数据：通常只有期末值。
• 按公司类型选子接口（--company_type），否则行业专用科目为 null。
• 额外返回 company_type（公司类型）和 account_std（会计准则）。
• year 仅当前年及前 2 年；year 与 report_type 必须成对；至少一个过滤条件。
• 所有 Decimal 字段（金额、EPS 等）均为放大整数，实际值 = 返回值 ÷ 10000（金额→元；如腾讯 2024 总资产 12853720000000000 → ÷1e4 = ¥1.285 万亿）。币种见 currency 字段。
• trade_code 支持简写自动标准化。