Skip to content

空头持仓 ​

GET /api/v1.0/quote/{symbol}/short/interest

获取股票的空头持仓数据(港股 / 美股),数据按交易日由新到旧返回。港股为空头持仓详情,美股为月度空头报告。

请求参数 ​

参数类型位置必填说明
symbolstring路径是标的代码,如 HK.00700 或 US.AAPL。
countint查询否返回条数。默认 30,最大 90。

请求示例 ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/short/interest?count=2" | jq

响应字段 ​

港股 items 字段:

参数类型说明
dataobject
data.itemsobject[]
data.items[].timestampint数据时间戳(毫秒,市场零点),例: 1777521600000
data.items[].timestamp_strstring数据日期 YYYY-MM-DD(按市场时区),例: 2026-04-30
data.items[].aggregated_shortint未平仓股数,例: 54177721
data.items[].aggregated_short_rationumber占流通股比例(百分数),例: 0.59 表示 0.59%
data.items[].close_pricenumber收盘价,例: 271.100223139
data.items[].last_close_pricenumber上一交易日收盘价,例: 269.921309325
data.items[].avg_costnumber空仓平均成本(本接口额外字段),例: 456.399
data.items[].avg_daily_short_volumeint日均卖空成交量(本接口额外字段),例: 6490673
data.items[].shares_shortint卖空股数,例: 134675274
data.items[].short_percentnumber卖空比例(百分数),例: 0.865 表示 0.865%
data.items[].avg_daily_share_volumeint平均日成交量,例: 45944025
data.items[].days_to_covernumber回补天数,例: 2.93
paginationobject部分接口返回分页信息

美股 items 字段:

字段类型说明
timestampint数据时间(毫秒时间戳)。
timestamp_strstring数据日期(yyyy-MM-dd)。
shares_shortstring卖空股数(int64 序列化为 string)。
short_percentfloat卖空比例(%)。
avg_daily_share_volumestring平均日成交量。
days_to_coverfloat回补天数。
close_pricefloat收盘价。
last_close_pricefloat上一交易日收盘价。
avg_daily_short_volumestring日均卖空成交量。

限制范围 ​

  • 市场:仅支持港股(HK)与美股(US)。
  • 品类:仅支持正股与基金(ETF);指数、窝轮、期权等不支持。
  • 不支持的市场或品类返回 unsupported 错误。

错误码 ​

ret_codeerror.code触发条件处理建议
0—成功—
-3invalid_parametercount 越界 / symbol 格式非法校正参数后重试
-7invalid_symbolsymbol 格式合法但标的不存在核对标的代码
-8unsupported市场或品类不在支持范围仅对港股/美股正股与基金调用
-10no_data标的无空头持仓数据视为该标的暂无空头数据
-5internal_error服务错误重试;持续失败联系支持

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "aggregated_short": 54177721,
        "aggregated_short_ratio": 0.59,
        "avg_cost": 456.399,
        "avg_daily_short_volume": 3755740,
        "close_price": 456.4,
        "last_close_price": 454.9,
        "timestamp": 1778774400000,
        "timestamp_str": "2026-05-15"
      },
      {
        "aggregated_short": 44972868,
        "aggregated_short_ratio": 0.49,
        "avg_cost": 471.399,
        "avg_daily_short_volume": 2392820,
        "close_price": 466.1,
        "last_close_price": 472.1,
        "timestamp": 1778169600000,
        "timestamp_str": "2026-05-08"
      }
    ]
  }
}