Senate Trades By ID参议员交易按 ID 检索

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

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

数据更新周期

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

接口说明

ID 前缀要分清：示例中交易接口用 S000033、净资产接口用 P000197，两套前缀不要混用；以 senate-profiles 返回的 senateID 为准。
金额是披露区间：统计「交易规模」时只能给区间上下界，不能当成交金额，基于美国国会 STOCK Act 法定财务披露跟踪参众两院议员的股票买卖申报。
标准化数据清洗与跨源对齐：将Senate Trades By ID底层的原始记录清洗为结构统一的 JSON 序列，省去人工抓取与格式规整成本，可直接接入本地投研数据库与自动化流水线。
配套投研接口：Latest Senate Financial Disclosures（参议院最新财务披露） · Latest House Financial Disclosures（美国众议院最新财务申报） · Institutional Ownership Filings（机构持股申报） · Company Profile Data（公司概况）

请求参数

3 个参数

参数	类型	要求	示例	说明
`page`	number	可选	`0`	分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页）
`limit`	number	可选	`100`	返回结果条数上限，用于控制单次响应大小。
`senateID`	string	可选	`S000033`	参议员的唯一标识，用于国会交易数据。

调用代码示例

Python 关键代码

/stable/senate-trades-by-id 端点（参议员交易按 ID 检索）接收可选 page, limit，返回 senateID（参议员 ID）、disclosureDate（披露日期）、transactionDate（交易日期）等 16 项指标。

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

resp = requests.get(
    "https://quote-fmp.com/stable/senate-trades-by-id",
    params={"page": 0, "limit": 100, "senateID": "S000033", "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/senate-trades-by-id 首屏记录，获取最新披露的 senateID、disclosureDate、transactionDate（样本 senateID=M001242）。
递增游标翻页回填参议员交易按 ID 检索（page=1, limit=100）	`page=1&limit=100`	向 /stable/senate-trades-by-id 传 page=1&limit=100，向历史纵深翻页归档 senateID、disclosureDate、transactionDate 等 16 列。

时序与查询边界从 /stable/senate-trades-by-id 拉取 senateID：DataFrame 判空与索引安全

从 /stable/senate-trades-by-id 采集参议员交易按 ID 检索（可选 page, limit）后，可获得 senateID（样本 M001242）及 disclosureDate（披露日期）；生产脚本中切勿对空 DataFrame 直接按列名索引。

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

处理 /stable/senate-trades-by-id 下发的参议员交易按 ID 检索记录时，以 (symbol, senateID, transactionDate) 作为 Upsert 冲突键，同时核对 senateID（M001242）的编码格式。

返回数据

16 个字段

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

字段	类型	示例值	说明
`symbol`	string	`"CM"`	证券代码
`senateID`	string	`"M001242"`	参议员 ID
`disclosureDate`	string	`"2026-07-24"`	披露日期
`transactionDate`	string	`"2026-06-22"`	交易日期
`firstName`	string	`"Bernie"`	名
`lastName`	string	`"Moreno"`	姓
`office`	string	`"Bernie Moreno"`	办公地点
`district`	string	`""`	选区
`owner`	string	`"Self"`	持有人
`assetDescription`	string	`"Canadian Imperial Bank of Comm…"`	资产描述
`assetType`	string	`"Corporate Bond"`	资产类型
`type`	string	`"Sale"`	类型（如买入/卖出）
`amount`	string	`"$1,001 - $15,000"`	金额区间
`capitalGainsOver200USD`	string	`"False"`	是否取得 200 美元以上资本利得
`comment`	string	`""`	备注/说明
`link`	string	`"https://efdsearch.senate.gov/s…"`	详情链接

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

[
{
"symbol": "CM",
"senateID": "M001242",
"disclosureDate": "2026-07-24",
"transactionDate": "2026-06-22",
"firstName": "Bernie",
"lastName": "Moreno",
"office": "Bernie Moreno",
"district": "",
"owner": "Self",
"assetDescription": "Canadian Imperial Bank of Commerce",
"assetType": "Corporate Bond",
"type": "Sale",
"amount": "$1,001 - $15,000",
"capitalGainsOver200USD": "False",
"comment": "",
"link": "https://efdsearch.senate.gov/search/view/ptr/bccf83ce-dd72-4ab6-8564-b3bbb1d2ee55/"
}
]

常见问题解答（FAQ）

2 个问题

参议员交易按 ID 检索和参议院交易动态属于同一模块，两者的查询键与核心产出字段如何区分？

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

在设计参议员交易按 ID 检索（/stable/senate-trades-by-id）的数据拉取管道时，怎样避免单次请求跨度过大或遗漏？

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

同模块相关接口对比

Symbol

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

接口	路径	核心差异与适用场景
参议院交易动态Senate Trading Activity	`/stable/senate-trades`	监控美国参议员的交易活动，可获取参议员交易的详细信息，包括交易日期、资产、金额及潜在利益冲突
参议员交易按姓名检索Senate Trades By Name	`/stable/senate-trades-by-name`	按议员姓名检索美国参议员的美股交易记录
美国众议院交易记录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（美国国会交易）全部接口目录 →

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

免费试用 1 个月