持股明细
根据服务、资产与周期选择本接口。先核对请求参数,再用响应字段和单位解释结果。
查询单只证券的北向持股数量及占已发行股份比例。2024-08-19 前为日度披露,此后为季度末快照。
季度更新
历史覆盖:2023-07-11 至今(2024-08-19 前日度,此后季度快照)
仅查询90本地已发布数据;不指定日期时读取最近已发布业务窗口,不回退80。
接口名称 northbound_holding
请求方法 POST /api
- https://hist.meoz.cn:6688
- https://hist-vip.meoz.cn:6688
返回字段
| 字段 | 名称 | 类型 | 描述 | 单位 |
|---|---|---|---|---|
| symbol | string | 证券代码 | ||
| trade_date | string | 持股日期,格式 YYYYMMDD | ||
| name | string|null | 证券名称 | ||
| vol | number|null | 持股数量;单位:股 | ||
| ratio | number|null | 持股比例 | ||
| exchange | string | 交易所 |
请求
{"content":{"application/json":{"example":{"apikey":"","apiname":"northbound_holding","fields":"symbol,trade_date,name,vol,ratio,exchange","params":{"tradedate":"20260630"}},"schema":{"properties":{"apikey":{"default":"","description":"浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。","type":"string"},"apiname":{"default":"northbound_holding","description":"接口名称","enum":["northbound_holding"],"type":"string"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"symbol,trade_date,name,vol,ratio,exchange","description":"| 字段 | 类型 | 名称 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `symbol` | `string` | 证券代码 | `000001` | 证券代码 |\n| `trade_date` | `string` | 持股日期 | `20260724` | 持股日期,格式 YYYYMMDD |\n| `name` | `string\\|null` | 证券名称 | `平安银行` | 证券名称 |\n| `vol` | `number\\|null` | 成交量(手) | `1628345` | 持股数量 |\n| `ratio` | `number\\|null` | 持股比例 | `2.35` | 持股比例 |\n| `exchange` | `string` | 交易所 | `示例` | 交易所 |"},"params":{"additionalProperties":false,"default":{"tradedate":"20260630"},"description":"| 参数 | 类型 | 是否必选 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `symbols` | `string\\|array` | 可选 | `000001,600000` | 股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。 |\n| `tradedate` | `string` | 可选 | `20260724` | 查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。 |\n| `startdate` | `string` | 可选 | `20260701` | 查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。 |\n| `enddate` | `string` | 可选 | `20260724` | 查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。 |\n| `exchange` | `string` | 可选 | — | 类型,SH为沪股通、SZ为深股通、HK为港股通;多个值用英文逗号分隔 |","properties":{"enddate":{"description":"查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。","example":"20260724","pattern":"^\\d{8}$","type":"string"},"exchange":{"description":"类型,SH为沪股通、SZ为深股通、HK为港股通;多个值用英文逗号分隔","type":"string"},"startdate":{"description":"查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。","example":"20260701","pattern":"^\\d{8}$","type":"string"},"symbols":{"description":"股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。","example":"000001,600000","oneOf":[{"description":"单个或多个逗号分隔股票代码","type":"string"},{"description":"股票代码数组","items":{"type":"string"},"type":"array"}]},"tradedate":{"description":"查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。","example":"20260724","pattern":"^\\d{8}$","type":"string"}},"type":"object"}},"required":["apikey","apiname"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apiname` | `string` | 必选 | `northbound_holding` | 接口名称 |\n| `apikey` | `string` | 必选 | [访问个人中心获取](/console) | 访问密钥 |","required":true}
响应
{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"业务状态码,200 表示成功","example":200,"type":"integer"},"data":{"description":"矩阵型返回数据","nullable":true,"properties":{"fields":{"description":"返回字段名列表,顺序与 items 中每一列一一对应","example":["symbol","trade_date","name","vol","ratio","exchange"],"items":{"type":"string"},"type":"array"},"items":{"description":"二维数组数据,每一行代表一条记录","example":[["000001","20260724","平安银行",1628345,2.35,"示例"]],"items":{"items":{},"type":"array"},"type":"array"}},"required":["fields","items"],"type":"object"},"message":{"description":"响应消息","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Successful Response"},"429":{"content":{"application/json":{"schema":{"properties":{"code":{"example":429,"type":"integer"},"data":{"example":null,"nullable":true},"message":{"example":"请求频率超限:daily_auc_detail 接口的调用上限为 3 次/秒,请降低该接口的调用频率,建议 1 秒后重试。","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"账户总调用频率或单个重接口调用频率超过当前套餐限额。","headers":{"Retry-After":{"description":"建议等待后重试的秒数。","schema":{"minimum":1,"type":"integer"}}}}}