Senate Net Worth Aggregated参议员净资产汇总
该接口按年度返回某位议员的净资产汇总数据，并按资产与负债类型分组。
https://quote-fmp.com/stable/senate-net-worth-aggregated?senateID=P000197数据更新周期
该接口暂无固定更新周期（多为按需更新的参考或静态数据）。
接口说明
- 汇总仍是区间推算：由明细区间中值汇总而来，与逐条明细自己相加可能对不上，跨来源比较时先统一口径，传入
senateID后可采集senateID（参议员ID）、year（年份）与total（合计） 等字段，契合自动化报表与看板的数据源要求。 - 缺失年份不等于 0：未申报或未披露的年度应视为缺失值而非零值，基于美国国会 STOCK Act 法定财务披露跟踪参众两院议员的股票买卖申报。
- 跨年份比较要谨慎：申报表格版本变化会影响分类拆分，长周期趋势建议只比 total，不要比细分项，买方团队在构建跟踪看板时，可并联接入「参议员任职记录」以增强监控颗粒度。
- 关联数据线接口：Latest House Financial Disclosures（美国众议院最新财务申报） · Senate Trading Activity（参议院交易动态） · Institutional Ownership Filings（机构持股申报） · Company Profile Data（公司概况）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
senateID | string | 必填 | P000197 | 参议员的唯一标识，用于国会交易数据。 |
调用代码示例
Python 关键代码针对参议员净资产汇总，向 /stable/senate-net-worth-aggregated 传入必填 senateID后，响应提供 senateID（参议员 ID）、year（年份）、total（合计）（样本 senateID=P000197）。
resp = requests.get(
"https://quote-fmp.com/stable/senate-net-worth-aggregated",
params={"senateID": "P000197", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 year（年份）
df["year"] = pd.to_numeric(df["year"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 senateID=P000197 拉取参议员净资产汇总 | senateID=P000197 | 向 /stable/senate-net-worth-aggregated 传 senateID=P000197，提取匹配的 senateID、year、total（如 senateID=P000197）。 |
| 切换 senateID=MSFT 查询参议员净资产汇总 | senateID=MSFT | 改传 senateID=MSFT 访问 /stable/senate-net-worth-aggregated，对比不同过滤条件下的 senateID、year、total。 |
参议员净资产汇总端点 /stable/senate-net-worth-aggregated（必填 senateID）单次返回 senateID 等 14 项属性；在自动化脚本中建议先校验返回列表长度再提取字段。
在本地数据仓库归档参议员净资产汇总时，以 (senateID) 去重可防止重跑产生脏数据；其中 year（年份，如 2024）为原始未缩写数值。
返回数据
14 个字段本接口示例响应共包含 14 个字段（数值型 13 个，文本/日期/布尔型 1 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
senateID | string | "P000197" | 参议员 ID |
year | number | 2024 | 年份 |
total | number | 225219551 | 合计 |
realEstateLiabilities | number | 27000005 | 房地产负债 |
cashAndCashEquivalents | number | 291009 | 现金及现金等价物 |
businessAndSelfEmployment | number | 0 | 经营与自雇收入 |
realEstate | number | 45032504 | 房地产 |
ownershipInterest | number | 70140014 | 持股权益 |
stock | number | 136748525 | 股票资产 |
options | number | 0 | 期权资产 |
revolvingAndCreditLines | number | 1500002 | 循环信贷与授信额度 |
assetBackedSecurities | number | 4475006 | 资产支持证券 |
businessLiabilities | number | 3000001 | 经营性负债 |
mutualFundsAndETFs | number | 32501 | 共同基金与 ETF |
查看响应数据示例（原始 JSON）
[
{
"senateID": "P000197",
"year": 2024,
"total": 225219551,
"realEstateLiabilities": 27000005,
"cashAndCashEquivalents": 291009,
"businessAndSelfEmployment": 0,
"realEstate": 45032504,
"ownershipInterest": 70140014,
"stock": 136748525,
"options": 0,
"revolvingAndCreditLines": 1500002,
"assetBackedSecurities": 4475006,
"businessLiabilities": 3000001,
"mutualFundsAndETFs": 32501
}
]常见问题解答（FAQ）
2 个问题想拉取「Profile」相关数据，应该调参议员净资产汇总（/stable/senate-net-worth-aggregated）还是 参议员资料？
参议员净资产汇总 对应路径 /stable/senate-net-worth-aggregated（必填 senateID），涵盖 senateID（P000197）、year（2024）等 14 列；Senate Profiles（参议员资料） 对应 /stable/senate-profile（无必填参数，共 10 列）。
如何基于 /stable/senate-net-worth-aggregated 构建稳定的参议员净资产汇总定时采集与历史补数任务？
回填或同步 参议员净资产汇总 时，请按 senateID 过滤条件请求 /stable/senate-net-worth-aggregated 并做非空校验；对返回的 senateID（参议员 ID）序列，建议先做排序核对再参与计算。
同模块相关接口对比
Profile本接口路径 /stable/senate-net-worth-aggregated，必填参数 senateID。 同一模块「Profile」下共 4 个接口，下表列出其余 3 个， 按粒度与查询维度对比，避免选错接口。