U.S. House Trades美国众议院交易记录
该接口记录众议院议员及其配偶的股票买卖活动:出售、购买、持仓归属、交易金额等明细,实时更新,用于了解官员的财务决策动向。
https://quote-fmp.com/stable/house-trades?symbol=AAPL数据更新周期
Daily
接口说明
- 监控交易动态:及时了解美国众议院议员及其家属最新的股票交易,传入
symbol后可同步senateID(参议员ID)、disclosureDate(披露日期)与transactionDate(交易日期) 等明细数据,支撑多维度选股与面板回归分析。 - 理解财务动向:通过详细的交易数据洞察政府官员的财务决策,基于美国国会 STOCK Act 法定财务披露跟踪参众两院议员的股票买卖申报。
- 透明与问责:借助数据跟踪美国众议院议员的财务行为,在盘前准备或盘后归档中,常与「众议院交易按议员姓名查询」成对调用以保持底表同步。
- 上下游关联接口:Latest Senate Financial Disclosures(参议院最新财务披露) · Latest House Financial Disclosures(美国众议院最新财务申报) · Institutional Ownership Filings(机构持股申报) · Company Profile Data(公司概况)
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 美国 SEC 监管申报或美股上市公司股票代码,例如 AAPL、MSFT、NVDA(仅覆盖美股及在美上市 ADR,无需附加交易所后缀)。 |
page | number | 可选 | 0 | 分页页码,从 0 开始,配合每页条数翻页取更多数据(从 0 起算的分页游标;当响应返回空数组 [] 时代表已翻至历史末页) |
limit | number | 可选 | 100 | 返回结果条数上限,用于控制单次响应大小。 |
调用代码示例
Python 关键代码从 /stable/house-trades 同步美国众议院交易记录(必填 symbol),一次拿齐 senateID(参议员 ID)、disclosureDate(披露日期)、transactionDate(交易日期)(样本值 senateID=C001120)。
resp = requests.get(
"https://quote-fmp.com/stable/house-trades",
params={"symbol": "AAPL", "page": 0, "limit": 100, "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")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 定向上游请求 AAPL 美国众议院交易记录(symbol=AAPL) | symbol=AAPL | 请求 /stable/house-trades?symbol=AAPL,产出该标的的 senateID、disclosureDate、transactionDate(样本 C001120)等 16 列明细。 |
| 显式指定 limit=100 请求 AAPL 的美国众议院交易记录 | symbol=AAPL&page=0&limit=100 | 针对 AAPL 请求 /stable/house-trades 并附带容量上限参数,提取近百条 senateID、disclosureDate、transactionDate 记录用于长周期回测。 |
| 按 NVDA 代码提取美国众议院交易记录明细 | symbol=NVDA | 指定 symbol=NVDA 查询 /stable/house-trades,输出 senateID、disclosureDate、transactionDate 等 16 项同口径指标。 |
针对 /stable/house-trades(美国众议院交易记录,必填 symbol),返回首行的 senateID 为 C001120、disclosureDate 为 2026-07-17;入库前请先拦截 200 [] 空响应。
持久化 /stable/house-trades(美国众议院交易记录)的 16 个字段时,自然键取 (symbol, senateID, transactionDate);标识列 senateID(样本 C001120)请保持大小写与上游一致。
返回数据
16 个字段本接口示例响应共包含 16 个字段(数值型 0 个,文本/日期/布尔型 16 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
senateID | string | "C001120" | 参议员 ID |
disclosureDate | string | "2026-07-17" | 披露日期 |
transactionDate | string | "2026-06-01" | 交易日期 |
firstName | string | "Dan" | 名 |
lastName | string | "Crenshaw" | 姓 |
office | string | "Dan Crenshaw" | 办公地点 |
district | string | "TX02" | 选区 |
owner | string | "" | 持有人 |
assetDescription | string | "Apple Inc" | 资产描述 |
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": "AAPL",
"senateID": "C001120",
"disclosureDate": "2026-07-17",
"transactionDate": "2026-06-01",
"firstName": "Dan",
"lastName": "Crenshaw",
"office": "Dan Crenshaw",
"district": "TX02",
"owner": "",
"assetDescription": "Apple Inc",
"assetType": "Stock",
"type": "Sale",
"amount": "$1,001 - $15,000",
"capitalGainsOver200USD": "False",
"comment": "",
"link": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20035024.pdf"
}
]常见问题解答(FAQ)
2 个问题在「Symbol」下,美国众议院交易记录(/stable/house-trades)与 参议院交易动态(/stable/senate-trades)如何分工?
美国众议院交易记录(/stable/house-trades,必填 symbol)重在输出 senateID(参议员 ID)与 disclosureDate 等 16 列;而 Senate Trading Activity(参议院交易动态)返回 16 列,两者按查询维度互补。
在批量同步美国众议院交易记录时,/stable/house-trades 的查询窗口与参数组合该如何安排?
推荐做法:递增 page(配合 limit)翻页请求 /stable/house-trades 直至返回 [];当 /stable/house-trades 正常返回含 senateID 的 JSON/CSV 后,即可直接合入本地策略宽表。
同模块相关接口对比
Symbol本接口路径 /stable/house-trades,必填参数 symbol。 同一模块「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 查询其美股交易记录 |
| 众议院交易按议员姓名查询House Trades By Name | /stable/house-trades-by-name | 按美国众议院议员姓名关键词检索其依法申报的个人及家属证券交易明细 |
| 众议院交易按议员ID查询House Trades By ID | /stable/house-trades-by-id | 按议员唯一识别码精确查询指定美国众议院议员的全部历史证券交易申报记录 |