查询北向资金交易数据
接口说明
| 项目 |
说明 |
| 接口名称 |
查询北向资金交易数据 |
| 外部接口 |
/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)