House Trades By ID众议院交易按议员ID查询

该接口按议员唯一识别码精确查询指定美国众议院议员的全部历史证券交易申报记录。相比姓名检索,基于唯一编码查询可彻底规避同名混淆与拼写变体干扰,是构建国会议员持仓跟踪库与量化跟单回测的标准入口。

GEThttps://quote-fmp.com/stable/house-trades-by-id

数据更新周期

该接口暂无固定更新周期(多为按需更新的参考或静态数据)。

接口说明

  • 按唯一编码提取议员历史交易全集:基于议员专属身份标识精确拉取其历年全部财务披露交易记录,完整包含标的证券代码、资产类型、交易类型(买入/卖出/置换)及申报原始文件链接,规避同名拼写歧义。
  • 议员本人与家属账户全口径覆盖:依据美国《停止利用国会知情权交易法》(STOCK Act),议员须同时申报本人、配偶及受抚养子女的证券交易。接口完整返回资产归属人标识与披露金额区间,还原家庭完整投资动向。
  • 议员编码定位与全量交易闭环联动:标准工程流通常先由姓名检索或议员档案接口获取目标人物的唯一识别码,再通过本接口按编码分页拉取全量历史交易并落库维护。
  • 配套投研接口:Latest Senate Financial Disclosures(参议院最新财务披露) · Latest House Financial Disclosures(美国众议院最新财务申报) · Institutional Ownership Filings(机构持股申报) · Company Profile Data(公司概况)

请求参数

3 个参数
参数类型要求示例说明
pagenumber可选0分页页码,从 0 开始,配合每页条数翻页取更多数据(从 0 起算的分页游标;当响应返回空数组 [] 时代表已翻至历史末页)
limitnumber可选100返回结果条数上限,用于控制单次响应大小。
senateIDstring可选P000197参议员的唯一标识,用于国会交易数据。

调用代码示例

Python 关键代码

/stable/house-trades-by-id 端点(众议院交易按议员ID查询)接收可选 page, limit,返回 senateID(参议员 ID)、disclosureDate(披露日期)、transactionDate(交易日期) 等 16 项指标。

Python(核心参数与字段清洗逻辑)
resp = requests.get(
    "https://quote-fmp.com/stable/house-trades-by-id",
    params={"page": 0, "limit": 100, "senateID": "P000197", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 众议院交易按议员ID查询 核心列:symbol, senateID, disclosureDate, transactionDate
df = df[["symbol", "senateID", "disclosureDate", "transactionDate"]].dropna(how="all")

参数使用和避坑

2 组参数组合 · 2 条避坑

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

投研场景Query 参数组合示例返回数据特征与用途
读取众议院交易按议员ID查询最新首屏流(page=0, limit=50)page=0&limit=50请求 /stable/house-trades-by-id 首屏记录,获取最新披露的 senateID、disclosureDate、transactionDate(样本 senateID=M001217)。
递增游标翻页回填众议院交易按议员ID查询(page=1, limit=100)page=1&limit=100向 /stable/house-trades-by-id 传 page=1&limit=100,向历史纵深翻页归档 senateID、disclosureDate、transactionDate 等 16 列。
时序与查询边界从 /stable/house-trades-by-id 拉取 senateID:DataFrame 判空与索引安全

从 /stable/house-trades-by-id 采集众议院交易按议员ID查询(可选 page, limit)后,可获得 senateID(样本 M001217)及 disclosureDate(披露日期);生产脚本中切勿对空 DataFrame 直接按列名索引。

落库主键与口径/stable/house-trades-by-id 幂等写入:(symbol, senateID, transactionDate) 唯一键与 senateID 原始字符保留

处理 /stable/house-trades-by-id 下发的众议院交易按议员ID查询记录时,以 (symbol, senateID, transactionDate) 作为 Upsert 冲突键,同时核对 senateID(M001217)的编码格式。

返回数据

16 个字段

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

字段类型示例值说明
symbolstring"MNST"证券代码
senateIDstring"M001217"参议员 ID
disclosureDatestring"2026-07-27"披露日期
transactionDatestring"2026-06-17"交易日期
firstNamestring"Jared"名
lastNamestring"Moskowitz"姓
officestring"Jared Moskowitz"办公地点
districtstring"FL23"选区
ownerstring""持有人
assetDescriptionstring"Monster Beverage Corp (2)"资产描述
assetTypestring"Stock"资产类型
typestring"Purchase"类型(如买入/卖出)
amountstring"$1,001 - $15,000"金额区间
capitalGainsOver200USDstring"False"是否取得 200 美元以上资本利得
commentstring""备注/说明
linkstring"https://disclosures-clerk.hous…"详情链接
查看响应数据示例(原始 JSON)
[
{
"symbol": "MNST",
"senateID": "M001217",
"disclosureDate": "2026-07-27",
"transactionDate": "2026-06-17",
"firstName": "Jared",
"lastName": "Moskowitz",
"office": "Jared Moskowitz",
"district": "FL23",
"owner": "",
"assetDescription": "Monster Beverage Corp (2)",
"assetType": "Stock",
"type": "Purchase",
"amount": "$1,001 - $15,000",
"capitalGainsOver200USD": "False",
"comment": "",
"link": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034963.pdf"
}
]

常见问题解答(FAQ)

2 个问题
众议院交易按议员ID查询和 参议院交易动态 属于同一模块,两者的查询键与核心产出字段如何区分?

区分方式很简单:需要 senateID(参议员 ID)和 disclosureDate(披露日期)这 16 项字段时请求 /stable/house-trades-by-id(可选 page, limit);需要 Senate Trading Activity(参议院交易动态) 的 16 项字段时请求 /stable/senate-trades(必填 symbol)。

在设计众议院交易按议员ID查询(/stable/house-trades-by-id)的数据拉取管道时,怎样避免单次请求跨度过大或遗漏?

实盘中推荐通过 page 与 limit 游标组合遍历 /stable/house-trades-by-id 历史记录;通过规范化参数边界,可让 /stable/house-trades-by-id 稳定产出 senateID(参议员 ID)等核心业务指标。

同模块相关接口对比

Symbol

本接口路径 /stable/house-trades-by-id,无必填参数。 同一模块「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记录众议院议员及其配偶的股票买卖活动,出售、购买、持仓归属、交易金额等明细,实时更新
众议院交易按议员姓名查询House Trades By Name/stable/house-trades-by-name按美国众议院议员姓名关键词检索其依法申报的个人及家属证券交易明细

Senate(美国国会交易)全部接口目录 →

需要稳定访问 众议院交易按议员ID查询 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月