fintel-data
通过 FINTEL_API_KEY（X-API-KEY 请求头）经 REST API（https://api.fintel.io/v1）或官方 MCP 服务器（https://mcp.fintel.io/mcp）查询 Fintel（fintel.io）的机构市场情报。只读数据包括：空头利息、借券利率/费用及可借股票数量、每日卖空成交量、未交割证券（FTD）、基于 SEC 13F 文件的机构持股、基于 SEC Form 3/4/5 的内部人交易、分析师目标价、评级和预测、股息及盈利历史、盈利和股息日历、EOD 价格 K 线、最新成交价、通过股票代码/CUSIP/ISIN/FIGI 查询证券主数据、排行榜、观察列表和提醒。触发词：“fintel”、“fintel.io”、空头利息、逼空数据、借券利率、借券成本、可借股票数量、FTD、未交割证券、卖空成交量、13F 持有人、机构持有人、谁持有 X、内部人买入、内部人卖出、Form 4 交易、分析师目标价、回补天数、空头利息比率。
Fintel-data — 做空数据与机构持仓查询技能
技能概述
Fintel-data 是一个只读的市场情报查询技能，通过 Fintel REST API（或官方 MCP 服务器）查询机构级数据，包括做空比例、借券利率、FTD 未交付、13F 机构持仓、内部人交易和分析师目标价。
适用场景
- 做空分析与挤压信号研究：查询某只股票的 short interest、days to cover、borrow rate、可借股数和 FTD 记录。高借券费用叠加可借股数下降，是经典的挤压观察信号——技能呈现原始数据，结论由你自己判断。
- 机构持仓与内部人尽调：买入前用 13F 数据查看"谁在持有"（SEC 13F 衍生的机构持有人列表），用 Form 3/4/5 数据追踪内部人买入、卖出和期权行权记录。
- 财报季与股息跟踪：批量查询分析师目标价、买卖评级、营收和 EPS 预期，查看历史财报与超预期表现，以及未来财报、股息日历（支持单只股票或全市场窗口查询）。
核心功能
- 独家做空数据集：这是 Fintel 区别于大多数数据商的强项——做空前报告（trailing year）、证券借贷费率与可借股数、每日做空成交量、SEC fails-to-deliver 记录（仅美股），并直接给出 % of float、days to cover 等派生指标。
- SEC 监管文件衍生数据：机构所有权来自 SEC 13F 备案，内部人交易来自 Form 3/4/5，支持按持有人、股数变动、日期整理成表，自动区分买入、卖出与行权。
- 完整的证券与市场数据面：支持按 ticker/CUSIP/ISIN/FIGI 解析证券，提供分析师目标价与评级、盈利预测、EOD 历史价格、最新价格与 52 周高低点、股息与财报历史、各类日历、leaderboards，以及自选列表和提醒查询。
常见问题
使用这个技能需要什么前提条件？
需要一个 Fintel API key（在 fintel.io 按套餐购买）。技能会依次从环境变量 FINTEL_API_KEY、当前目录 .env、git 仓库根目录 .env 中读取。查询按账户计量计费，不要轮询；技能为只读设计，仅调用 GET 端点，不会创建股票列表或订阅提醒。
为什么查询 short interest 会返回 403？
做空利息（short interest）数据集需要在 Fintel 账户中单独开通，403 表示当前 key 没有该数据集的权限，而不是查询写错了。借券利率、做空成交量等数据集也有各自的开通要求。另外 leaderboard 服务偶尔返回 503 not_available，稍后重试即可，不代表没有数据。
它能直接告诉我该买什么、什么时候会挤压吗？
不能。技能的设计原则是只呈现事实和数据——比如做空占流通盘比例、借券费用趋势、内部人买卖方向——不做交易建议、不给目标价、不做挤压预测。所有查询结果都会标注数据来源（Fintel 及其底层的 SEC 13F、Form 3/4/5、NYSE/NASDAQ 做空报告），支持的市场按国家代码寻址（如 us/AAPL），默认美股。