REST 接口 · 文档目录

美股 空头持仓 · REST 接口

空头持仓。获取经纪交易商向 FINRA 报送的聚合空头持仓数据,频率为两周一次。空头持仓指已卖空但尚未回补或平仓的股份总数,可反映市场情绪与潜在价格变动;高企的空头持仓可能意味着看空情绪,也可能提示轧空机会。

GET /stocks/v1/short-interest
上游时效说明

每 2 周更新

上游历史范围

数据可追溯至 2017 年 12 月 29 日

适用场景

  • 市场情绪分析、轧空预测、风险管理、交易策略优化。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
tickerstringNo该股票的主代码。
ticker.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
ticker.gtstringNo筛选大于该值。
ticker.gtestringNo筛选大于或等于该值。
ticker.ltstringNo筛选小于该值。
ticker.ltestringNo筛选小于或等于该值。
days_to_covernumberNo按 short_interest 除以 avg_daily_volume 计算,表示按平均成交量估算回补全部空头头寸所需的天数。取值必须为浮点数。
days_to_cover.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为浮点数。
days_to_cover.gtnumberNo筛选大于该值。值必须为浮点数。
days_to_cover.gtenumberNo筛选大于或等于该值。值必须为浮点数。
days_to_cover.ltnumberNo筛选小于该值。值必须为浮点数。
days_to_cover.ltenumberNo筛选小于或等于该值。值必须为浮点数。
settlement_datestringNo空头持仓数据被视为已结算的日期(格式 YYYY-MM-DD),通常依据交易所的报告安排确定。
settlement_date.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
settlement_date.gtstringNo筛选大于该值。
settlement_date.gtestringNo筛选大于或等于该值。
settlement_date.ltstringNo筛选小于该值。
settlement_date.ltestringNo筛选小于或等于该值。
avg_daily_volumeintegerNo该股票在指定期间的平均日成交量,通常用于为做空数据提供参照。取值必须为整数。
avg_daily_volume.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为整数。
avg_daily_volume.gtintegerNo筛选大于该值。值必须为整数。
avg_daily_volume.gteintegerNo筛选大于或等于该值。值必须为整数。
avg_daily_volume.ltintegerNo筛选小于该值。值必须为整数。
avg_daily_volume.lteintegerNo筛选小于或等于该值。值必须为整数。
limitintegerNo限制返回结果的最大数量。未指定时默认为 10,允许的最大值为 50000。
sortstringNo逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 ticker,排序方向默认为 asc。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]本次请求的结果。
results[].avg_daily_volumeinteger该股票在指定期间的平均日成交量,通常用于为做空数据提供参照。
results[].days_to_covernumber按 short_interest 除以 avg_daily_volume 计算,表示按平均成交量估算回补全部空头头寸所需的天数。
results[].settlement_datestring空头持仓数据被视为已结算的日期(格式 YYYY-MM-DD),通常依据交易所的报告安排确定。
results[].short_interestinteger已卖空但尚未回补或平仓的股份总数。
results[].tickerstring该股票的主代码。
statusenum: OK本次请求响应的状态。

响应示例

{
  "count": 1,
  "request_id": 1,
  "results": [
    {
      "avg_daily_volume": 2340158,
      "days_to_cover": 1.67,
      "settlement_date": "2025-03-14",
      "short_interest": 3906231,
      "ticker": "A"
    }
  ],
  "status": "OK"
}

原文:Massive 文档 ↗