FTShare-Lab 查询南向资金交易数据
接口说明
| 项目 | 说明 |
|---|---|
| 接口名称 | 查询南向资金交易数据 |
| 外部接口 | /api/v1/market/data/southbound |
| 请求方式 | GET |
| 适用场景 | 查询指定交易日南向资金（港股通沪、港股通深）交易汇总数据 |
请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
date |
string | 是 | 交易日期 | 20250101 |
格式 YYYYMMDD |
执行方式
通过根目录的 run.py 调用（推荐）：
python <RUN_PY> southbound --date 20250101
<RUN_PY>为主SKILL.md同级的run.py绝对路径，参见主 SKILL.md 的「调用方式」说明。
响应结构
{
"code": 0,
"message": "success",
"data": {
"date": "20250101",
"currency": "HKD",
"total": {
"buy_amount": "100.00",
"sell_amount": "80.00",
"net_buy_amount": "20.00",
"trade_count": 15
},
"channels": {
"SH_HK": {
"buy_amount": "60.00",
"sell_amount": "50.00",
"net_buy_amount": "10.00",
"trade_count": 8
},
"SZ_HK": {
"buy_amount": "40.00",
"sell_amount": "30.00",
"net_buy_amount": "10.00",
"trade_count": 7
}
}
}
}
顶层字段说明
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
code |
int | 否 | 业务状态码，0 表示成功 |
message |
string | 否 | 状态说明 |
data |
object | 否 | 南向资金数据 |
data 字段说明
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
date |
string | 否 | 交易日期 |
currency |
string | 否 | 币种（HKD） |
total |
object | 否 | 南向合计数据 |
total.buy_amount |
string | 否 | 买入额 |
total.sell_amount |
string | 否 | 卖出额 |
total.net_buy_amount |
string | 否 | 净买入额 |
total.trade_count |
int | 否 | 成交笔数 |
channels |
object | 否 | 分市场通道数据 |
channels 字段说明
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
SH_HK |
object | 否 | 港股通（沪）数据 |
SH_HK.buy_amount |
string | 否 | 买入额 |
SH_HK.sell_amount |
string | 否 | 卖出额 |
SH_HK.net_buy_amount |
string | 否 | 净买入额 |
SH_HK.trade_count |
int | 否 | 成交笔数 |
SZ_HK |
object | 否 | 港股通（深）数据 |
SZ_HK.buy_amount |
string | 否 | 买入额 |
SZ_HK.sell_amount |
string | 否 | 卖出额 |
SZ_HK.net_buy_amount |
string | 否 | 净买入额 |
SZ_HK.trade_count |
int | 否 | 成交笔数 |
注意事项
date为必填参数，格式YYYYMMDD- 金额类字段以字符串格式返回
- 响应为信封结构（
code/message/data） - 南向资金币种为 HKD（港币）