Hk income

查询港股利润表（宽表，按公司类型分子接口）

接口说明

项目	说明
接口名称	对外接口-查询港股利润表
外部接口	GET /api/v1/market/data/hk/hk-income-{gene|bank|insur}
请求方式	GET
适用场景	查询港股上市公司利润表。一般企业 gene、银行业 bank、保险业 insur 字段不同，用 --company_type 选择。数据来源 ClickHouse hkstk_income_gene/bank/insur。

请求参数

参数名	类型	是否必填	描述	取值示例	备注
trade_code	string	否	港股代码	00700.HK	支持 00700.HK 或 700 简写
year	int	否	报告期年份（日历年）	2025	仅当前年及前 2 年；须与 report_type 成对
report_type	string	否	报告类型	annual	annual(年报)/semi(半年报)；须与 year 成对，不支持 q1/q3
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

至少需要一个过滤条件：trade_code、start_date、end_date、或 year+report_type，否则 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
# 全市场 2025 年报
python scripts/handler.py --year 2025 --report_type annual --page 1 --page_size 20
# 银行业（如中银香港 2388）
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",
      "turn_over": "66025688", "operat_profit": "23784512", "earning_aftax": "21909950",
      "prof_sharehlders": "21129830", "eps_basic": "22.46", "eps": "22.32", "dividend_pershare": "4.50" }
  ],
  "total_pages": 5, "total_items": 98
}

公共字段

trade_code、security_name、fiscal_y(财政年度)、rpt_period(报告期描述)、report_type、publish_date、end_date、currency。

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

turn_over 营业额、income 收入、salescost 销售成本、grossprofit 毛利、opeexpense_ae 营业费用、admexpenses_ae 行政费用、rnddexpenses_ae 研发费用、operat_profit 营业利润、earning_beftax 税前利润、tax 税项、earning_aftax 税后利润、mino_n_profit 少数股东利润、prof_sharehlders 归属股东利润、eps_basic 基本EPS、eps EPS、dividend_pershare 每股股息。

bank/insur 字段集不同（银行有净利息收入等，保险有净保费收入等），详见底表。

注意事项

• 港股财报是宽表（一行一个报告期，所有科目为列），非长表 EAV。
• 按公司类型选子接口：银行用 --company_type bank、保险用 --company_type insur，否则该行业专用科目为 null。
• year 仅支持当前年及前 2 年（如 2026 年时仅 2024/2025/2026）；year 与 report_type 必须成对。
• 排序：有 trade_code 时按 end_date DESC, publish_date DESC。
• 所有 Decimal 字段（金额、EPS 等）均为放大整数，实际值 = 返回值 ÷ 10000（金额→元、EPS→元/股；如腾讯 2024 营收 6602570000000000 → ÷1e4 = ¥6602.57 亿，中国移动 EPS 63500 → 6.35）。币种见 currency 字段（人民币/港元/美元等）。
• trade_code 支持简写自动标准化（700 → 00700.HK）。