免费 Form 4 API：搜索背后的真实任务
搜索免费 SEC Form 4 API 的开发者通常不只是想看申报列表，而是要把 EDGAR 所有权文件转成可查询记录，支持股票代码或 CIK 筛选，并保留足够的来源信息以审计每条结果。
真正的工程难点是无损标准化。一份申报可能包含多个申报人、身份关系标记、非衍生证券 Table I、衍生证券 Table II、仅持仓行、交易行、编号脚注、联合申报语境、交易计划标记，以及对早期文件的修订。JSON 结构再方便，也必须保证这些关系可以重新还原。
接入方式通常有两种。来源优先的管道自行获取 SEC 提交元数据和所有权 XML，不可变地保存文件并在本地解析；标准化供应商 API 可以减少解析与索引工作，还可能提供 ticker 查询或 webhook，但仍必须暴露申报编号、来源链接、原始值、文件版本和明确的更正规则。
把 Form 4 与 Form 4/A 所有权 XML 标准化为一致的 JSON 字段。
按股票代码、CIK、内部人、申报日期、交易代码或申报编号筛选。
保留申报编号、接收时间、修订记录和 SEC 原文链接。
区分长期免费套餐、试用与测试期，并确认生产使用条件。
SEC Form 4 申报数据 API 的字段、代码与修订
实用的 JSON 接口应保留发行人与申报人 CIK、申报人身份、表单与修订身份、最早交易日和接收时间、证券表与名称、交易日和视同执行日、交易代码与自愿标记、股数、价格、取得或处置状态、直接或间接持有、间接持有性质、交易后持仓、衍生证券条款、标的证券、脚注、申报编号和来源链接。
交易代码 P 与 S 表示什么
代码 P 通常表示公开市场或私下买入，S 表示卖出。不能丢弃其他代码，也不能只凭取得或处置方向推断含义：授予、行权、赠与、转换、到期、税务相关处置和转移都会改变持仓，但经济含义不同。生成展示标签前，必须保留来源代码和脚注。
保留 Table I 与 Table II 的关系
Table I 描述非衍生证券，Table II 描述衍生证券及其对应标的。应保留行权或转换价格、可行权日与到期日、衍生证券单位、标的名称与数量，以及交易后衍生证券持仓。不能把衍生证券单位与标的普通股数量合并，也不能把两者重复计算为同一敞口。
脚注本身就是数据模型的一部分
脚注可能解释加权平均价格与成交区间、通过信托或实体间接持有、归属安排、转换条款、代扣税或交易计划语境。脚注应单独保存，同时保留交易行到脚注的引用，并随标准化事件提供。把脚注压成与具体行无关的文件备注，会破坏可审计性。
准确解释 Rule 10b5‑1 复选框
现行 Form 4 与 Form 5 会要求申报人说明：所报告交易是否依据一项拟满足 Rule 10b5‑1(c) 抗辩条件的合同、指令或书面计划执行，并填写该计划的采纳日期。接口应把复选框和计划采纳日期作为来源字段保存。复选框被勾选，只表示申报人披露了相应计划背景；它本身不能证明所有法律条件一定已经满足，也不代表交易不重要，更不能把一次计划内卖出直接解释为新的主观看空判断。
解读示例：假设某高管申报一笔代码为 S 的交易，直接持有账户卖出 10,000 股，加权平均成交价为 52.40 美元，交易后仍直接持有 90,000 股。关联脚注明确实际成交区间为 52.10–52.75 美元，Rule 10b5‑1 复选框已勾选，并提供计划采纳日期。标准化事件应分别保留卖出代码、处置数量、加权均价及区间脚注、交易后直接持仓和申报人声明的交易计划背景。不能把价格区间虚构成多笔交易，也不能因为主表只有一个均价就丢弃区间信息。
如何处理 Form 4/A 修订申报
保存原始申报和申报编号，把修订记录关联到原记录，并在不覆盖历史的前提下应用更正。应在交易层去重，避免修订申报被重复统计为第二笔交易。
如何评估免费的美股内部人交易 API
| 检查项 | 需要核对 | 缺失风险 |
|---|---|---|
| 免费访问 | 日/月额度、到期规则、是否需信用卡、商业许可。 | 演示套餐可能不能用于生产。 |
| 覆盖范围 | 公司、历史、Form 4/A、衍生与非衍生交易表。 | 无提示的数据缺口会扭曲信号。 |
| 延迟 | 从 EDGAR 接收到 API 或 webhook 送达的实测时间。 | “实时”可能没有明确定义。 |
| 来源 | 申报编号、原文 URL、时间戳、原始标识符。 | 结果无法复核。 |
| 结构保真 | 多申报人、Table I/II、仅持仓行、行与脚注关联、衍生证券与标的关系。 | 结构压平会改变申报含义。 |
| 更正规则 | 原申报与 Form 4/A 版本链、变化字段、当前版本和回放行为。 | 修订可能导致重复或抹去有效历史。 |
| 质量证据 | 申报、申报人、交易行与脚注数量；未解析记录；来源哈希。 | 响应有效仍可能不完整。 |
| 运维 | 分页、重试、限流响应头、状态页、webhook 签名。 | 接入会发生不可预测的失败。 |
用 Python 和 JSON 接入免费 Form 4 API
步骤 1：按股票代码或 CIK 查询 Form 4
先用一家公司和较短日期范围测试。确认鉴权、HTTP 状态、分页、排序、时区、最新申报日期，以及响应返回的是交易明细还是只有申报头。
步骤 2：标准化 Form 4 内部人交易 JSON
应把申报、申报人、证券、交易行、持仓行、衍生证券条款、脚注和来源版本建模为关联实体，而不是一条扁平记录。保留原始 XML 或供应商 JSON 以便回放，同时保存来源文本值；只有在空值和单位规则明确时，才能生成带类型的数值字段。
步骤 3：安全添加 Form 4 webhook 通知
验证 webhook 签名，快速确认接收，再异步处理；使用事件 ID，或申报编号加交易标识实现幂等，并用定期 API 拉取结果与通知事件对账。
步骤 4：把标准化结果与来源 XML 核对
对每个测试样本，应核对申报人数、Table I 与 Table II 行数、仅持仓行、交易行、脚注、修订和来源哈希。样本需覆盖联合持有、加权价格、间接持有、衍生证券、价格为空和同日多笔交易。
步骤 5：对更正进行版本化，同时保留公开历史
把 Form 4/A 关联到原申报链，识别发生变化的申报人、交易行、持仓或脚注，再发布确定性的当前视图。此前公开版本仍应保留，供时点化研究使用，并向下游发送更正事件。
步骤 6：衡量 webhook 完整性与回放能力
应跟踪 SEC 接收到 webhook 送达的延迟、重复率、漏报、修订乱序、重试次数和回放能力。即使 webhook 看起来稳定，也必须定期同来源数据对账。
用 QVeris 发现 Form 4 数据能力
QVeris 帮助开发者和 AI Agent 发现并检查可用能力。可在QVeris 工具详情中搜索原始 SEC 所有权申报、已解析 Form 4 JSON、ticker 查询或 webhook 传递，再检查 XML/JSON 保真、申报人与行身份、Table I/II 支持、脚注、修订、来源链接、筛选、延迟、回放、限额和供应商条款，之后再路由调用。接入概念可参考 QVeris 文档。
FAQ
有免费的 SEC Form 4 API 吗？
部分服务提供长期免费套餐或临时测试，SEC 来源文件本身公开。应核对额度、历史、许可、鉴权、结构保真、修订、来源链接和生产权限。
SEC 是否提供 Form 4 API？
SEC 接口提供提交元数据和公开申报，SEC 也发布内部人交易数据集。开发者仍可能需要在遵守访问规范的前提下获取并解析所有权 XML。
Table I 和 Table II 有什么区别？
Table I 覆盖非衍生证券；Table II 覆盖衍生证券及其行权、到期和标的证券条款。两者应保持分离，同时在同一申报内正确关联。
为什么 Form 4 脚注不可缺少？
脚注可能解释加权价格、间接持有、归属、转换、税务和交易计划语境。接口应保留交易行到脚注的引用，而不只是文件级文本。
Form 4 申报多久可以查询？
它按照适用期限在应申报事件后提交。应把 SEC 接收到 API 或 webhook 送达的延迟，与交易发生到申报的延迟分开衡量。
如何处理 Form 4/A 修订？
把修订关联到原版本链，保留两份原始版本，识别变化的申报人、行和脚注，发布确定性的当前视图，并避免产生重复事件。
怎样测试 Form 4 API？
样本应包含多申报人、两张表、仅持仓行、间接持有、衍生证券、加权价格、空价格、脚注、联合申报和修订，并把数量与来源 XML 核对。
权威参考与下一步
官方访问规则和字段语境应以 SEC EDGAR API 文档、SEC《交易法》规则解释和 SEC 隐私与安全政策为准。供应商文档可解释标准化字段，但不能取代原始申报。