持股明细
查询单只证券的北向持股数量及占已发行股份比例。2024-08-19 前为日度披露,此后为季度末快照。
历史数据接口标识
northbound_holding文档 ID history/fund-flow/northbound-holding文档 v1.0.52数据范围与限制
已发布的范围与限制说明:查询单只证券的北向持股数量及占已发行股份比例。2024-08-19 前为日度披露,此后为季度末快照。 季度更新 历史覆盖:2023-07-11 至今(2024-08-19 前日度,此后季度快照) 仅查询90本地已发布数据;不指定日期时读取最近已发布业务窗口,不回退80。 未单独标注的起止日期、市场、资产范围及逐标的数据完整性尚未确认;示例日期不代表完整覆盖。
请求
| HTTP URL | https://hist.meoz.cn:6688/api |
|---|---|
| HTTP URL | https://hist-vip.meoz.cn:6688/api |
| HTTP Method | POST |
请求头
Content-Type: application/json
请求体
| 字段 | 名称 | 描述 | 示例 | 类型 |
|---|---|---|---|---|
symbol | 证券代码 | 证券代码 | 000001 | string |
trade_date | 持股日期 | 持股日期,格式 YYYYMMDD | 20260724 | string |
name | 证券名称 | 证券名称 | 平安银行 | string|null |
vol | 成交量(手) | 持股数量;单位:股 | 1628345 | number|null |
ratio | 持股比例 | 持股比例 | 2.35 | number|null |
exchange | 交易所 | 交易所 | 示例 | string |
| 字段 | 描述 | 示例 | 类型 |
|---|---|---|---|
enddate | 查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。 可选 | 20260724 | string |
exchange | 类型,SH为沪股通、SZ为深股通、HK为港股通;多个值用英文逗号分隔 可选 | — | string |
startdate | 查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。 可选 | 20260701 | string |
symbols | 股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。 可选 | 000001,600000 | string | string[] |
tradedate | 查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。 可选 | 20260724 | string |
请求示例
使用自己的 API Key 替换 YOUR_API_KEY。以下均为直接 HTTP 调用示例,语言库要求在代码中注明。
{ "apikey": "YOUR_API_KEY", "apiname": "northbound_holding", "fields": "symbol,trade_date,name,vol,ratio,exchange", "params": { "tradedate": "20260630" }}响应
响应体
Successful Response
| 字段 | 说明 | 类型 |
|---|---|---|
code | 业务状态码,200 表示成功 | integer |
| 矩阵型返回数据 | object | null | |
fields | 返回字段名列表,顺序与 items 中每一列一一对应 | string[] |
items | 二维数组数据,每一行代表一条记录 | any[][] |
message | 响应消息 | string |
响应体示例
由已发布字段示例组合,用于说明响应结构,不是实际查询结果。
{ "code": 200, "data": { "fields": [ "symbol", "trade_date", "name", "vol", "ratio", "exchange" ], "items": [ [ "000001", "20260724", "平安银行", 1628345, 2.35, "示例" ] ] }, "message": "success"}