House Trades By Name众议院交易按议员姓名查询

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

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

该接口支持按美国众议院议员姓名关键词检索其依法申报的个人及家属证券交易明细。适用于仅知晓议员英文姓名或姓氏、快速排查特定国会政治人物近期买卖个股动向与潜在政策关联交易的投研场景。

GEThttps://quote-fmp.com/stable/house-trades-by-name?name=James

数据更新周期

N/A · 不适用固定周期

接口说明

按议员姓名检索国会交易申报：支持传入美国众议院议员姓名或姓氏片段（name），定向调取其名下依法披露的股票、期权及基金买卖流水，涵盖披露日期（disclosureDate）、实际交易日（transactionDate）、交易方向与金额区间。
模糊匹配与编码定位：支持按姓氏或名字片段模糊查询，返回结果中同步包含每位议员的唯一身份识别码、所属州与选区信息，便于在初步探索后锁定精确编码并转入自动化归档流水线。
国会交易跟踪与披露时滞分析：记录完整保留实际交易发生日与法定公开披露日，量化团队可据此测算众议院重点委员会成员从下单到向公众亮牌的披露时滞分布及披露日后的超额收益表现。
关联数据线接口：Senate Positions（参议员任职记录） · Senate Net Worth（参议员净资产明细） · Stock Price and Volume Data（日线完整行情） · Latest Insider Trading（最新内部人交易）

请求参数

1 个参数

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

调用代码示例

Python 关键代码

在 Python 中调用众议院交易按议员姓名查询（/stable/house-trades-by-name，必填 name），可提取 senateID（参议员 ID）、disclosureDate（披露日期）、transactionDate（交易日期）（senateID=H001047）。

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

resp = requests.get(
    "https://quote-fmp.com/stable/house-trades-by-name",
    params={"name": "James", "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 参数组合示例	返回数据特征与用途
按关键词「James」检索众议院交易按议员姓名查询	`name=James`	向 /stable/house-trades-by-name 传入 name=James，返回匹配的 senateID、disclosureDate、transactionDate（样本 senateID=H001047）。
切换检索词「Microsoft」查询众议院交易按议员姓名查询	`name=Microsoft`	将 name 设为 Microsoft 调用 /stable/house-trades-by-name，获取对应实体的 senateID、disclosureDate、transactionDate 等 16 列信息。

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

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

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

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

返回数据

16 个字段

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

字段	类型	示例值	说明
`symbol`	string	`"BAC"`	证券代码
`senateID`	string	`"H001047"`	参议员 ID
`disclosureDate`	string	`"2026-07-21"`	披露日期
`transactionDate`	string	`"2026-07-20"`	交易日期
`firstName`	string	`"James A."`	名
`lastName`	string	`"Himes"`	姓
`office`	string	`"James A. Himes"`	办公地点
`district`	string	`"CT04"`	选区
`owner`	string	`"Joint"`	持有人
`assetDescription`	string	`"Bank of America Corp"`	资产描述
`assetType`	string	`"Stock"`	资产类型
`type`	string	`"Sale"`	类型（如买入/卖出）
`amount`	string	`"$1,001 - $15,000"`	金额区间
`capitalGainsOver200USD`	string	`"False"`	是否取得 200 美元以上资本利得
`comment`	string	`""`	备注/说明
`link`	string	`"https://disclosures-clerk.hous…"`	详情链接

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

[
{
"symbol": "BAC",
"senateID": "H001047",
"disclosureDate": "2026-07-21",
"transactionDate": "2026-07-20",
"firstName": "James A.",
"lastName": "Himes",
"office": "James A. Himes",
"district": "CT04",
"owner": "Joint",
"assetDescription": "Bank of America Corp",
"assetType": "Stock",
"type": "Sale",
"amount": "$1,001 - $15,000",
"capitalGainsOver200USD": "False",
"comment": "",
"link": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20035047.pdf"
}
]

常见问题解答（FAQ）

2 个问题

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

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

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

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

同模块相关接口对比

Symbol

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

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

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

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

免费试用 1 个月