TradeStar Insider

Insider 买入信号

逐字段对照原始申报文件，核实任何美国 SEC 申报声明。 这里的每个数字——股数、价格、金额、百分比、持股规模——都能追溯到真实 EDGAR 申报文件中的解析字段，并附有指向 sec.gov 上该文件的链接。无法关联到申报文件的记录都会被剔除，绝不猜测：没有评分，也没有无来源的数据。我们称之为经申报文件核实。我们还通过 4 项预注册的封闭测试，检验了一个显而易见的问题：内幕人士买入能否预测回报？我尝试了 4 次证明并非如此，数据 4 次都给出了否定答案；完整记录见 https://www.tradestarinsider.com/what-we-tested。本仓库提供 TradeStar Insider API 的 MIT 许可 MCP 服务、客户端库和完整示例，详情请见 TradeStar Insider。

• 网站： https://www.tradestarinsider.com
• MCP 服务（Streamable HTTP，无需身份验证）： https://mcp.tradestarinsider.com/mcp
• REST（OpenAPI 3.0.2）： https://api.tradestarinsider.com/v1/openapi.json
• 实时状态： https://status.tradestarinsider.com
• 测试内容（负面结果）： https://www.tradestarinsider.com/what-we-tested
• GitHub： https://github.com/TradestarV5/insider-signals
• PyPI： https://pypi.org/project/insider-signals-mcp/
• npm： https://www.npmjs.com/package/insider-signals-mcp
• Hugging Face 数据集： https://huggingface.co/datasets/tradestarinsider/insider-signals-form4
• Kaggle 数据集： https://www.kaggle.com/datasets/tradestarinsider/insider-signals-form4
• RapidAPI： https://rapidapi.com/tradestarinsider-tradestarinsider-default/api/insider-buy-signals1

免费版与付费版

每个套餐的数据都相同。每条记录都经过申报文件核实，并链接到 sec.gov 上的来源文件。套餐的区别在于历史数据、调用量和导出功能：

	免费版	付费版 — $29/月
调用次数	100 / 天	100,000 / 月
历史数据	最近 30 天	截至 2024-01-02 的全部历史数据 + 导出
核实任意申报文件（两个套餐均免费）	全部历史数据	全部历史数据

免费套餐提供最近 30 天的申报文件。较早的申报文件不会被隐藏：请求较早日期时，系统会告知你该申报文件确实存在，但需要付费套餐才能查看；绝不会声称该文件不存在。verify_* 工具可免费核实全部历史数据中的任意申报文件。RapidAPI 付费套餐每月 $29：每月 100,000 次调用、2024 年以来的全部历史数据，以及通过 /v1/mcp-key 获取的付费 MCP 端点密钥。

（在 RapidAPI 上，免费 Basic 套餐每天可调用 100 次；如果控制台仅允许设置月度配额，则每月为 3,000 次。）

有两种免费接入方式，各有自己的限额：开放、无需密钥的端点（mcp.tradestarinsider.com/mcp 和 /public/v1）对每个 IP 地址每天限制 100 次数据调用，并在 00:00 UTC 重置；超出限额时会返回普通提示信息（MCP 中为工具结果，REST 中为 HTTP 429），绝不会返回传输错误。MCP 握手和 verify_* 核查均会按预期运行（握手免费；一次核查计为一次调用）。RapidAPI Basic 按密钥计量，每天同样限额为 100 次调用。两种方式都提供相同的 30 天免费数据范围。

查看完整价格并获取密钥：https://www.tradestarinsider.com/pricing

在本地运行 MCP 服务

此服务以 insider-signals-mcp 发布，是一个轻量级 stdio 代理，用于连接远程端点。 你可以使用 uvx 运行，无需安装：

uvx insider-signals-mcp

要将其接入 Claude Desktop，请将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "insider-signals": {
      "command": "uvx",
      "args": ["insider-signals-mcp"]
    }
  }
}

或者让任意 MCP 客户端直接连接远程端点（无需代理）： https://mcp.tradestarinsider.com/mcp（Streamable HTTP，无需身份验证）。核实工具是核心功能：根据来源申报文件核查内幕人士买入、激进投资者的 13D 持股、8-K 事件或 13F 持仓。

数据是什么

