Free Insider Trading API
for SEC Form 4 Data免费内部人交易 API
获取 SEC Form 4 数据
Find, evaluate, and implement a free insider trading API for SEC Forms 3, 4, and 5 while preserving transaction codes, ownership paths, filing versions, and source evidence.
查找、评估并接入覆盖 SEC Forms 3、4、5 的免费内部人交易 API，同时保留交易代码、持有路径、申报版本和来源证据。
What a free insider trading API actually needs to do免费内部人交易 API 真正需要完成什么
A developer-ready API turns public corporate-insider ownership filings into usable JSON without discarding the filing context. Form 3 establishes an insider’s reported ownership when the reporting obligation begins, Form 4 reports changes in beneficial ownership, and Form 5 is an annual statement for transactions or holdings reportable there. A complete workflow may need all three forms and their amendments, even when the product’s main filter is recent Form 4 activity.
用户通常需要的是把公司内部人公开持股申报转换为 JSON 的开发接口。Form 3 用于在申报义务开始时披露内部人的初始持有；Form 4 报告受益所有权变化；Form 5 则是适用交易或持仓的年度申报。即使产品主要筛选近期 Form 4，一套完整流程也可能需要同时处理三种表单及其修订。
A filing is evidence of a reported ownership event, not a self-explanatory “bullish buy” or “bearish sell.” Transaction code, acquired/disposed flag, security type, direct or indirect ownership, derivative terms, footnotes, and post-transaction holdings must be read together. Grants, option exercises, tax withholding, gifts, transfers, and transactions under a trading plan can produce share changes that should not be grouped blindly with discretionary open-market purchases or sales.
申报只能证明某项持股事件被报告，并不能自动解释为“看多买入”或“看空卖出”。必须结合交易代码、取得或处置标记、证券类型、直接或间接持有、衍生证券条款、脚注和交易后持仓共同判断。授予、期权行权、代扣税、赠与、账户间转移以及交易计划下的交易都会改变股数，不能与自主公开市场买卖简单归为一类。
“Insider trading data” here means lawful public disclosures by officers, directors, and certain beneficial owners. It is not nonpublic information or a trading recommendation.
本文的“内部人交易数据”指高管、董事及特定持股人的合法公开披露，不是未公开内幕信息，也不是投资建议。
What an SEC Form 4 API should returnSEC Form 4 数据接口应返回哪些内容
A useful API preserves the source filing while normalizing issuer, reporting owner, relationship, non-derivative and derivative tables, transaction, ownership form, post-transaction holdings, footnotes, and amendment state. Always retain accession number, filing URL, original filing date, and provider ingestion time so each normalized event can be verified against the authoritative record.
可靠接口应在保留来源申报的同时，标准化发行人、申报人、身份关系、非衍生与衍生证券表、交易、持有形式、交易后持仓、脚注和修订状态。还应保存申报编号、文件链接、首次提交日和供应商采集时间，使每条标准化事件都能回查权威记录。
| Field group字段组 | Examples示例 | Why it matters作用 |
|---|---|---|
| Issuer发行人 | Ticker, CIK, company name | Company lookup and joins公司查询与数据关联 |
| Reporting owner申报人 | Name, CIK, officer/director status | Role-aware filtering按身份筛选 |
| Transaction交易 | Date, deemed date, code, voluntary flag, shares, price, acquired/disposed | Separate market trades, awards, exercises, gifts, tax and other events区分市场交易、授予、行权、赠与、税务及其他事件 |
| Ownership持有方式 | Direct/indirect, nature of indirect ownership, holdings after transaction | Avoid double-counting entities, trusts, family and controlled holdings避免重复统计实体、信托、家庭或受控账户持仓 |
| Derivative security衍生证券 | Exercise price, exercisable and expiration dates, underlying title and amount | Interpret options, warrants and convertibles separately from common stock把期权、认股权证和可转换证券与普通股分开解释 |
| Filing context申报语境 | Form type, amendment, 10b5-1 indicator, footnotes, joint filing | Preserve explanation and filing lineage保留解释信息与申报版本链 |
| Provenance来源 | Accession, filedAt, source URL | Audit and freshness checks审计与时效验证 |
How current is insider trading API data?内部人交易 API 数据有多及时？
The SEC explains that Form 4 is generally filed within two business days of the transaction. API freshness begins only after publication. Track transaction date, deemed execution date when present, SEC filing time, amendment time, and provider ingestion time separately; “real-time insider data” can only describe low processing delay after disclosure, not instantaneous knowledge of the underlying transaction.
SEC 说明 Form 4 通常在交易后两个工作日内提交。API 的时效只能从文件公开后开始计算。应分别记录交易日、存在时的视同执行日、SEC 提交时间、修订时间和供应商采集时间；所谓“实时内部人数据”最多表示披露后的处理延迟较低，并不代表交易发生时即可获知。
Three ways to obtain SEC insider transaction data获取 SEC 内部人交易数据的三种路线
The best route depends on whether the application needs authoritative source documents, normalized records, or a callable capability that can switch among providers. These layers can complement each other: use a normalized API for product speed, but retain an EDGAR link and accession number for verification.
应根据应用需要权威原始文件、标准化记录，还是可在多个供应商之间选择的调用能力来确定路线。三者并不冲突：产品可用标准化 API 提升开发效率，同时保留 EDGAR 链接和申报编号，供用户回查。
| Route路线 | Best fit适用场景 | Main engineering work主要工程工作 |
|---|---|---|
| SEC EDGAR source filesSEC EDGAR 原始文件 | Authoritative evidence, bulk research, custom classification, and independent verification.权威证据、批量研究、自定义分类与独立核验。 | Follow SEC access guidance, discover filings, parse ownership XML, resolve issuers and owners, process amendments, and preserve source versions.遵守 SEC 访问规范，发现申报、解析持股 XML、解析发行人与申报人、处理修订并保存来源版本。 |
| Normalized provider API标准化供应商 API | Dashboards, alerts, issuer pages, and prototypes that need JSON quickly.需要快速取得 JSON 的看板、提醒、公司页面与原型。 | Verify form and history coverage, code fidelity, footnotes, amendments, pagination, latency, free limits, and licensing. Alpha Vantage and Finnhub document insider-transaction capabilities, but current plan access must be checked.核对表单与历史覆盖、代码保真度、脚注、修订、分页、延迟、免费限制和许可。Alpha Vantage 与 Finnhub 均有内部人交易能力文档，但应以当前套餐权限为准。 |
| Capability discovery layer能力发现与调用层 | Agents and multi-source applications that need to inspect an input/output contract before routing a call.需要在路由调用前检查输入输出契约的 Agent 与多数据源应用。 | Keep provider identity and evidence visible, normalize only documented fields, and apply the same acceptance tests to every routed source.保留供应商身份和证据，只标准化有文档定义的字段，并对每个路由来源执行同一套验收测试。 |
Worked classification: share count alone is not a buy or sell signal判断实例：股数增减本身不能直接代表买入或卖出
Consider three records that all increase an officer's reported shares. A transaction with code P, an acquired indicator, a cash price, and non-derivative common stock is a candidate open-market purchase. Code M may represent an option exercise and should be paired with the derivative table, exercise price, underlying shares, and any same-day disposal. Code A may represent a grant or award rather than a discretionary purchase. The change in holdings is real in each case, but the economic event and its interpretation differ.
假设三条记录都会增加某位高管的申报股数。交易代码为 P、标记为取得、存在现金成交价且证券为非衍生普通股时，可以作为公开市场买入候选；代码 M 可能表示期权行权，需要结合衍生证券表、行权价、对应普通股数量及同日处置记录判断；代码 A 可能是授予，而不是自主买入。三种情况下持仓变化都是真实的，但经济事件及其含义完全不同。
A sale record also needs context. Shares withheld for taxes, gifts, transfers among controlled entities, and a sale marked under a Rule 10b5-1 trading arrangement should remain distinguishable from an unplanned open-market disposition. Footnotes may explain weighted-average prices, multiple executions, ownership through a trust, or why a value is blank. If those details are flattened into a single “buy/sell” label, the API has made the data easier to display but less reliable to interpret.
卖出记录同样需要语境。代扣税而减少的股份、赠与、受控实体之间的转移，以及标记为依据 Rule 10b5-1 交易安排执行的出售，都应与临时决定的公开市场处置区分开。脚注还可能说明加权平均成交价、多笔执行、通过信托持有或字段留空的原因。若接口把这些信息压平成单一“买入/卖出”标签，虽然更容易展示，却更不利于可靠解读。
Match the output to the product让输出契合具体产品
Include code, security type, price status, ownership form, 10b5-1 indicator, filing time, and a source link. Alert only after classification rules pass.
Group transactions by filing and owner, show amendments and footnotes, and avoid summing grants, exercises, purchases, and sales into one number.
Keep point-in-time filing versions, stable CIK joins, delisted issuers, raw XML, and reproducible classification logic.
Return the normalized event together with confidence, excluded context, source accession, and a warning that disclosure is not investment advice.
输出交易代码、证券类型、价格状态、持有形式、10b5-1 标记、申报时间和来源链接，并在分类规则通过后再提醒。
按申报和申报人组织交易，展示修订与脚注，不要把授予、行权、买入和卖出简单合并为一个数字。
保留历史时点申报版本、稳定 CIK 关联、退市发行人、原始 XML 和可复现的分类逻辑。
在标准化事件之外返回置信度、未纳入的语境、来源申报编号，并说明公开披露不构成投资建议。
How to choose a free insider trading API如何选择免费美股内部人交易 API
Check whether the stock insider trading API covers all Form 4 filings, amendments, derivative transactions, and source links—not only highlighted open-market buys.确认接口是否覆盖完整 Form 4、修订文件、衍生证券交易和源链接，而不只是被筛选出的公开市场买入。
Record requests per day or month, historical depth, rate limits, required API key, credit-card requirement, and permitted commercial use.记录每日或每月请求数、历史深度、速率限制、是否需要 API Key、是否要求信用卡以及商业使用条款。
Verify ticker-to-CIK joins and distinguish purchase code P, sale code S, grants, exercises, indirect ownership, and amended filings.验证 ticker 与 CIK 的关联，并区分买入代码 P、卖出代码 S、授予、行权、间接持有与修订文件。
Select several records and reconcile shares, price, ownership type, filing time, and accession number against SEC EDGAR before building automation.在构建自动化前，抽取多条记录，将股数、价格、持有类型、提交时间与 accession number 同 SEC EDGAR 核对。
Include an amendment, joint filing, indirect holding, weighted-average price, derivative exercise, null price, multiple transactions, and a 10b5-1 indicator. These reveal whether the API preserves meaning or merely flattens rows.测试样本应包括修订、联合申报、间接持有、加权平均成交价、衍生证券行权、价格为空、多笔交易和 10b5-1 标记，以判断接口是在保留语义，还是仅仅把表格压平。
Build categories from documented transaction code, acquired/disposed status, security table, and footnote context. Keep a review queue for unfamiliar combinations instead of forcing every row into “buy” or “sell.”提醒分类应依据正式交易代码、取得或处置标记、证券表和脚注语境。遇到陌生组合应进入人工复核队列，不能强行把每条记录归成“买入”或“卖出”。
Insider trading API Python implementation用 Python 获取美股内部人交易数据
The exact endpoint and authentication scheme depend on the selected provider. Keep the client configurable, validate HTTP status and schema, and preserve the source filing identifier.
实际端点与鉴权方式取决于所选服务。客户端应保持可配置，检查 HTTP 状态和响应结构，并保留源文件标识符。
Minimal REST request pattern最小 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"))Production checks before automation自动化前的生产检查
- Paginate until the provider signals completion; do not assume one response contains every owner, transaction, table, or footnote.
- Store raw XML or source response immutably, then key normalized rows by accession, owner, security table, transaction identity, and amendment version.
- Apply amendments as versioned corrections rather than blindly adding or deleting the original filing.
- Preserve transaction code, voluntary flag, acquired/disposed state, direct/indirect ownership, derivative terms, and footnote references before assigning a human-readable category.
- Treat null or zero price, weighted-average price, gifts, grants, exercises, tax withholding, and indirect transfers explicitly.
- Back off on 429 responses, cache stable source versions, and measure source-to-provider ingestion latency separately from transaction-to-filing delay.
- 按照供应商结束标记遍历全部分页，不能假设一次响应已经包含所有申报人、交易、表格和脚注。
- 不可变地保存原始 XML 或来源响应，再按申报编号、申报人、证券表、交易身份和修订版本建立标准化记录键。
- 把修订作为带版本的更正处理，不能简单追加，也不能无依据删除原申报。
- 在生成易读分类前，保留交易代码、自愿交易标记、取得或处置状态、直接或间接持有、衍生证券条款和脚注引用。
- 对价格为空或为零、加权平均价、赠与、授予、行权、代扣税和间接转移分别处理。
- 遇到 429 时退避重试，缓存稳定来源版本，并把来源到供应商的处理延迟与交易到申报的延迟分开衡量。
Use QVeris to inspect API capabilities before calling用 QVeris 在调用前检查 API 能力
QVeris helps agents discover and inspect callable financial-data capabilities before execution. Use QVeris tool details to distinguish raw ownership filings, normalized Form 4 transactions, issuer activity, and reporting-owner history. Inspect form coverage, identifier and date inputs, transaction-code fields, derivative and footnote support, amendments, source links, pagination, limits, and provider terms before calling; capability routing does not replace filing interpretation.
QVeris 帮助 Agent 在执行前发现并检查可调用的金融数据能力。可通过 QVeris tool details 区分原始持股申报、标准化 Form 4 交易、按发行人查询的活动和申报人历史。调用前应检查表单覆盖、标识与日期参数、交易代码字段、衍生证券与脚注支持、修订、来源链接、分页、限额和供应商条款；能力路由不能替代对申报含义的判断。
FAQ
Is there a free insider trading API?有免费的内部人交易 API 吗？
Yes. SEC EDGAR provides the underlying public filings without charge, and some providers expose free tiers or no-key endpoints. Verify current limits and terms before committing.有。SEC EDGAR 免费公开源文件，一些服务商提供免费层或无需密钥的端点。正式使用前要核对当前限额和条款。
How do I get insider trading data from the SEC?如何从 SEC 获取内部人交易数据？
Download and parse Form 4 XML from EDGAR, or use a SEC insider filings API that converts filings into normalized JSON while retaining source references.可从 EDGAR 下载并解析 Form 4 XML，也可使用把文件规范化为 JSON 且保留来源引用的 SEC 内部人申报 API。
What data is included in a Form 4 API?Form 4 API 包含哪些字段？
Typical fields cover issuer, reporting owner, role, security, transaction date and code, shares, price, acquired/disposed status, holdings, and filing provenance.常见字段包括发行人、申报人、身份、证券、交易日期和代码、股数、价格、买入或处置标记、持仓及文件来源。
Do I need an API key or credit card?需要 API Key 或信用卡吗？
It depends on the provider. A no-key endpoint is convenient for testing, while free plans may require registration. Treat authentication and billing requirements as comparison criteria.取决于服务商。无需密钥的端点便于测试，免费计划则可能要求注册。应把鉴权与账单要求纳入选择标准。
Does every Form 4 acquisition mean an insider bought stock?Form 4 中所有“取得”都代表内部人买入股票吗？
No. Awards, option exercises, conversions, gifts, transfers, and other events can increase reported holdings. Use the transaction code, security table, acquired/disposed flag, price, and footnotes.不是。授予、期权行权、转换、赠与、转移等事件都可能增加申报持仓。必须结合交易代码、证券表、取得或处置标记、价格和脚注判断。
Why can a Form 4 price be blank or differ from the market?为什么 Form 4 的价格会为空或与市场价格不同？
Some events are non-cash, use an exercise or conversion price, or report a weighted-average price explained in a footnote. Null is not automatically zero, and one displayed price may summarize multiple executions.部分事件不涉及现金，可能使用行权价或转换价，也可能以脚注说明的加权平均价申报。空值不等于零，一个展示价格也可能汇总多笔成交。
How should amended Form 4 filings be handled?如何处理 Form 4 修订申报？
Keep the original and amendment under one filing lineage, compare corrected owners, transactions, holdings, and footnotes, and publish a versioned current state without erasing what was previously public.应把原申报与修订归入同一版本链，比较被更正的申报人、交易、持仓和脚注，并发布带版本的当前状态，同时保留此前公开内容。