查询单只证券的北向持股数量及占已发行股份比例。2024-08-19 前为日度披露，此后为季度末快照。
季度更新
历史覆盖：2023-07-11 至今（2024-08-19 前日度，此后季度快照）
POST
/apiapiname:northbound_holding推荐调用地址深圳日内节点
https://sz.meoz.cn:6688/api上海日内节点https://sh.meoz.cn:6688/api深圳 HTTP 兼容（仅程序调用）http://sz.numcat.net:8866/api上海 HTTP 兼容（仅程序调用）http://sh.numcat.net:8866/api请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
apikey | string | 必选 | — | 浏览器中的 Test Request 会在发送时自动注入；其他调用请[前往个人中心获取](/console)。 |
apiname | string（northbound_holding） | 必选 | northbound_holding | 接口名称 |
fields | string|null | 可选 | symbol,trade_date,name,vol,ratio,exchange | | 字段 | 类型 | 名称 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | `symbol` | `string` | 证券代码 | `000001` | 证券代码 | | `trade_date` | `string` | 持股日期 | `20260724` | 持股日期，格式 YYYYMMDD | | `name` | `string\|null` | 证券名称 | `平安银行` | 证券名称 | | `vol` | `number\|null` | 成交量（手） | `1628345` | 持股数量 | | `ratio` | `number\|null` | 持股比例 | `2.35` | 持股比例 | | `exchange` | `string` | 交易所 | `示例` | 交易所 | |
params | object | 可选 | {"tradedate":"20260630"} | | 参数 | 类型 | 是否必选 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | `symbols` | `string\|array` | 可选 | `000001,600000` | 股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。 | | `tradedate` | `string` | 可选 | `20260724` | 查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。 | | `startdate` | `string` | 可选 | `20260701` | 查询区间开始日期，格式：YYYYMMDD；仅传该参数时查询至最新交易日。 | | `enddate` | `string` | 可选 | `20260724` | 查询区间结束日期，格式：YYYYMMDD；仅传该参数时按该交易日查询。 | | `exchange` | `string` | 可选 | — | 类型，SH为沪股通、SZ为深股通、HK为港股通；多个值用英文逗号分隔 | |
params 参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
enddate | string | 可选 | 20260724 | 查询区间结束日期，格式：YYYYMMDD；仅传该参数时按该交易日查询。 |
exchange | string | 可选 | — | 类型，SH为沪股通、SZ为深股通、HK为港股通；多个值用英文逗号分隔 |
startdate | string | 可选 | 20260701 | 查询区间开始日期，格式：YYYYMMDD；仅传该参数时查询至最新交易日。 |
symbols | string|array<string> | 可选 | 000001,600000 | 股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。 |
tradedate | string | 可选 | 20260724 | 查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。 |
fields 返回字段
字段顺序与接口样例保持一致| 字段 | 类型 | 名称 | 示例值 | 描述 |
|---|---|---|---|---|
symbol | string | — | — | 证券代码 |
trade_date | string | — | — | 持股日期，格式 YYYYMMDD |
name | string|null | — | — | 证券名称 |
vol | number|null | — | — | 持股数量；单位：股 |
ratio | number|null | — | — | 持股比例 |
exchange | string | — | — | 交易所 |
请求与响应样例
固定样例
{
"apikey": "YOUR_API_KEY",
"apiname": "northbound_holding",
"fields": "symbol,trade_date,name,vol,ratio,exchange",
"params": {
"tradedate": "20260630"
}
}{
"code": 200,
"data": {
"fields": [
"symbol",
"trade_date",
"name",
"vol",
"ratio",
"exchange"
],
"items": [
[
"000001",
"20260724",
"平安银行",
1628345,
2.35,
"示例"
]
]
},
"message": "success"
}