互联互通

资金流持股明细接口文档

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

季度更新

历史覆盖：2023-07-11 至今（2024-08-19 前日度，此后季度快照）

POST/apiapiname:northbound_holding

生产专线（默认）深圳http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api

请求参数

参数	类型	是否必选	示例值	描述
`apiname`	string（northbound_holding）	必选	`northbound_holding`	固定接口名称，用于选择对应的数据能力。
`apikey`	string	必选	`—`	猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
`fields`	string\|null	可选	`symbol,trade_date,name,vol,ratio,exchange`	需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
`params`	object	可选	`{"tradedate":"20260630"}`	查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。

`params` 参数

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

`fields` 返回字段

字段顺序与接口样例保持一致

字段	类型	名称	示例值	描述
`symbol`	string	—	`—`	证券代码
`trade_date`	string	—	`—`	持股日期，格式 YYYYMMDD
`name`	string\|null	—	`—`	证券名称
`vol`	number\|null	—	`—`	持股数量；单位：股
`ratio`	number\|null	—	`—`	持股比例
`exchange`	string	—	`—`	交易所

请求与响应样例

固定样例

{
  "apiname": "northbound_holding",
  "apikey": "YOUR_API_KEY",
  "fields": "symbol,trade_date,name,vol,ratio,exchange",
  "params": {
    "tradedate": "20260630"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "fields": [
      "symbol",
      "trade_date",
      "name",
      "vol",
      "ratio",
      "exchange"
    ],
    "items": [
      [
        "000001",
        "20260724",
        "平安银行",
        1628345,
        2.35,
        "示例"
      ]
    ]
  }
}

请求参数

params 参数

fields 返回字段

请求与响应样例

相关接口

`params` 参数

`fields` 返回字段