Senate Net Worth参议员净资产明细
该接口按申报年份返回某位议员的净资产明细披露：资产、负债和收入逐项列出。
https://quote-fmp.com/stable/senate-net-worth?senateID=P000197&page=0&limit=250数据更新周期
该接口暂无固定更新周期（多为按需更新的参考或静态数据）。
接口说明
- 金额是披露区间，不是精确值：申报按区间填写（如 1，000，001–5，000，000 美元）。自行加总时只能给区间上下界，中位数属于推算值，对外引用必须标注口径。
- 同一资产可能多行：共同持有、不同注释会产生重复行，加总前按 name + assetType + owner 去重。
- 申报日与所属年度区分（filingDate vs year）：前者是申报日，后者是披露所属年度。做时点分析用前者，做年度比较用后者，基于美国国会 STOCK Act 法定财务披露跟踪参众两院议员的股票买卖申报。
- 配套投研接口：House Trades By Name（众议院交易按议员姓名查询） · House Trades By ID（众议院交易按议员ID查询） · Stock Price and Volume Data（日线完整行情） · Latest Insider Trading（最新内部人交易）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
senateID | string | 必填 | P000197 | 参议员的唯一标识，用于国会交易数据。 |
调用代码示例
Python 关键代码上方代码调用 /stable/senate-net-worth（必填 senateID），将参议员净资产明细的 senateID（参议员 ID）、formType（SEC 申报表单类型（如 10-K、10-Q、8-K、4、13F））、year（年份） 载入 DataFrame。
resp = requests.get(
"https://quote-fmp.com/stable/senate-net-worth",
params={"senateID": "P000197", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 filingDate 升序重排并数值化 year（年份）
df["year"] = pd.to_numeric(df["year"], errors="coerce")
df = df.sort_values("filingDate").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 senateID=P000197 拉取参议员净资产明细 | senateID=P000197 | 向 /stable/senate-net-worth 传 senateID=P000197，提取匹配的 senateID、formType、year（如 senateID=P000197）。 |
| 切换 senateID=MSFT 查询参议员净资产明细 | senateID=MSFT | 改传 senateID=MSFT 访问 /stable/senate-net-worth，对比不同过滤条件下的 senateID、formType、year。 |
执行 /stable/senate-net-worth 拉取参议员净资产明细（必填 senateID），响应涵盖 senateID（P000197）等 17 列；对返回序列做滚动窗口计算前请先按日期升序排列。
/stable/senate-net-worth 产出的 17 项字段（含 year=2022、value=3000001）在写入宽表前，应按 (filingDate, senateID, name) 执行去重校验。
返回数据
17 个字段本接口示例响应共包含 17 个字段（数值型 2 个，文本/日期/布尔型 15 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
senateID | string | "P000197" | 参议员 ID |
formType | string | "House Report" | SEC 申报表单类型（如 10-K、10-Q、8-K、4、13F） |
year | number | 2022 | 年份 |
filingDate | string | "2023-05-15" | 申报日期（监管申报日期；若同表含 acceptedDate，实盘事件对齐应优先取 acceptedDate） |
section | string | "Liabilities" | 章节 |
category | string | "Mortgage & Real Estate Liability" | 分类 |
name | string | "Union Bank of California" | 名称 |
assetType | string | "Mortgage on 2640 Broadway, San…" | 资产类型 |
incomeType | null | null | 收入类型 |
owner | string | "Joint" | 持有人 |
comment | null | null | 备注/说明 |
debtDetails | object | {…} | 债务明细 |
valueRange | object | {…} | 数值区间 |
value | number | 3000001 | 数值 |
incomeRange | null | null | 收入区间 |
income | null | null | 收入 |
link | string | "https://disclosures-clerk.hous…" | 详情链接 |
查看响应数据示例（原始 JSON）
[
{
"senateID": "P000197",
"formType": "House Report",
"year": 2022,
"filingDate": "2023-05-15",
"section": "Liabilities",
"category": "Mortgage & Real Estate Liability",
"name": "Union Bank of California",
"assetType": "Mortgage on 2640 Broadway, San Francisco, CA",
"incomeType": null,
"owner": "Joint",
"comment": null,
"debtDetails": {
"dateIncurred": "September 2007"
},
"valueRange": {
"min": 1000001,
"max": 5000000
},
"value": 3000001,
"incomeRange": null,
"income": null,
"link": "https://disclosures-clerk.house.gov/public_disc/financial-pdfs/2022/10053231.pdf"
}
]常见问题解答（FAQ）
2 个问题参议员净资产明细与 参议员资料 的端点路径（/stable/senate-net-worth vs /stable/senate-profile）和参数约束分别是怎样的？
调用 /stable/senate-net-worth 获取参议员净资产明细时（必填 senateID），您将拿到 senateID=P000197 等 17 列数据；而调用 Senate Profiles（参议员资料）则会拿到 10 列数据。
调用 /stable/senate-net-worth 获取参议员净资产明细，怎样根据参数特性控制单次返回的记录范围？
针对 参议员净资产明细（/stable/senate-net-worth），请传入精确匹配的 senateID 参数调用 /stable/senate-net-worth；提取 senateID（P000197）与 formType 后即可完成当期截面对齐。
同模块相关接口对比
Profile本接口路径 /stable/senate-net-worth，必填参数 senateID。 同一模块「Profile」下共 4 个接口，下表列出其余 3 个， 按粒度与查询维度对比，避免选错接口。