免费美股公司内部人交易数据 API 数据流程：从 SEC EDGAR 获取 Form 4，将董事、高管及持股 10% 以上股东的交易标准化为 JSON，按 ticker 筛选并供应用或 AI Agent 使用

免费美股公司内部人交易数据 API 应满足哪些需求

本页面向需要标准化交易事件流的应用，例如发行人时间线、申报人历史、公开市场买入筛选、卖出提醒、薪酬事件分离和事件聚类。正确的最小记录单位是申报中的交易行，而不是文件标题。一份 Form 4 可能包含多个申报人、多条非衍生或衍生证券记录，脚注还可能改变价格或持有路径的含义。

高质量接口既要支持发现，也要支持重建。发现筛选应覆盖股票代码、发行人 CIK、申报人 CIK、身份、表单、交易代码、证券类型、取得或处置状态，以及交易日或提交日范围；重建字段则应保留申报编号、行身份、修订链、直接或间接持有、事件后持仓、衍生证券条款、脚注引用和来源时间。

覆盖 Form 4 申报

覆盖董事、高管及持有某一注册证券类别 10% 以上的受益所有人所申报的交易，并保留 SEC 原始申报链接。

支持 ticker 与 CIK 查询

既能按 ticker 方便查询，也保留发行人和申报人的 CIK，便于核对身份与来源。

标准化事件身份

返回申报与行身份、表单与修订、交易代码、证券表、日期、股数、价格、持有路径、事件后持仓和来源。

可核实的免费方案

核对调用额度、历史范围、数据延迟、修订处理、使用许可和缓存条件，并确认“免费”是长期套餐还是试用。

SEC Form 4 API 的字段、交易代码与申报时点

Form 4 用于披露适用公司内部人的受益所有权变化，并按照适用期限在应申报事件后提交。交易接口应把交易日和视同执行日同 SEC 接收时间、供应商处理时间分开。任何“最新”排序都必须说明采用的是哪一个时间。

按 ticker 或发行人 CIK 查询公司内部人交易

股票代码便于应用查询，但发行人 CIK 才是更稳定的 SEC 身份。应测试代码变更、多种股份类别、联合申报、申报人别名、分页稳定性、交易日与提交日筛选，并确认每条结果都提供申报编号、行身份、原文链接和映射来源。按股票代码筛选时，也不能丢掉同一申报中没有直接 ticker 的衍生证券记录。

正确解释 P、S、授予、行权与修订申报

P 通常表示买入，S 通常表示卖出，但 Form 4 还会披露授予、期权行权、赠与、代扣税、转换和其他变化。仅看代码仍不够，还应保留自愿交易标记、取得或处置方向、价格与脚注、证券表、对应标的股数、直接或间接持有、交易后余额以及 Form 4/A 版本链。遇到陌生组合，应标记为“需要复核”，而不是编造市场信号。

Form 3、Form 4、Form 5 与交易代码的真实含义

内部人数据产品不能把每份持股申报都标成买入或卖出。Form 3 通常用于申报人开始承担报告义务时披露初始持股；Form 4 披露之后发生的多类持股变化；Form 5 则可能按较晚的年度时点补报部分事项。构建统一时间线前，应保留表单类型、修订状态、报告期间与来源交易行。

代码或表单	常见含义	还要检查什么	不可靠的简化
Form 3	初始受益所有权申报。	申报人身份、证券与直接或间接持有路径。	把期初持股当成新买入。
P / S	公开市场或私下买入/卖出，仍需结合申报细节。	价格、脚注、自愿交易标记、证券与持有方式。	认为所有 P 或 S 都出于同一种动机。
M	衍生证券的行权或转换。	衍生证券表、行权价、到期日与对应标的股数。	把取得的普通股称为公开市场买入。
F	用证券支付行权成本或税款。	相关授予或行权行、代扣规则与脚注。	把每笔处置都当成主动看空卖出。
G	证券赠与。	取得或处置方向、受赠关系与持有路径。	把零价或空价解释成价值为零的成交。
Form 5	部分可按年度较晚申报的交易。	财年、交易日、豁免情况及此前是否已申报。	把文件到达日当作交易发生日。

计算示例：一份申报可以同时包含三种经济含义。

某高管可能以代码 M 行权取得 20,000 股，再以代码 F 交付 7,000 股用于缴税，并以代码 S 出售 3,000 股。申报中的交易行合计涉及 30,000 个单位，但它绝不是一笔卖出 30,000 股的交易。该高管取得 20,000 股标的股票，并通过两种不同机制处置 10,000 股；若不考虑其他交易行，净持股可能增加 10,000 股。系统应保留每一行的证券表、代码、价格、持有方式和交易后余额，只有经济含义一致时才允许汇总。

如何评估免费的 SEC Form 4 API

检查项	需要核对	重要原因
覆盖范围	发行人、申报人、非衍生与衍生交易、Form 4/A。	避免无提示的数据缺口。
更新速度	SEC 接收时间、服务商处理延迟、轮询或 webhook 机制。	区分申报延迟与行情延迟。
来源追溯	申报编号、原文 URL、发行人 CIK、申报人 CIK 与申报日期。	让每条记录可核查。
标准化	交易代码、单位、持有方式、脚注、修订与重复记录。	避免产生错误的买卖信号。
查询模型	发行人与申报人 ID、表单、代码、身份、证券表、交易与提交日期、稳定游标。	支持提醒与可复现的历史回填。
事件身份	申报编号、申报人、表格、行、证券、交易日与修订链。	避免交易行丢失和重复提醒。
脚注保真	加权价格区间、间接持有、交易计划、转换和税务说明。	让标准化标签可以解释。
免费限制	每日额度、历史范围、限流、许可、缓存与商业使用。	试用未必适合生产环境。

