Northbound

查询北向资金交易数据

接口说明

项目	说明
接口名称	查询北向资金交易数据
外部接口	/api/v1/market/data/northbound
请求方式	GET
适用场景	查询指定交易日北向资金（沪股通、深股通）交易汇总数据

请求参数

参数名	类型	是否必填	描述	取值示例	备注
date	string	是	交易日期	20250101	格式 YYYYMMDD

执行方式

通过根目录的 run.py 调用（推荐）：

python <RUN_PY> northbound --date 20250101

<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径，参见主 SKILL.md 的「调用方式」说明。

响应结构

{
    "code": 0,
    "message": "success",
    "data": {
        "date": "20250101",
        "currency": "CNY",
        "total_amount": "100.50",
        "channels": {
            "SH": { "amount": "60.00", "trade_count": 10 },
            "SZ": { "amount": "40.50", "trade_count": 8 }
        }
    }
}

顶层字段说明

字段名	类型	是否可为空	说明
code	int	否	业务状态码，0 表示成功
message	string	否	状态说明
data	object	否	北向资金数据

data 字段说明

字段名	类型	是否可为空	说明
date	string	否	交易日期
currency	string	否	币种（CNY）
total_amount	string	否	北向资金合计成交额
channels	object	否	分市场通道数据

channels 字段说明

字段名	类型	是否可为空	说明
SH	object	否	沪股通数据
SH.amount	string	否	成交额
SH.trade_count	int	否	成交笔数
SZ	object	否	深股通数据
SZ.amount	string	否	成交额
SZ.trade_count	int	否	成交笔数

注意事项

• date 为必填参数，格式 YYYYMMDD
• 金额类字段以字符串格式返回
• 响应为信封结构（code / message / data）