Search Insider Trades内部人交易检索
该接口支持按公司或股票代码查询内部人交易:可查到公司高管、董事等内部人的具体交易,包括交易日期、类型、金额和角色信息。
https://quote-fmp.com/stable/insider-trading/search?page=0&limit=100数据更新周期
2 Minutes
接口说明
- 按公司检索:输入股票代码或公司名称即可检索相关的内部人交易记录,调用后可覆盖
transactionDate(交易日期)、reportingCik(申报主体CIK编号)与companyCik(公司主体CIK编号) 等高频字段,适合定时批量归档至本地数据库。 - 交易明细:获取交易类型(买入或卖出)、交易证券数量、成交价格等详细数据,基于 SEC Form 3/4/5 披露追踪上市公司管理层与大股东的真实增减持行为。
- 内部人角色:了解交易涉及的内部人身份,如董事或高管,数据仓库建模时可将本接口与「内部人交易按申报人检索」归入同一主题域按周期同步。
- 上下游关联接口:Latest Insider Trading(最新内部人交易) · All Insider Transaction Types(内部人交易类型清单) · Institutional Ownership Filings(机构持股申报) · SEC Filings By Symbol(按代码查 SEC 申报)
请求参数
6 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 可选 | AAPL | 美国 SEC 监管申报或美股上市公司股票代码,例如 AAPL、MSFT、NVDA(仅覆盖美股及在美上市 ADR,无需附加交易所后缀)。 |
page | number | 可选 | 0 | 分页页码,从 0 开始,配合每页条数翻页取更多数据(从 0 起算的分页游标;当响应返回空数组 [] 时代表已翻至历史末页) |
limit | number | 可选 | 100 | 返回结果条数上限,用于控制单次响应大小。 |
reportingCik | string | 可选 | 0001496686 | 申报主体的 CIK 编号。 |
companyCik | string | 可选 | 0000320193 | 公司主体的 CIK 编号。 |
transactionType | string | 可选 | S-Sale | 交易类型,用于内部人/机构交易筛选。 |
调用代码示例
Python 关键代码内部人交易检索路径为 /stable/insider-trading/search(可选 symbol, page),响应 JSON 展开 transactionDate(交易日期)、reportingCik(申报主体 CIK 编号)、companyCik(公司主体 CIK 编号) 共 16 列。
resp = requests.get(
"https://quote-fmp.com/stable/insider-trading/search",
params={"symbol": "AAPL", "page": 0, "limit": 100, "reportingCik": "0001496686", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 filingDate 升序重排并数值化 securitiesOwned(持有证券数量)
df["securitiesOwned"] = pd.to_numeric(df["securitiesOwned"], errors="coerce")
df = df.sort_values("filingDate").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入 symbol=AAPL 请求内部人交易检索 | symbol=AAPL | 调用 /stable/insider-trading/search 拉取 AAPL 的内部人交易检索,输出 transactionDate、reportingCik、companyCik 等 16 项标准化属性。 |
| 设置返回条数上限(limit=100)回溯 AAPL 内部人交易检索 | symbol=AAPL&page=0&limit=100 | 通过条数上限参数请求 /stable/insider-trading/search,单次拉回 AAPL 更长历史周期的 transactionDate、reportingCik、companyCik。 |
| 切换美股龙头 NVDA 对比内部人交易检索 | symbol=NVDA | 改用 symbol=NVDA 调用 /stable/insider-trading/search,提取 NVDA 的 transactionDate、reportingCik、companyCik 与 AAPL 横向对标。 |
调用 /stable/insider-trading/search 拉取内部人交易检索(可选 symbol, page)时,若条件未命中会返回 [];读取 transactionDate(2026-07-28)与 reportingCik 前须先判断 not df.empty。
/stable/insider-trading/search 的首条样本含 securitiesOwned=62959;日常增量任务按 (symbol, filingDate, transactionDate) 合并即可保持本地库与上游一致。
返回数据
16 个字段本接口示例响应共包含 16 个字段(数值型 3 个,文本/日期/布尔型 13 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "TRMK" | 证券代码 |
filingDate | string | "2026-07-30" | 申报日期(监管申报日期;若同表含 acceptedDate,实盘事件对齐应优先取 acceptedDate) |
transactionDate | string | "2026-07-28" | 交易日期 |
reportingCik | string | "0001661867" | 申报主体 CIK 编号 |
companyCik | string | "0000036146" | 公司主体 CIK 编号 |
transactionType | string | "A-Award" | 交易类型 |
securitiesOwned | number | 62959 | 持有证券数量 |
reportingName | string | "Tate Granville Jr" | 申报主体名称 |
typeOfOwner | string | "officer: Secretary" | 持有人类型(高管/董事/大股东) |
acquisitionOrDisposition | string | "A" | 买入或卖出(A=买入,D=卖出) |
directOrIndirect | string | "D" | 直接或间接持有 |
formType | string | "4" | SEC 申报表单类型(如 10-K、10-Q、8-K、4、13F) |
securitiesTransacted | number | 1608 | 交易证券数量 |
price | number | 0 | 最新价 |
securityName | string | "Common Stock" | 证券名称 |
url | string | "https://www.sec.gov/Archives/e…" | 链接地址 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "TRMK",
"filingDate": "2026-07-30",
"transactionDate": "2026-07-28",
"reportingCik": "0001661867",
"companyCik": "0000036146",
"transactionType": "A-Award",
"securitiesOwned": 62959,
"reportingName": "Tate Granville Jr",
"typeOfOwner": "officer: Secretary",
"acquisitionOrDisposition": "A",
"directOrIndirect": "D",
"formType": "4",
"securitiesTransacted": 1608,
"price": 0,
"securityName": "Common Stock",
"url": "https://www.sec.gov/Archives/edgar/data/36146/000003614626000087/0000036146-26-000087-index.htm"
}
]常见问题解答(FAQ)
2 个问题内部人交易检索(/stable/insider-trading/search)产出的 transactionDate 等字段,与 内部人交易按申报人检索 的返回内容有何侧重?
内部人交易检索(端点 /stable/insider-trading/search,可选 symbol, page)返回 transactionDate(交易日期)及 reportingCik(0001661867)共 16 列;若业务需要 Search Insider Trades by Reporting Name(内部人交易按申报人检索),可改调 /stable/insider-trading/reporting-name(必填 name)。
工程团队在封装 /stable/insider-trading/search(内部人交易检索)客户端时,应采用怎样的拉取逻辑?
标准流程是递增 page(配合 limit)翻页请求 /stable/insider-trading/search 直至返回 [];在拿到 内部人交易检索 的 transactionDate 与 reportingCik 后,及时释放内存中的原始文本流。
同模块相关接口对比
Search本接口路径 /stable/insider-trading/search,无必填参数。 同一模块「Search」下共 2 个接口,下表列出其余 1 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 内部人交易按申报人检索Search Insider Trades by Reporting Name | /stable/insider-trading/reporting-name | 按申报人姓名查询内部人交易活动,跟踪特定个人或机构在公司内部人交易中的动向 |