接入返回 JSON 的免费美股公司内部人交易数据 API

应以一条交易行而不是整份申报作为最小事件。下面的通用示例把申报身份、申报人身份、经济方向、持有路径、衍生证券条款和证据分别保存，避免下游系统从标题中猜测这些信息。

{
  "filing": {
    "accession_number": "ACCESSION_PLACEHOLDER",
    "form": "4",
    "accepted_at": "YYYY-MM-DDThh:mm:ss-04:00",
    "source_url": "SEC_FORM_4_URL",
    "amends_accession": null
  },
  "issuer": {"cik": "ISSUER_CIK", "ticker": "TICKER_PLACEHOLDER"},
  "owner": {"cik": "OWNER_CIK", "name": "REPORTING_OWNER", "roles": ["officer"]},
  "transaction": {
    "row_id": "ROW_ID",
    "table": "non_derivative",
    "date": "YYYY-MM-DD",
    "code": "P",
    "acquired_disposed": "A",
    "security_title": "Common stock",
    "shares": "1000",
    "price_per_share": "25.40",
    "ownership_nature": "direct",
    "shares_owned_after": "12500",
    "derivative": null,
    "footnote_ids": ["F1"]
  }
}

空值不等于零，一条申报行也不自动等于交易信号。赠与、授予、转换或其他非现金事件的价格为空可能完全合理。应保留 null，再结合交易代码、所属表格、取得或处置方向、衍生证券条款和脚注解释。把缺失价格转成零，会制造一笔不存在的“零价值交易”。

步骤 1：测试 ticker 与发行人 CIK 查询

使用已知 ticker 和日期范围调用文档化端点，记录鉴权方式、HTTP 状态、分页、限流响应头、最新申报时间以及对应的 SEC 原文链接。

步骤 2：标准化 SEC Form 4 交易字段

将响应映射到稳定字段，例如 issuer_cik、owner_cik、ticker、transaction_date、transaction_code、shares、price、shares_owned_after 和 accession_number，并保留原始响应与申报 URL。

步骤 3：处理修订且不覆盖历史记录

按申报编号保存记录，将 Form 4/A 与原申报关联，并明确修订处理规则。不要静默覆盖旧记录，也不要把所有持股变动都描述成公开市场买入或卖出。

步骤 4：发布带明确类型的交易事件

来源代码与字段应保持不可变，再在独立层中推导公开市场买入、公开市场卖出、授予、行权、税务相关处置、赠与、转移或未解析等分类。应记录分类版本和依据，使规则可以修正而不必改写原始证据。

步骤 5：围绕申报到达与去重建立提醒

应按申报时间轮询或消费供应商更新，并设置重叠窗口，再用稳定事件身份去重。对于重要修订，应发送“更正”提醒，而不是把修订行当成第二笔新交易。

步骤 6：在活动排序前验证分析口径

汇总金额时，应区分真实申报价格与空值、零值、行权价或加权平均价。衍生证券与对应标的股数不能当成相同单位直接相加，多行成交合计还应保留与申报脚注的关联。

用 QVeris 查找公司内部人交易数据能力

QVeris 帮助开发者和 AI Agent 发现并检查可用的金融数据能力。可通过 QVeris 工具详情搜索发行人时间线、申报人历史、Form 4 交易行或更广泛的持股申报，再检查支持的筛选、事件身份、代码与衍生证券字段、修订、脚注、来源链接、分页、历史和供应商条款。供应商特定输出应封装在保留来源语义的事件结构之后。

明确搜索 Form 4 或美股公司内部人交易，不要混入 13F 机构持仓或美国国会议员交易。
检查 ticker 与 CIK 输入、历史范围、修订处理、分页、额度和来源链接。
将服务商特定响应封装在标准化的应用接口之后。

FAQ

有免费的美股公司内部人交易 API 吗？

部分服务商提供 SEC Form 4 数据的免费套餐或公开端点。用于生产前，应核对额度、历史范围、处理延迟、许可、修订处理和来源链接。

SEC 是否提供 Form 4 API？

SEC 提供 EDGAR 申报文件和可下载的 Insider Transactions Data Sets，但这些官方来源并不等同于支持 ticker 查询、返回标准化 JSON 的 REST API。

可以按 ticker 查询公司内部人交易吗？

许多接口支持 ticker 查询。仍应保留发行人 CIK、申报人 CIK 和申报编号，以便核对匹配结果。

Form 4 申报多久可以获得？

多数应申报交易通常需要在第二个工作日结束前提交，API 可用时间还取决于 SEC 接收和服务商处理速度。

Form 4 中的 P 和 S 表示什么？

P 通常表示买入，S 通常表示卖出。其他代码还可能表示授予、行权、赠与、代扣税款等交易类型。

Form 4 数据是实时成交吗？

不是。Form 4 属于监管披露，应同时保留交易时间和申报时间，不能把申报到达时间当作交易所成交时间。

如何汇总 Form 4 中的多条交易行？

只有申报人、证券、代码、方向、日期和经济含义一致时才可归组。必须保留加权平均价脚注，也不能把衍生证券单位与普通股标的股数直接相加。

为什么交易价格有时为空或为零？

该事件可能属于授予、赠与、转移、转换、税务事项或其他非现金交易。应结合代码、衍生证券条款、取得或处置状态和脚注判断，不能把空值解释为零价格成交。

如何避免重复发送内部人交易提醒？

应结合申报编号、申报人、表格、证券和行级交易身份去重，把修订关联到原申报，并发送更正提醒，而不是第二次新交易提醒。

权威参考与下一步

先通过 SEC 官方来源核对 Form 4 的含义和申报时点，再确认第三方 API 当前的免费套餐约定。

SEC Insider Transactions Data Sets SEC Form 4 instructions QVeris documentation QVeris tool details