Hk valuatnanalyd

查询港股估值分析（分页）（hk-valuatnanalyd）

1. 接口描述

项目	说明
接口名称	查询港股估值分析（分页）
外部接口	/api/v1/market/data/hk/hk-valuatnanalyd
请求方式	GET
适用场景	分页查询 hkstk_valuatnanalyd 估值分析明细；可按 trade_code 过滤单票，不传则返回全市场分页数据

2. 请求参数

参数名	类型	是否必填	描述	取值示例	备注
trade_code	string	否	港股代码	00700.HK	支持 700 或 00700.HK，内部规范为 5 位 + .HK
page	int	否	页码（从 1 开始）	1	默认 1
page_size	int	否	每页条数	20	默认 20

3. 响应说明

返回值为分页结构 PaginatedResponse<HkStkValuatnAnalydItem>：items、total_pages、total_items。数值类字段在 JSON 中多为字符串形式（ApiDecimal 序列化）。

PaginatedResponse 结构

字段名	类型	是否可为空	说明	单位
items	Array	否	当前页数据列表	-
total_pages	int	否	总页数	-
total_items	int	否	总记录数（未分页前）	-

HkStkValuatnAnalydItem 结构（items 元素）

字段名	类型	是否可为空	说明	单位
security_name	String	否	证券简称	-
id	int64	否	记录 ID	-
security_id	String	否	证券 ID	-
trade_code	String	否	交易代码	-
trade_date	int	否	计算日期，YYYYMMDD（东八区交易日）	-
price_close	String	否	收盘价	元
minprice_chg	String	否	最小变动价格	元
volume	String	否	成交股数	股
amount	String	否	成交额	元
volatility_y	String	否	波动率（一年）	%
hshare_num	String	否	港股股数	股
hshare_limit_num	String	否	港股限售股股数	股
hshare_mv	String	否	港股市值	元
hshare_circ_mv	String	否	港股流通市值	元
nonhshare_num	String	否	非港股股数	股
ashare_num	String	否	A 股股数	股
bshare_num	String	否	B 股股数	股
turnover_rt	String	否	换手率	%
pe_lyr	String	否	静态市盈率	-
forwd_pe	String	否	动态市盈率	-
pe_ttm	String	否	滚动市盈率	-
ps	String	否	市销率	-
ps_ttm	String	否	滚动市销率	-
pb	String	否	市净率	-
pcf	String	否	市现率（经营现金流量净额）	-
pcf_ttm	String	否	滚动市现率	-
dividrt_lyr_rpt	String	否	静态股息率（报告期）	%
dividrt_ttm	String	否	滚动股息率	%
op_mode	int	否	操作模式	-
update_time	int64	否	更新时间（东八区），如 20260324120000 → 2026-03-24 12:00:00 +08:00	-

4. 调用方式

本 handler 与上级 FTShare-hk-data/run.py 配合使用：

# 单票
python <RUN_PY> hk-valuatnanalyd --trade_code 00700.HK --page 1 --page_size 20

# 全市场分页（不传 trade_code）
python <RUN_PY> hk-valuatnanalyd --page 1 --page_size 20

其中 <RUN_PY> 为 FTShare-hk-data/run.py 的绝对路径。

直接执行 handler（调试）

python scripts/handler.py --trade_code 00700.HK --page 1 --page_size 20

（需在 sub-skills/hk-valuatnanalyd 目录下执行，或传入脚本完整路径。）

5. 请求示例

GET /api/v1/market/data/hk/hk-valuatnanalyd?trade_code=00700.HK&page=1&page_size=20

全市场分页（不传 trade_code）：

GET /api/v1/market/data/hk/hk-valuatnanalyd?page=1&page_size=20