来自 SEC EDGAR 的五类经申报文件核实的数据（以及来自 USAspending 的联邦合同授予记录）：

• 内部人士 Form 4 买入（SEC 交易代码 P）——集合买入（两名或更多内部人士在七个日历日或更短时间内买入同一家公司）和相对于内部人士现有持股规模较大的买入。
• 激进投资者 Schedule 13D 持股、13F 基金持仓变动和近期联邦合同授予记录。

代码 P 本身不能证明是公开市场买入。 以 P 代码申报的买入可能是 IPO／发行／私募配售，因此每条买入记录都带有 offering_context 标志（true = 配售，而非公开市场买入），每个买入集合都带有 uniform_price_cluster 标志，用于标记按统一价格执行的交易。期权行权、10b5-1 计划销售和低于阈值的噪声数据（低于 $50,000）都会被剔除。我们返回的每个字段都解析自真实申报文件，并附有其 sec.gov 链接。无法关联到申报文件的记录一律剔除，绝不猜测。没有评分，也没有无来源的数据。 我们称之为经申报文件核实的数据。

数据不是什么

它不是预测。 我们针对内部人士买入是否先于价格变动，基于自有历史数据进行了四项预注册、封存测试，结果均为 NULL——没有可与基准率区分的收益优势——因此我们不会声称存在这种优势。每项测试的完整记录（问题、方法、样本、数量和结论）均公开于我们测试过的内容。这是一个基于公开买入记录、经申报文件核实的简洁查询与验证层——这些记录意味着什么，由你来判断。它也不是实时数据：数据每天在工作日通过 cron 导入一次，因此新申报文件会在下一个工作日出现，而非实时更新。

覆盖范围

• 内部人士 Form 4 买入：完整历史记录 2024-01-02 → 2026-10-09（686 个美国交易日），无非节假日缺口（总统日等市场假日没有申报文件，因此不算缺口）。随时可在 /v1/health 查看实时数量——这是权威数据来源，并会在每个工作日更新。每条已提供的买入记录都是经申报文件核实的 P 代码买入，绝非臆测为公开市场买入：无法追溯至已解析的 SEC 申报字段的记录一律剔除，绝不推断。
• **完整性：**我们捕获了窗口期内 93.70% 的 P 代码买入（下限为 87.28%）；在跳过的申报文件中，最终证实确实遗漏的买入仅占 0.75%（95% CI 0.34–1.63%）——其余都是销售、期权行权、修正文件，以及按设计排除的低于 $50k 的买入。（此召回率数据来自一项封存的预注册研究，覆盖 20 个交易日，时间为 2026-08-17 → 2026-09-14；详见我们测试过的内容。)

安装

pip install insider-signals        # or, from a clone:  pip install -e .

零运行时依赖——客户端仅使用 Python 标准库。

快速开始（免费，无需密钥）

免费层可在公开发现接口上免密钥调用，并按 IP 限流：

from insider_signals import InsiderSignals

api = InsiderSignals()                         # public base URL, no key

print(api.health()["datasets"]["insider"])     # coverage days + date range

for s in api.today():                          # today's filing-verified buys
    print(s["ticker"], s["value_usd"], s["filing_url"])

for s in api.clusters():                       # cluster buys (2+ insiders, ≤7 days)
    print(s["ticker"], s["cluster_insiders"], s["cluster_notional"])

# Verify a specific claim against the filings we hold:
v = api.verify("ETRA", "ORBIMED ADVISORS LLC")
print(v["status"], v["count"])                 # -> confirmed 2

可参阅 examples/rest_api.py 获取可运行版本。

免费层与密钥层

层级	方法	访问方式
免费（无需密钥）	health、today、clusters、verify、verify_13d、verify_8k、verify_13f	开放 /public/v1，按 IP 限流
密钥层（RapidAPI）	by_ticker、by_range、filing、fund_changes、federal_awards_recent、activist_stakes_recent、amendments_recent	通过 RapidAPI 按量计费

如需使用密钥层，请在 RapidAPI 订阅，并使用你的密钥创建客户端：

api = InsiderSignals(base_url="https://<your-rapidapi-host>", rapidapi_key="...")
for s in api.by_ticker("GME"):
    print(s["insider"], s["shares"], s["price_per_share"], s["filing_url"])

