Senate Trading Activity参议院交易动态
该接口用于监控美国参议员的交易活动:可获取参议员交易的详细信息,包括交易日期、资产、金额及潜在利益冲突。
https://quote-fmp.com/stable/senate-trades?symbol=AAPL数据更新周期
Daily
接口说明
- 透明与问责:获取参议员交易的详细清单,包括日期、资产、交易金额和每股价格。这种透明度有助于问责,并可洞悉民选官员的财务活动。
- 识别利益冲突:分析参议员在其可能有立法影响力的公司或板块中的交易,识别潜在利益冲突。对希望确保投资符合伦理的投资者至关重要。
- 辅助投资决策:投资者可跟踪参议员的交易活动,洞察市场趋势,或标记可能预示重大市场动向的交易。了解参议员何时交易什么,为市场情绪提供独特视角。
- 上下游关联接口: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/senate-trades(必填 symbol),响应 JSON 展开 senateID(参议员 ID)、disclosureDate(披露日期)、transactionDate(交易日期) 共 16 列。
resp = requests.get(
"https://quote-fmp.com/stable/senate-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 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入 symbol=AAPL 请求参议院交易动态 | symbol=AAPL | 调用 /stable/senate-trades 拉取 AAPL 的参议院交易动态,输出 senateID、disclosureDate、transactionDate 等 16 项标准化属性。 |
| 设置返回条数上限(limit=100)回溯 AAPL 参议院交易动态 | symbol=AAPL&page=0&limit=100 | 通过条数上限参数请求 /stable/senate-trades,单次拉回 AAPL 更长历史周期的 senateID、disclosureDate、transactionDate。 |
| 切换美股龙头 NVDA 对比参议院交易动态 | symbol=NVDA | 改用 symbol=NVDA 调用 /stable/senate-trades,提取 NVDA 的 senateID、disclosureDate、transactionDate 与 AAPL 横向对标。 |
调用 /stable/senate-trades 拉取参议院交易动态(必填 symbol)时,若条件未命中会返回 [];读取 senateID(W000802)与 disclosureDate 前须先判断 not df.empty。
/stable/senate-trades 的首条样本含 senateID=W000802;日常同步任务按 (symbol, senateID, transactionDate) 合并即可保持本地库与上游一致。
返回数据
16 个字段本接口示例响应共包含 16 个字段(数值型 0 个,文本/日期/布尔型 16 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
senateID | string | "W000802" | 参议员 ID |
disclosureDate | string | "2026-07-08" | 披露日期 |
transactionDate | string | "2026-06-24" | 交易日期 |
firstName | string | "Sheldon" | 名 |
lastName | string | "Whitehouse" | 姓 |
office | string | "Sheldon Whitehouse" | 办公地点 |
district | string | "RI" | 选区 |
owner | string | "Spouse" | 持有人 |
assetDescription | string | "Apple Inc" | 资产描述 |
assetType | string | "Stock" | 资产类型 |
type | string | "Sale" | 类型(如买入/卖出) |
amount | string | "$15,001 - $50,000" | 金额区间 |
capitalGainsOver200USD | string | "False" | 是否取得 200 美元以上资本利得 |
comment | string | "" | 备注/说明 |
link | string | "https://efdsearch.senate.gov/s…" | 详情链接 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"senateID": "W000802",
"disclosureDate": "2026-07-08",
"transactionDate": "2026-06-24",
"firstName": "Sheldon",
"lastName": "Whitehouse",
"office": "Sheldon Whitehouse",
"district": "RI",
"owner": "Spouse",
"assetDescription": "Apple Inc",
"assetType": "Stock",
"type": "Sale",
"amount": "$15,001 - $50,000",
"capitalGainsOver200USD": "False",
"comment": "",
"link": "https://efdsearch.senate.gov/search/view/ptr/5d9b1b8e-2ae1-442b-860c-e79b8a701dc6/"
}
]常见问题解答(FAQ)
2 个问题参议院交易动态(/stable/senate-trades)产出的 senateID 等字段,与 参议员交易按姓名检索 的返回内容有何侧重?
参议院交易动态(端点 /stable/senate-trades,必填 symbol)返回 senateID(参议员 ID)及 disclosureDate(2026-07-08)共 16 列;若业务需要 Senate Trades By Name(参议员交易按姓名检索),可改调 /stable/senate-trades-by-name(必填 name)。
工程团队在封装 /stable/senate-trades(参议院交易动态)客户端时,应采用怎样的拉取逻辑?
标准流程是递增 page(配合 limit)翻页请求 /stable/senate-trades 直至返回 [];在拿到 参议院交易动态 的 senateID 与 disclosureDate 后,及时释放内存中的原始文本流。
同模块相关接口对比
Symbol本接口路径 /stable/senate-trades,必填参数 symbol。 同一模块「Symbol」下共 6 个接口,下表列出其余 5 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 参议员交易按姓名检索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 | 按美国众议院议员姓名关键词检索其依法申报的个人及家属证券交易明细 |
| 众议院交易按议员ID查询House Trades By ID | /stable/house-trades-by-id | 按议员唯一识别码精确查询指定美国众议院议员的全部历史证券交易申报记录 |