免费内部人交易 API 真正需要完成什么
用户通常需要的是把公司内部人公开持股申报转换为 JSON 的开发接口。Form 3 用于在申报义务开始时披露内部人的初始持有；Form 4 报告受益所有权变化；Form 5 则是适用交易或持仓的年度申报。即使产品主要筛选近期 Form 4，一套完整流程也可能需要同时处理三种表单及其修订。
申报只能证明某项持股事件被报告，并不能自动解释为“看多买入”或“看空卖出”。必须结合交易代码、取得或处置标记、证券类型、直接或间接持有、衍生证券条款、脚注和交易后持仓共同判断。授予、期权行权、代扣税、赠与、账户间转移以及交易计划下的交易都会改变股数，不能与自主公开市场买卖简单归为一类。
本文的“内部人交易数据”指高管、董事及特定持股人的合法公开披露，不是未公开内幕信息，也不是投资建议。
SEC Form 4 数据接口应返回哪些内容
可靠接口应在保留来源申报的同时，标准化发行人、申报人、身份关系、非衍生与衍生证券表、交易、持有形式、交易后持仓、脚注和修订状态。还应保存申报编号、文件链接、首次提交日和供应商采集时间，使每条标准化事件都能回查权威记录。
| 字段组 | 示例 | 作用 |
|---|---|---|
| 发行人 | Ticker, CIK, company name | 公司查询与数据关联 |
| 申报人 | Name, CIK, officer/director status | 按身份筛选 |
| 交易 | Date, deemed date, code, voluntary flag, shares, price, acquired/disposed | 区分市场交易、授予、行权、赠与、税务及其他事件 |
| 持有方式 | Direct/indirect, nature of indirect ownership, holdings after transaction | 避免重复统计实体、信托、家庭或受控账户持仓 |
| 衍生证券 | Exercise price, exercisable and expiration dates, underlying title and amount | 把期权、认股权证和可转换证券与普通股分开解释 |
| 申报语境 | Form type, amendment, 10b5-1 indicator, footnotes, joint filing | 保留解释信息与申报版本链 |
| 来源 | Accession, filedAt, source URL | 审计与时效验证 |
内部人交易 API 数据有多及时？
SEC 说明 Form 4 通常在交易后两个工作日内提交。API 的时效只能从文件公开后开始计算。应分别记录交易日、存在时的视同执行日、SEC 提交时间、修订时间和供应商采集时间；所谓“实时内部人数据”最多表示披露后的处理延迟较低，并不代表交易发生时即可获知。
获取 SEC 内部人交易数据的三种路线
应根据应用需要权威原始文件、标准化记录，还是可在多个供应商之间选择的调用能力来确定路线。三者并不冲突：产品可用标准化 API 提升开发效率，同时保留 EDGAR 链接和申报编号，供用户回查。
| 路线 | 适用场景 | 主要工程工作 |
|---|---|---|
| SEC EDGAR 原始文件 | 权威证据、批量研究、自定义分类与独立核验。 | 遵守 SEC 访问规范，发现申报、解析持股 XML、解析发行人与申报人、处理修订并保存来源版本。 |
| 标准化供应商 API | 需要快速取得 JSON 的看板、提醒、公司页面与原型。 | 核对表单与历史覆盖、代码保真度、脚注、修订、分页、延迟、免费限制和许可。Alpha Vantage 与 Finnhub 均有内部人交易能力文档，但应以当前套餐权限为准。 |
| 能力发现与调用层 | 需要在路由调用前检查输入输出契约的 Agent 与多数据源应用。 | 保留供应商身份和证据，只标准化有文档定义的字段，并对每个路由来源执行同一套验收测试。 |
判断实例：股数增减本身不能直接代表买入或卖出
假设三条记录都会增加某位高管的申报股数。交易代码为 P、标记为取得、存在现金成交价且证券为非衍生普通股时，可以作为公开市场买入候选；代码 M 可能表示期权行权，需要结合衍生证券表、行权价、对应普通股数量及同日处置记录判断；代码 A 可能是授予，而不是自主买入。三种情况下持仓变化都是真实的，但经济事件及其含义完全不同。
卖出记录同样需要语境。代扣税而减少的股份、赠与、受控实体之间的转移，以及标记为依据 Rule 10b5-1 交易安排执行的出售，都应与临时决定的公开市场处置区分开。脚注还可能说明加权平均成交价、多笔执行、通过信托持有或字段留空的原因。若接口把这些信息压平成单一“买入/卖出”标签，虽然更容易展示，却更不利于可靠解读。
让输出契合具体产品
输出交易代码、证券类型、价格状态、持有形式、10b5-1 标记、申报时间和来源链接，并在分类规则通过后再提醒。
按申报和申报人组织交易，展示修订与脚注，不要把授予、行权、买入和卖出简单合并为一个数字。
保留历史时点申报版本、稳定 CIK 关联、退市发行人、原始 XML 和可复现的分类逻辑。
在标准化事件之外返回置信度、未纳入的语境、来源申报编号，并说明公开披露不构成投资建议。
如何选择免费美股内部人交易 API
确认接口是否覆盖完整 Form 4、修订文件、衍生证券交易和源链接，而不只是被筛选出的公开市场买入。
记录每日或每月请求数、历史深度、速率限制、是否需要 API Key、是否要求信用卡以及商业使用条款。
验证 ticker 与 CIK 的关联，并区分买入代码 P、卖出代码 S、授予、行权、间接持有与修订文件。
在构建自动化前，抽取多条记录，将股数、价格、持有类型、提交时间与 accession number 同 SEC EDGAR 核对。
测试样本应包括修订、联合申报、间接持有、加权平均成交价、衍生证券行权、价格为空、多笔交易和 10b5-1 标记，以判断接口是在保留语义，还是仅仅把表格压平。
提醒分类应依据正式交易代码、取得或处置标记、证券表和脚注语境。遇到陌生组合应进入人工复核队列，不能强行把每条记录归成“买入”或“卖出”。
用 Python 获取美股内部人交易数据
实际端点与鉴权方式取决于所选服务。客户端应保持可配置，检查 HTTP 状态和响应结构，并保留源文件标识符。
最小 REST 请求模式
import os
import requests
url = os.environ["INSIDER_API_URL"]
headers = {"Authorization": f"Bearer {os.environ['INSIDER_API_KEY']}"}
params = {"ticker": "AAPL", "transaction_code": "P", "limit": 25}
response = requests.get(url, headers=headers, params=params, timeout=20)
response.raise_for_status()
records = response.json()
for item in records.get("data", records):
print(item.get("ticker"), item.get("transactionDate"),
item.get("shares"), item.get("accessionNumber"))自动化前的生产检查
- 按照供应商结束标记遍历全部分页，不能假设一次响应已经包含所有申报人、交易、表格和脚注。
- 不可变地保存原始 XML 或来源响应，再按申报编号、申报人、证券表、交易身份和修订版本建立标准化记录键。
- 把修订作为带版本的更正处理，不能简单追加，也不能无依据删除原申报。
- 在生成易读分类前，保留交易代码、自愿交易标记、取得或处置状态、直接或间接持有、衍生证券条款和脚注引用。
- 对价格为空或为零、加权平均价、赠与、授予、行权、代扣税和间接转移分别处理。
- 遇到 429 时退避重试，缓存稳定来源版本，并把来源到供应商的处理延迟与交易到申报的延迟分开衡量。
用 QVeris 在调用前检查 API 能力
QVeris 帮助 Agent 在执行前发现并检查可调用的金融数据能力。可通过 QVeris tool details 区分原始持股申报、标准化 Form 4 交易、按发行人查询的活动和申报人历史。调用前应检查表单覆盖、标识与日期参数、交易代码字段、衍生证券与脚注支持、修订、来源链接、分页、限额和供应商条款；能力路由不能替代对申报含义的判断。
FAQ
有免费的内部人交易 API 吗？
有。SEC EDGAR 免费公开源文件，一些服务商提供免费层或无需密钥的端点。正式使用前要核对当前限额和条款。
如何从 SEC 获取内部人交易数据？
可从 EDGAR 下载并解析 Form 4 XML，也可使用把文件规范化为 JSON 且保留来源引用的 SEC 内部人申报 API。
Form 4 API 包含哪些字段？
常见字段包括发行人、申报人、身份、证券、交易日期和代码、股数、价格、买入或处置标记、持仓及文件来源。
需要 API Key 或信用卡吗？
取决于服务商。无需密钥的端点便于测试，免费计划则可能要求注册。应把鉴权与账单要求纳入选择标准。
Form 4 中所有“取得”都代表内部人买入股票吗？
不是。授予、期权行权、转换、赠与、转移等事件都可能增加申报持仓。必须结合交易代码、证券表、取得或处置标记、价格和脚注判断。
为什么 Form 4 的价格会为空或与市场价格不同？
部分事件不涉及现金，可能使用行权价或转换价，也可能以脚注说明的加权平均价申报。空值不等于零，一个展示价格也可能汇总多笔成交。
如何处理 Form 4 修订申报？
应把原申报与修订归入同一版本链，比较被更正的申报人、交易、持仓和脚注，并发布带版本的当前状态，同时保留此前公开内容。