不带密钥调用密钥层方法会引发 InsiderSignalsError，且 status == 403。

实例 — 每个工具各一个真实请求和响应

以下每条响应均来自实时公开 API 的真实抓取，使用 免费套餐（无需密钥）。 两个免费列表工具（today、clusters）于 2026-10-21 重新抓取，其 coverage_* 字段显示免费套餐的 30 天窗口——免费用户看到的正是这些内容。verify_* 示例来自更早的抓取（2026-09-23）；所有套餐的验证都覆盖完整历史，因此其 coverage_* 字段反映的是抓取日期，而不会受 30 天窗口限制。实时覆盖窗口每天都会变动——请读取 /v1/health 获取当前范围。

today — 今日内幕人士买入

GET https://api.tradestarinsider.com/public/v1/signals/today

{
  "api_version": "v1",
  "endpoint": "signals/today",
  "rule2_guarantee": "Every record traces to a parsed SEC filing field and carries its source filing_url. Records without a filing link are dropped upstream and never returned.",
  "count": 0,
  "coverage_start": "2026-09-22", "coverage_end": "2026-10-20",
  "coverage_note": "Insider (Form-4 code P) signals collected 2026-09-22..2026-10-20. An empty result means no matching filing in this window — not absence at the SEC.",
  "total_matched": 0,
  "params": { "date": "2026-10-21", "limit": 25 },
  "signals": []
}

（盘前或非交易日出现空结果集是正常的；有新申报时会立即填充。）

clusters — 集中买入（2 名或更多内幕人士、同一发行人、≤7 天）

GET https://api.tradestarinsider.com/public/v1/signals/clusters

{
  "api_version": "v1",
  "endpoint": "signals/clusters",
  "count": 1,
  "coverage_start": "2026-09-22", "coverage_end": "2026-10-20",
  "coverage_note": "Insider (Form-4 code P) signals collected 2026-09-22..2026-10-20. An empty result means no matching filing in this window — not absence at the SEC.",
  "total_matched": 177,
  "params": { "limit": 1 },
  "signals": [
    {
      "filed_date": "2026-10-19",
      "ticker": "APLD",
      "issuer_name": "Applied Digital Corp.",
      "issuer_cik": "0001144879",
      "insider": "Jason Zhang",
      "relationship": { "director": false, "officer": true, "ten_pct_owner": false, "officer_title": "President" },
      "code": "P",
      "shares": 300000.0, "price_per_share": 18.86, "value_usd": 5658000.0,
      "transaction_date": "2026-10-16", "acceptance_datetime": "2026-10-19T07:06:33-04:00",
      "cluster": true, "cluster_insiders": 2, "cluster_notional": 6664686.12,
      "offering_context": false, "uniform_price_cluster": false,
      "accession": "0001900445-26-000006",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1900445/000190044526000006/0001900445-26-000006-index.htm"
    }
  ]
}

verify — 验证内幕人士代码 P 的买入声明

GET https://api.tradestarinsider.com/public/v1/verify?ticker=ETRA&person=ORBIMED ADVISORS LLC

{
  "api_version": "v1",
  "endpoint": "verify",
  "coverage_start": "2026-01-20", "coverage_end": "2026-09-23",
  "coverage_note": "Checked SEC Form-4 code P purchases collected 2026-01-20..2026-09-23. Absence here means not in this window — not absence at the SEC.",
  "status": "confirmed",
  "matched": ["ticker/issuer", "person"],
  "filings": [
    {
      "ticker": "ETRA", "issuer_name": "Electra Therapeutics, Inc.",
      "insider": "ORBIMED ADVISORS LLC",
      "code": "P", "shares": 1000000.0, "price_per_share": 15.0, "value_usd": 15000000.0,
      "filed_date": "2026-09-23", "accession": "0000947871-26-000880",
      "transaction_date": "2026-09-19",
      "acceptance_datetime": "2026-09-23T18:04:11-04:00",
      "aff10b5One": 0,
      "is_amendment": false,
      "original_accession": null,
      "filing_url": "https://www.sec.gov/Archives/edgar/data/2088082/000094787126000880/0000947871-26-000880-index.htm"
    }
  ],
  "count": 2,
  "message": "Confirmed: 2 matching Form-4 code P purchase filing(s)."
}

