定期同步参众两院新记录并生成提醒。
Senate(美国国会交易)
此类接口提供美国参众两院的财务披露信息,包括最新的披露文件、按议员姓名或 ID 查询的交易记录、议员档案,以及净资产与持仓。常被用来观察政策相关行业的资金动向;披露本身存在法定期限内的延迟,申报金额也多为区间值,解读时需要保留余量。
典型使用场景
3 个场景观察特定证券相关的议员买卖披露。
连接议员资料、交易、持仓和净资产数据。
接口怎么选?
6 项选型对照美国国会交易类别分为最新披露、按股票或人物查询、人物资料与持仓净值三类。先明确要追踪事件、证券还是议员,再选择接口。
国会交易数据来自公开披露,申报可能使用金额区间并存在延迟、修订和证券名称映射问题,不代表实时成交记录。
| 你的需求 | 推荐接口 | 选择理由 |
|---|---|---|
| 获取最新参议员披露 | Latest Senate Financial Disclosures参议院最新财务披露 | 适合持续监控新公开记录 |
| 获取最新众议员披露 | Latest House Financial Disclosures美国众议院最新财务申报 | 参众两院数据应分别处理 |
| 按股票查看参议员交易 | Senate Trading Activity参议院交易动态 | 从证券维度研究政治交易活动 |
| 按议员姓名查询交易 | Senate Trades By Name参议员交易按姓名检索 | 适合人物跟踪和历史汇总 |
| 查询人物资料与职位 | Senate Profiles参议员资料 | 补充议员身份和背景信息 |
| 研究议员净资产与资产披露 | Senate Net Worth参议员净资产明细 | 按年度获取议员资产、负债与收入逐项披露明细 |
数据覆盖与参数口径
- 地域范围:美国参议院和众议院公开披露体系
- 数据类型:财务披露、交易、人物、持仓和净资产汇总
- 时间特性:存在申报和数据处理延迟,不是实时成交数据
- 金额口径:部分记录为披露区间,不等同于精确成交金额
- 使用限制:公开披露可能修订,证券映射和重复记录需本地校验
调用示例
Python 关键代码示例场景:获取最新参议员财务披露 · 对应接口:Latest Senate Financial Disclosures(参议院最新财务披露)
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")- 应使用稳定字段对分页结果去重。
- 展示时标注披露日期、交易日期及金额区间。
数据注意事项
4 条实盘要点- 参议院——Latest Senate Financial Disclosures(参议院最新财务披露)——与众议院——Latest House Financial Disclosures(美国众议院最新财务申报)——分属两套披露系统,合并建表时务必保留院别字段。
- 必须严格区分交易发生日(
transactionDate)与公开披露日(disclosureDate),量化策略与事件回测只能以disclosureDate作为信号可见日。 - 披露金额
amount为法定区间字符串(如$15,001 - $50,000),统计资金规模时应分别计算区间下限、上限与中位数。 - 按股票与按议员姓名跟踪政界买卖使用 Senate Trading Activity(参议院交易动态) 与 Senate Trades By Name(参议员交易按姓名检索);按议员个人深度剖析则结合 Senate Profiles(参议员资料) 与 Senate Net Worth(参议员净资产明细)。
常见问题
3 个问题国会交易数据是实时的吗?
不是。记录来自公开申报,交易发生到披露之间可能存在明显时间差。
披露金额为什么是区间?
监管表格常按金额区间披露,因此不能把区间上限或下限当作精确成交额。
参议院和众议院数据能否直接合并?
可以建立统一模型,但应保留院别、来源字段和各自记录标识。
接口一览(12个)
3 个功能模块Latest
2 个接口Symbol
6 个接口该接口用于监控美国参议员的交易活动:可获取参议员交易的详细信息,包括交易日期、资产、金额及潜在利益冲突。
/stable/senate-trades该接口按议员姓名检索美国参议员的美股交易记录,适用于美国国会议员财务披露跟踪、政策关联交易研究与另类事件因子回测。
/stable/senate-trades-by-name该接口按参议员的参议院 ID 查询其美股交易记录,适用于美国国会议员财务披露跟踪、政策关联交易研究与另类事件因子回测。
/stable/senate-trades-by-id该接口记录众议院议员及其配偶的股票买卖活动:出售、购买、持仓归属、交易金额等明细,实时更新,用于了解官员的财务决策动向。
/stable/house-trades该接口支持按美国众议院议员姓名关键词检索其依法申报的个人及家属证券交易明细。适用于仅知晓议员英文姓名或姓氏、快速排查特定国会政治人物近期买卖个股动向与潜在政策关联交易的投研场景。
/stable/house-trades-by-name该接口按议员唯一识别码精确查询指定美国众议院议员的全部历史证券交易申报记录。相比姓名检索,基于唯一编码查询可彻底规避同名混淆与拼写变体干扰,是构建国会议员持仓跟踪库与量化跟单回测的标准入口。
/stable/house-trades-by-idProfile
4 个接口该接口返回国会议员的资料详情:党派、所属州、职位及任职年限。
/stable/senate-profile该接口返回某位议员担任过的国会职位,含任期起止、党派和所属州。
/stable/senate-positions该接口按申报年份返回某位议员的净资产明细披露:资产、负债和收入逐项列出。
/stable/senate-net-worth该接口按年度返回某位议员的净资产汇总数据,并按资产与负债类型分组。
/stable/senate-net-worth-aggregated