Senate Trades By Name参议员交易按姓名检索

Q: 投研选型时，什么场景用参议员交易按姓名检索（/stable/senate-trades-by-name），什么场景改用 参议院交易动态？

当您需要 senateID（参议员 ID，如 M000934）与 disclosureDate（披露日期）时调 参议员交易按姓名检索（/stable/senate-trades-by-name，必填 name）；反之若侧重 Senate Trading Activity（参议院交易动态） 的维度，则请求 /stable/senate-trades（必填 symbol）。

该接口按议员姓名检索美国参议员的美股交易记录，适用于美国国会议员财务披露跟踪、政策关联交易研究与另类事件因子回测。

GEThttps://quote-fmp.com/stable/senate-trades-by-name?name=Jerry

数据更新周期

N/A · 不适用固定周期

接口说明

返回字段与按股票检索一致：symbol、senateID、disclosureDate、transactionDate、firstName / lastName、office、district、owner、assetDescription、assetType、买入/卖出。
披露日与交易日区分（disclosureDate ≠ transactionDate）：前者是公开披露日，后者是实际交易日，串联 disclosureDate（披露日期）与 transactionDate（交易日期）等返回指标，便于搭建按日或按季刷新的自动化投研看板。
覆盖参众两院：只要参议院时按 office 过滤，基于美国国会 STOCK Act 法定财务披露跟踪参众两院议员的股票买卖申报。
关联数据线接口：Senate Positions（参议员任职记录） · Senate Net Worth（参议员净资产明细） · Stock Price and Volume Data（日线完整行情） · Latest Insider Trading（最新内部人交易）

请求参数

1 个参数

参数	类型	要求	示例	说明
`name`	string	必填	`Jerry`	公司或证券名称关键词，用于按名称检索。

调用代码示例

Python 关键代码

在 Python 中调用参议员交易按姓名检索（/stable/senate-trades-by-name，必填 name），可提取 senateID（参议员 ID）、disclosureDate（披露日期）、transactionDate（交易日期）（senateID=M000934）。

Python（核心参数与字段清洗逻辑）

resp = requests.get(
    "https://quote-fmp.com/stable/senate-trades-by-name",
    params={"name": "Jerry", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 参议员交易按姓名检索 核心列：symbol, senateID, disclosureDate, transactionDate
df = df[["symbol", "senateID", "disclosureDate", "transactionDate"]].dropna(how="all")

参数使用和避坑

2 组参数组合 · 2 条避坑

以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：

投研场景	Query 参数组合示例	返回数据特征与用途
按关键词「Jerry」检索参议员交易按姓名检索	`name=Jerry`	向 /stable/senate-trades-by-name 传入 name=Jerry，返回匹配的 senateID、disclosureDate、transactionDate（样本 senateID=M000934）。
切换检索词「Microsoft」查询参议员交易按姓名检索	`name=Microsoft`	将 name 设为 Microsoft 调用 /stable/senate-trades-by-name，获取对应实体的 senateID、disclosureDate、transactionDate 等 16 列信息。

时序与查询边界同步 /stable/senate-trades-by-name：滑窗边界去重与 senateID（参议员 ID）清洗

使用 /stable/senate-trades-by-name 同步参议员交易按姓名检索（必填 name）时，senateID（参议员 ID）与 disclosureDate（披露日期）为关键业务列；多次拉取或增量合并时请在边界处按主键去重。

落库主键与口径清洗 /stable/senate-trades-by-name：按 (symbol, senateID, transactionDate) Upsert 并处理 senateID 空串

对参议员交易按姓名检索（/stable/senate-trades-by-name）执行增量 ETL 时，通过 (symbol, senateID, transactionDate) 唯一约束幂等写入，并对 senateID（参议员 ID）做非空与字符集清洗。

返回数据

16 个字段

本接口示例响应共包含 16 个字段（数值型 0 个，文本/日期/布尔型 16 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。

字段	类型	示例值	说明
`symbol`	string	`""`	证券代码
`senateID`	string	`"M000934"`	参议员 ID
`disclosureDate`	string	`"2026-07-21"`	披露日期
`transactionDate`	string	`"2026-06-23"`	交易日期
`firstName`	string	`"Jerry"`	名
`lastName`	string	`"Moran"`	姓
`office`	string	`"Jerry Moran"`	办公地点
`district`	string	`"KS"`	选区
`owner`	string	`"Self"`	持有人
`assetDescription`	string	`"Berkshire Hathaway Inc"`	资产描述
`assetType`	string	`"Stock"`	资产类型
`type`	string	`"Purchase"`	类型（如买入/卖出）
`amount`	string	`"$15,001 - $50,000"`	金额区间
`capitalGainsOver200USD`	string	`"False"`	是否取得 200 美元以上资本利得
`comment`	string	`""`	备注/说明
`link`	string	`"https://efdsearch.senate.gov/s…"`	详情链接

查看响应数据示例（原始 JSON）

[
{
"symbol": "",
"senateID": "M000934",
"disclosureDate": "2026-07-21",
"transactionDate": "2026-06-23",
"firstName": "Jerry",
"lastName": "Moran",
"office": "Jerry Moran",
"district": "KS",
"owner": "Self",
"assetDescription": "Berkshire Hathaway Inc",
"assetType": "Stock",
"type": "Purchase",
"amount": "$15,001 - $50,000",
"capitalGainsOver200USD": "False",
"comment": "",
"link": "https://efdsearch.senate.gov/search/view/ptr/cff197e2-b90b-4b53-b97d-eecf226a1980/"
}
]

常见问题解答（FAQ）

2 个问题

投研选型时，什么场景用参议员交易按姓名检索（/stable/senate-trades-by-name），什么场景改用参议院交易动态？

当您需要 senateID（参议员 ID，如 M000934）与 disclosureDate（披露日期）时调参议员交易按姓名检索（/stable/senate-trades-by-name，必填 name）；反之若侧重 Senate Trading Activity（参议院交易动态）的维度，则请求 /stable/senate-trades（必填 symbol）。

在脚本里循环或定时请求 /stable/senate-trades-by-name（参议员交易按姓名检索）时，有哪些调度细节要注意？

在脚本编排上，建议按 name 过滤条件请求 /stable/senate-trades-by-name 并做非空校验；将每次从 /stable/senate-trades-by-name 拿到的 senateID（参议员 ID）按批次追加至本地历史表。

同模块相关接口对比

Symbol

本接口路径 /stable/senate-trades-by-name，必填参数 name。同一模块「Symbol」下共 6 个接口，下表列出其余 5 个，按粒度与查询维度对比，避免选错接口。

接口	路径	核心差异与适用场景
参议院交易动态Senate Trading Activity	`/stable/senate-trades`	监控美国参议员的交易活动，可获取参议员交易的详细信息，包括交易日期、资产、金额及潜在利益冲突
参议员交易按 ID 检索Senate Trades By ID	`/stable/senate-trades-by-id`	按参议员的参议院 ID 查询其美股交易记录
美国众议院交易记录U.S. House Trades	`/stable/house-trades`	记录众议院议员及其配偶的股票买卖活动，出售、购买、持仓归属、交易金额等明细，实时更新
众议院交易按议员姓名查询House Trades By Name	`/stable/house-trades-by-name`	按美国众议院议员姓名关键词检索其依法申报的个人及家属证券交易明细
众议院交易按议员ID查询House Trades By ID	`/stable/house-trades-by-id`	按议员唯一识别码精确查询指定美国众议院议员的全部历史证券交易申报记录

Senate（美国国会交易）全部接口目录 →

需要稳定访问参议员交易按姓名检索数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 1 个月