没有匹配申报的声明会返回 "status": "not_found"（在覆盖窗口内）或 "out_of_coverage"（超出已收集日期范围）——绝不会猜测。

买入记录字段。 每份已确认的买入申报——无论通过 verify （按声明查询）还是通过 accession 获取——都带有相同的四个额外字段，因此 无论记录通过哪种方式获取，使用者看到的结构都一致：

field	meaning
transaction_date	报告的交易日期（Form 4 periodOfReport），与 filed_date 不同；申报中没有可解析的日期时为 null。
acceptance_datetime	EDGAR 接受时间戳（SEC 接受申报的时间），采用带时区偏移的 ISO-8601 格式；采集时尚未记录此时间戳的记录为 null。
aff10b5One	从 Form 4 解析出的 10b5-1 交易计划标记（1 = 申报人确认采用 10b5-1 计划，0 = 未确认）；原始申报字段不可用时为 null。
is_amendment / original_accession	对于 Form 4/A，is_amendment 为 true；若被修正的原始申报位于我们的采集窗口内，original_accession 会关联到该原始申报（SEC Form 4/A 不包含原生指针，因此关联依据为发行人 + 报告所有者 + 期间），否则为 null。

任何无法解析的字段都会设为 null，并且在该记录的 partial_fields 对象中说明原因（字段 → 原因）——缺失值绝不会不作说明。所有字段均已解析的记录会完全省略 partial_fields。示例：

"partial_fields": { "acceptance_datetime": "row collected before the acceptance stamp was captured" }

Form 4/A 修订申报。 内幕人士提交 Form 4/A 更正先前的 Form 4 时，verify 会将修订后的申报作为当前记录返回——不会将已被取代的 原始申报作为同等记录一并返回。如果你的声明引用了被修订更改的数据， 验证结果会附带一个 superseded 对象，其中列出 original_accession、amendment_accession 和更正后的数据，并在消息中说明该数据已被 4/A 更正。带密钥的 amendments_recent （GET /v1/amendments/recent）会按时间倒序列出这些修订申报，每条都包含其 original_accession 和一个 changed_fields 映射，说明 4/A 更改的内容（更改前 → 更改后）； 如果原始申报位于我们的采集窗口之外，该修订申报仍会列出，并标记 original_in_corpus: false，更改前后的值则为 null——绝不猜测。

verify_13d — 验证 Schedule 13D 激进投资者持股声明

GET https://api.tradestarinsider.com/public/v1/verify/13d?subject_name=New Fortress Energy Inc.&filer_name=Strategic Value Partners, LLC

{
  "endpoint": "verify/13d",
  "coverage_start": "2026-06-22", "coverage_end": "2026-09-18",
  "status": "confirmed",
  "filings": [
    {
      "filed_date": "2026-09-18", "form_type": "SCHEDULE 13D",
      "subject_name": "New Fortress Energy Inc.", "subject_tickers": ["NFE", "NFEGP"],
      "filer_name": "Strategic Value Partners, LLC",
      "percent_of_class": 14.7, "aggregate_amount_owned": 19208710.0,
      "signal": "new_13d_bare", "stated_intent": "New 13D. No activist purpose stated.",
      "accession": "0001193125-26-395888",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1749723/0001193125-26-395888.txt"
    }
  ],
  "count": 1,
  "message": "Confirmed: 1 matching Schedule 13D/13D-A filing(s)."
}

verify_8k — 验证 8-K 重大事件声明

GET https://api.tradestarinsider.com/public/v1/verify/8k?cik=1650648&company_name=4D Molecular Therapeutics, Inc.

{
  "endpoint": "verify/8k",
  "coverage_start": "2025-03-06", "coverage_end": "2026-09-22",
  "status": "confirmed",
  "filings": [
    {
      "cik": "1650648", "company_name": "4D Molecular Therapeutics, Inc.",
      "accession": "0001193125-26-277563",
      "filing_date": "2026-06-22", "event_date": "2026-06-17", "form": "8-K",
      "items": [{ "code": "5.07", "label": "Submission of Matters to a Vote of Security Holders" }],
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1650648/000119312526277563/"
    }
  ],
  "count": 4,
  "message": "Confirmed: 4 matching 8-K filing(s) carrying the claimed item(s)."
}

