免费美股空头持仓数据 API
核对结算日、空头股数、流通股、回补天数输入、公司行动和历史修订。
先看空头持仓数据口径
short interest 是指定结算日仍未平仓的空头头寸；每日卖空成交量只是交易活动，不能替代持仓快照。
结算日、官方发布日期与服务商抓取时间含义不同。回测时，数据在发布日期之前并不可知。
回补天数取决于平均成交量窗口，流通股卖空比例取决于 float 估算及其生效日；两个输入都应保存。
代码变更、拆股、并购、退市、更正和服务商回填都会破坏简单比较，应明确区分原始值与调整后视图。
免费美股空头持仓数据 API 应返回哪些字段
可用的美股空头持仓数据接口必须提供足够上下文，才能比较不同报告周期。缺少分母、日期或来源的单一百分比，不应直接用于分析。
FINRA 的空头持仓申报以指定结算日为基准，并在之后的发布日期公开。服务商可以更快分发已发布文件，但不能把官方持仓快照变成实时未平仓量。如果产品宣传“实时 short interest”，必须确认它指的是模型估算、证券借贷信号、每日卖空成交量，还是最近一次正式发布值。
| 字段 | 含义 | 核验重点 |
|---|---|---|
ticker | 接口使用的证券代码。 | 交易所与代码映射。 |
settlement_date | 报告持仓对应的结算日。 | 不要与发布日期混淆。 |
short_interest | 已卖空但尚未回补的股数。 | 单位、复权与缺失值。 |
avg_daily_volume | 用于比较的平均日成交量。 | 服务商采用的计算窗口。 |
days_to_cover | 空头股数除以平均日成交量。 | 输入齐全时自行复算。 |
publication_date | 该报告周期数值正式公开的日期。 | 时点研究必需，不能用结算日替代。 |
float_shares | 用于计算流通股卖空比例的可交易公众持股估算。 | 来源、口径日期、股份类别范围与拆股调整。 |
source_revision | 已发布观测值的版本或更正状态。 | 历史数据是覆盖、保留版本还是回填。 |
卖空比率 API 与回补天数
部分服务商用“卖空比率”指代回补天数。应先阅读数据字典，不要假设所有 ratio 都代表空头持仓占流通股比例。
即使两家服务都提供 days to cover，也可能采用不同的平均成交量窗口、交易场所范围或复权成交量。条件允许时应根据保存的输入自行复算并标明窗口；公式未统一前，不应直接跨服务商排名。
空头持仓量不等于卖空成交量
卖空成交量记录一段时间内的卖空交易活动；空头持仓量记录结算日尚未回补的头寸。两者回答不同问题，不能互相替代。
一笔卖空交易可以在当天回补，因此会出现在每日卖空成交量中，却不会留到下一次持仓快照；反过来，较早建立的空头头寸可以继续存在于 short interest 中，但当天并没有新的卖空成交。场外每日文件也不天然代表所有交易场所的合并口径。
如何选择历史美股空头持仓数据接口
检查免费方案是否包含空头持仓端点、可查询股票、请求限额、历史深度，以及是否需要信用卡。
确认交易所、在市与退市证券、最早结算日、更新时间，以及数据更正方式。
查看字段名是否稳定、空值如何表达、是否分页、是否支持日期过滤，以及单位、拆股和错误响应是否有文档。
免费 API Key 不等于允许再分发。应核对缓存、展示、商业用途、署名和数据保留条款。
样本应包含拆股、股票代码变更、多类别股份、退市和并购，确认历史空头股数是原始口径还是复权口径，以及接口是否在 ticker 之外保留稳定证券标识。
每条观测都应包含结算日、发布日期、抓取时间与更正状态。以历史日期重放，确认接口不会把之后的更正或回填伪装成当时已经可知的数据。
权威来源与报告口径
了解美国市场报告口径时，应查阅 FINRA 空头持仓报告说明。服务商可能对数据做标准化或补充，因此应同时记录原始报告日期和接口获取时间。
Python 获取美股空头持仓数据示例
请按服务商文档替换占位 URL 与鉴权方式。示例会先检查 HTTP 状态和必需字段，再进入分析。
import os
import requests
response = requests.get(
"https://api.example.com/v1/short-interest",
params={"ticker": "AAPL", "limit": 24},
headers={"Authorization": f"Bearer {os.environ['DATA_API_KEY']}"},
timeout=20,
)
response.raise_for_status()
rows = response.json()["results"]
required = {"settlement_date", "short_interest",
"avg_daily_volume", "days_to_cover"}
if rows and not required.issubset(rows[0]):
raise ValueError("Provider response is missing required fields")
for row in rows[:3]:
print(row["settlement_date"], row["days_to_cover"])按股票代码验证历史卖空数据
按结算日排序、检测重复记录、保留空值，并比较相邻报告。若自行计算变化率或回补天数，应保存精确输入字段和计算版本。
生产级验证器应以稳定证券标识、结算日和来源版本组成唯一键，而不是只用 ticker。检查空头股数是否为非负整数、日期是否符合预期报告日历、回补天数能否在容差范围内由文档规定的成交量窗口复算，并要求拆股前后的突变有明确解释。原始服务商响应也应保存，以便审计之后的更正。
用 QVeris 查找并调用空头持仓数据工具
QVeris 可以帮助 Agent 发现并检查官方空头持仓历史、派生比率或卖空成交量等能力。调用前，应明确需要哪一种数据、证券标识、结算日范围、发布日期截止时点、复权策略与必需分母；不能用每日卖空成交量替代未平仓空头头寸，也不能把每月两次的官方快照描述成实时数据。底层服务商仍是数据及其条款的来源。
- 打开 Massive Stocks Short Interest 工具详情，查看这一精确数据能力。
- 在允许智能体调用服务商前，先检查参数与返回字段。
- 参考 REST API 参考和 Python SDK 指南完成接入。
常见问题
部分服务商提供免费方案或评测额度，FINRA 也公开报告口径与相关数据资源。首先确认端点提供的是持仓快照，而不是只有每日卖空成交量，再核对历史、额度、许可与稳定证券标识。
先查看数据服务商的 API 文档，并与相关交易所或 FINRA 的报告口径对照。只有确认数据来源和字段结构后，才应选择并接入接口。
FINRA 会员公司针对每月两次的指定结算日申报持仓，之后还有报送截止日与公开发布日期。服务商采集时间、后续更正和所谓“实时”估算属于不同时间，应分别标明。
至少应包含股票代码、结算日、空头持仓股数、平均日成交量和回补天数；如条件允许，还应提供数据来源和获取时间等元数据。
不同。卖空成交量表示一段时间内的卖空交易活动；空头持仓量表示某个结算日仍未平仓的空头头寸。
调用有明确文档的股票代码查询端点，检查 HTTP 响应，解析 JSON，验证必需字段，再按结算日对记录排序。
它是空头股数除以定义明确的公众流通股数量。只有同时知道 float 来源、生效日、股份类别、公司行动复权方式和空头持仓结算日，这个比例才可以复算。
Yes, but use the publication date—not the settlement date—as the earliest availability time. Preserve revisions and avoid current float values or hindsight adjustments that were unknown at the simulated date.