美股 空头持仓 · REST 接口
空头持仓。获取经纪交易商向 FINRA 报送的聚合空头持仓数据,频率为两周一次。空头持仓指已卖空但尚未回补或平仓的股份总数,可反映市场情绪与潜在价格变动;高企的空头持仓可能意味着看空情绪,也可能提示轧空机会。
GET /stocks/v1/short-interest上游时效说明
每 2 周更新
上游历史范围
数据可追溯至 2017 年 12 月 29 日
适用场景
- 市场情绪分析、轧空预测、风险管理、交易策略优化。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ticker | string | No | 该股票的主代码。 |
ticker.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
ticker.gt | string | No | 筛选大于该值。 |
ticker.gte | string | No | 筛选大于或等于该值。 |
ticker.lt | string | No | 筛选小于该值。 |
ticker.lte | string | No | 筛选小于或等于该值。 |
days_to_cover | number | No | 按 short_interest 除以 avg_daily_volume 计算,表示按平均成交量估算回补全部空头头寸所需的天数。取值必须为浮点数。 |
days_to_cover.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为浮点数。 |
days_to_cover.gt | number | No | 筛选大于该值。值必须为浮点数。 |
days_to_cover.gte | number | No | 筛选大于或等于该值。值必须为浮点数。 |
days_to_cover.lt | number | No | 筛选小于该值。值必须为浮点数。 |
days_to_cover.lte | number | No | 筛选小于或等于该值。值必须为浮点数。 |
settlement_date | string | No | 空头持仓数据被视为已结算的日期(格式 YYYY-MM-DD),通常依据交易所的报告安排确定。 |
settlement_date.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
settlement_date.gt | string | No | 筛选大于该值。 |
settlement_date.gte | string | No | 筛选大于或等于该值。 |
settlement_date.lt | string | No | 筛选小于该值。 |
settlement_date.lte | string | No | 筛选小于或等于该值。 |
avg_daily_volume | integer | No | 该股票在指定期间的平均日成交量,通常用于为做空数据提供参照。取值必须为整数。 |
avg_daily_volume.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为整数。 |
avg_daily_volume.gt | integer | No | 筛选大于该值。值必须为整数。 |
avg_daily_volume.gte | integer | No | 筛选大于或等于该值。值必须为整数。 |
avg_daily_volume.lt | integer | No | 筛选小于该值。值必须为整数。 |
avg_daily_volume.lte | integer | No | 筛选小于或等于该值。值必须为整数。 |
limit | integer | No | 限制返回结果的最大数量。未指定时默认为 10,允许的最大值为 50000。 |
sort | string | No | 逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 ticker,排序方向默认为 asc。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
next_url | string | 若存在,可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 本次请求的结果。 |
results[].avg_daily_volume | integer | 该股票在指定期间的平均日成交量,通常用于为做空数据提供参照。 |
results[].days_to_cover | number | 按 short_interest 除以 avg_daily_volume 计算,表示按平均成交量估算回补全部空头头寸所需的天数。 |
results[].settlement_date | string | 空头持仓数据被视为已结算的日期(格式 YYYY-MM-DD),通常依据交易所的报告安排确定。 |
results[].short_interest | integer | 已卖空但尚未回补或平仓的股份总数。 |
results[].ticker | string | 该股票的主代码。 |
status | enum: 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 文档 ↗