verify_13f — 验证 13F 机构持仓声明

GET https://api.tradestarinsider.com/public/v1/verify/13f?filer=BERKSHIRE HATHAWAY INC&issuer_name=ALPHABET INC&quarter=2026-06-30

{
  "endpoint": "verify/13f",
  "coverage_start": "2024-06-30", "coverage_end": "2026-06-30",
  "coverage_note": "Values are AS-OF quarter-end and up to ~45 days stale.",
  "status": "held",
  "filings": [
    {
      "filer_name": "BERKSHIRE HATHAWAY INC",
      "as_of_quarter_end": "2026-06-30", "filed_date": "2026-08-14", "lag_days": 45,
      "change": "added", "issuer_name": "ALPHABET INC", "title_of_class": "CAP STK CL A",
      "value_usd": 28157599351, "prior_value_usd": 15600071913, "ssh_prnamt": 78791167,
      "accession": "0001193125-26-352200",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1067983/000119312526352200/"
    }
  ],
  "count": 2,
  "message": "Held: 2 matching 13F position(s) reported as of the covered quarter."
}

响应结构

所有数据路由都返回相同的封装结构；行数据位于 signals 下，而客户端的 列表返回方法会直接返回该列表。verify* 方法会返回完整封装结构（你需要其中的 status 和 matched/filings 字段）。

列表控制

每个列表路由（today、clusters、ticker、range、amendments/recent）都接受相同的可选查询参数。响应会在 params 下回显你设置的参数，并始终报告 total_matched，因此你可以通过分页获取数据，而不会遇到不提示的数量上限。

参数	含义
limit	返回的最大行数（默认为 25，按最新优先）；limit<=0 表示不设上限。
offset	本页之前要跳过的行数（用于分页）。
days	仅保留最近 N 天内提交的行（相对于今天）。
ticker	不区分大小写的精确股票代码筛选条件。
as_of	按发布时间边界回放。 UTC ISO-8601 时刻（或仅包含日期的 YYYY-MM-DD，按 UTC 当日结束时间读取）。仅返回在该时刻或之前已越过我们的发布边界的行——也就是客户端在过去那个时刻能看到的完整动态。

每条列表行都带有 first_served_at，即该行首次越过我们发布边界（使其公开的原子写入操作）的 UTC ISO-8601 时刻。每个摄取批次仅写入一次，之后不会改写，因此可作为 as_of 回放及衡量发布延迟的稳定基准。对于在此字段存在之前生成的行，该字段为 null，并会在 partial_fields 中说明（此类行会保留在 as_of 查询结果中，因为它们在该字段出现前就已公开）。as_of 与 days 配合使用：days 限定提交日期，as_of 限定提供时间。

MCP 服务（适用于 AI 助手）

让 AI 客户端（Claude 和其他 MCP 客户端）直接查询这些信号。开放、免费，按 IP 限速——无需 API 密钥或 OAuth：

claude mcp add --transport http insider-signals https://mcp.tradestarinsider.com/mcp

然后可以询问：“显示今天的内幕买入信号”，或 “本周有内幕集群买入吗？附上文件链接。” 请参阅 examples/mcp_client.md，了解工具列表和编程式 SDK 示例。

定价

RapidAPI 是结账平台。提供两个套餐：Basic（免费）和一个每月 29 美元的套餐，每月包含 100,000 次调用，并可访问自 2024 年以来的完整历史记录。订阅后，调用 /v1/mcp-key 获取密钥和两个带密钥的 URL——该密钥也可解锁付费 MCP 端点。

设有硬性限制，不提供超额用量——超过上限的请求会返回 429，直至窗口重置。免费发现入口和 MCP 服务开放使用，并按 IP 限速；计量式 API 计费通过 RapidAPI 进行。

免责声明

这些信息不构成投资建议。每个数据均解析自 SEC 公开文件，并链接到 sec.gov 上的来源。内幕买入并不能保证任何结果——内幕人士也常常会判断失误——但代码 P 的购买是真金白银投入。

许可证

MIT。变更日志：CHANGELOG.md。