Latest Senate Financial Disclosures参议院最新财务披露
该接口按披露日期倒序分页返回美国参议院与众议院议员最新提交的定期财务交易申报流水,完整涵盖交易标的、买卖方向、申报金额区间、资产归属及原始备案链接,是实时监控国会山政治人物投资动向的核心雷达。
https://quote-fmp.com/stable/senate-latest?page=0&limit=100数据更新周期
Daily
接口说明
- 国会山最新申报广播:无需预设股票代码或议员姓名即可按分页拉取全市场最新入库的国会议员交易披露记录,适合作为定时轮询任务的主入口以捕捉新增政治交易信号。
- 交易日与披露日双时点:每条记录同时提供实际成交通知日与向国会道德委员会正式提交披露的日期,回测策略可严格按披露生效日对齐二级市场行情,消除法定滞后窗带来的未来函数。
- 金额区间与账户穿透:清晰标注交易金额所处的法定披露档位及资产持有人身份(议员本人、配偶或未成年子女),便于投研人员结合委员会席位背景筛选高置信度的大额主动买入事件。
- 上下游关联接口:Senate Net Worth(参议员净资产明细) · Senate Net Worth Aggregated(参议员净资产汇总) · Institutional Ownership Filings(机构持股申报) · Company Profile Data(公司概况)
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
page | number | 可选 | 0 | 分页页码,从 0 开始,配合每页条数翻页取更多数据(从 0 起算的分页游标;当响应返回空数组 [] 时代表已翻至历史末页) |
limit | number | 可选 | 100 | 返回结果条数上限,用于控制单次响应大小。 |
调用代码示例
Python 关键代码从 /stable/senate-latest 同步参议院最新财务披露(可选 page, limit),一次拿齐 senateID(参议员 ID)、disclosureDate(披露日期)、transactionDate(交易日期)(样本值 senateID=M001242)。
resp = requests.get(
"https://quote-fmp.com/stable/senate-latest",
params={"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")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 读取参议院最新财务披露最新首屏流(page=0, limit=50) | page=0&limit=50 | 请求 /stable/senate-latest 首屏记录,获取最新披露的 senateID、disclosureDate、transactionDate(样本 senateID=M001242)。 |
| 递增游标翻页回填参议院最新财务披露(page=1, limit=100) | page=1&limit=100 | 向 /stable/senate-latest 传 page=1&limit=100,向历史纵深翻页归档 senateID、disclosureDate、transactionDate 等 15 列。 |
针对 /stable/senate-latest(参议院最新财务披露,可选 page, limit),返回首行的 senateID 为 M001242、disclosureDate 为 2026-07-24;入库前请先拦截 200 [] 空响应。
持久化 /stable/senate-latest(参议院最新财务披露)的 15 个字段时,自然键取 (symbol, senateID, transactionDate);标识列 senateID(样本 M001242)请保持大小写与上游一致。
返回数据
15 个字段本接口示例响应共包含 15 个字段(数值型 0 个,文本/日期/布尔型 15 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
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" | 金额区间 |
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",
"comment": "",
"link": "https://efdsearch.senate.gov/search/view/ptr/bccf83ce-dd72-4ab6-8564-b3bbb1d2ee55/"
}
]常见问题解答(FAQ)
2 个问题在「Latest」下,参议院最新财务披露(/stable/senate-latest)与 美国众议院最新财务申报(/stable/house-latest)如何分工?
参议院最新财务披露(/stable/senate-latest,可选 page, limit)重在输出 senateID(参议员 ID)与 disclosureDate 等 15 列;而 Latest House Financial Disclosures(美国众议院最新财务申报)返回 16 列,两者按查询维度互补。
在批量同步参议院最新财务披露时,/stable/senate-latest 的查询窗口与参数组合该如何安排?
推荐做法:递增 page(配合 limit)翻页请求 /stable/senate-latest 直至返回 [];当 /stable/senate-latest 正常返回含 senateID 的 JSON/CSV 后,即可直接合入本地策略宽表。
同模块相关接口对比
Latest本接口路径 /stable/senate-latest,无必填参数。 同一模块「Latest」下共 2 个接口,下表列出其余 1 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 美国众议院最新财务申报Latest House Financial Disclosures | /stable/house-latest | 众议院议员最新申报的股票买卖与金融资产信息,包含资产类型、交易金额、日期及是否申报资本利得 |