持股明细

数据浏览

查询单只证券的北向持股数量及占已发行股份比例。2024-08-19 前为日度披露,此后为季度末快照。

历史数据接口标识 northbound_holding文档 ID history/fund-flow/northbound-holding文档 v1.0.52

下载此接口 OpenAPI

数据范围与限制

已发布的范围与限制说明:查询单只证券的北向持股数量及占已发行股份比例。2024-08-19 前为日度披露,此后为季度末快照。 季度更新 历史覆盖:2023-07-11 至今(2024-08-19 前日度,此后季度快照) 仅查询90本地已发布数据;不指定日期时读取最近已发布业务窗口,不回退80。 未单独标注的起止日期、市场、资产范围及逐标的数据完整性尚未确认;示例日期不代表完整覆盖。

请求

HTTP URLhttps://hist.meoz.cn:6688/api
HTTP URLhttps://hist-vip.meoz.cn:6688/api
HTTP MethodPOST

请求头

Content-Type: application/json

请求体

apikey

类型:string必填

浏览器中的 Test Request 会在发送时自动注入;其他调用请前往个人中心获取。 默认值:""。

apiname

类型:string(northbound_holding)必填

接口名称 默认值:"northbound_holding"。

fields

类型:string|null可选

选择要返回的字段,多个字段用英文逗号分隔。 默认值:"symbol,trade_date,name,vol,ratio,exchange"。

字段名称描述示例类型
symbol证券代码证券代码000001string
trade_date持股日期持股日期,格式 YYYYMMDD20260724string
name证券名称证券名称平安银行string|null
vol成交量(手)持股数量;单位:股1628345number|null
ratio持股比例持股比例2.35number|null
exchange交易所交易所示例string

params

类型:object可选

查询条件;参数格式与使用要求见下表。 默认值:{"tradedate":"20260630"}。

字段描述示例类型
enddate查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。
可选
20260724string
exchange类型,SH为沪股通、SZ为深股通、HK为港股通;多个值用英文逗号分隔
可选
—string
startdate查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。
可选
20260701string
symbols股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。
可选
000001,600000string | string[]
tradedate查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。
可选
20260724string

请求示例

使用自己的 API Key 替换 YOUR_API_KEY。以下均为直接 HTTP 调用示例,语言库要求在代码中注明。

基础查询

数据浏览
基础查询 · JSON
{  "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"}