关于 Bargo Congress Trades
Bargo Congress Trades 提供 API 客户端和托管 MCP 服务,用于查询规范化的美国国会议员 STOCK Act 披露记录。研究人员可筛选交易,并查看议员、股票代码、交易信息及可用的价格表现数据。
主要功能
- 01按议员、议院、类型和日期筛选披露
- 02查询指定股票代码的交易
- 03查找议员及其披露记录
- 04获取汇总交易统计
- 05查看申报日期和可用的价格表现
适用场景
- 01研究近期国会议员股票披露
- 02比较不同议员或股票代码的披露活动
- 03查看交易金额范围和申报详情
MCP 相关
提供托管的 Congress MCP 服务,需在文档所述端点使用 X-Api-Key 请求头进行认证。README 未说明具体 MCP 工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://www.bargo.ai/free-apis/congress/mcpclaude mcp add --transport http bargo-ai-congress-trades https://www.bargo.ai/free-apis/congress/mcp{"mcpServers":{"bargo-ai-congress-trades":{"type":"http","url":"https://www.bargo.ai/free-apis/congress/mcp"}}}在 Cursor 中打开{"servers":{"bargo-ai-congress-trades":{"type":"http","url":"https://www.bargo.ai/free-apis/congress/mcp"}}}在 VS Code 中打开{"mcpServers":{"bargo-ai-congress-trades":{"type":"http","url":"https://www.bargo.ai/free-apis/congress/mcp"}}}{"mcpServers":{"bargo-ai-congress-trades":{"serverUrl":"https://www.bargo.ai/free-apis/congress/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://www.bargo.ai/free-apis/congress/mcp需要授权工具
3| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | enum | 否 | purchase | sale | exchange |
| limit | integer | 否 | |
| member | string | 否 | |
| ticker | string | 否 | |
| chamber | enum | 否 | house | senate |
详细介绍
Bargo 免费 API 软件包
Bargo 免费 API 的官方轻量级客户端。
软件包
packages/npm- npm 软件包:@bargo-ai/congresspackages/python- Python 软件包:bargo-congress
这两个软件包目前都支持 Bargo Congress Trades API。
API 文档:https://www.bargo.ai/free-apis/congress
快速入门
试用 API 无需密钥。免费密钥可提高配额,可在此获取: https://www.bargo.ai/free-apis/dash
Python
pip install bargo-congress
from bargo_congress import BargoCongressClient
client = BargoCongressClient() # or BargoCongressClient(api_key="...")
# Recent disclosures for one ticker
data = client.ticker_trades("NVDA", limit=5)
for trade in data["trades"]:
print(trade["member"], trade["type"], trade["amount_range"], trade["transaction_date"])
# Filter across both chambers
senate_buys = client.trades(chamber="senate", type="buy", limit=10)
# Members, one member's disclosures, aggregates, dataset freshness
client.members(limit=50)
client.member("gilbert-cisneros")
client.stats()
client.health()
JavaScript / TypeScript
npm install @bargo-ai/congress
import { BargoCongressClient } from "@bargo-ai/congress";
const client = new BargoCongressClient({ apiKey: process.env.BARGO_API_KEY });
const { trades } = await client.tickerTrades("NVDA", { limit: 5 });
for (const t of trades) {
console.log(t.member, t.type, t.amount_range, t.transaction_date);
}
const senateBuys = await client.trades({ chamber: "senate", type: "buy", limit: 10 });
也已发布到 JSR,名称为 @bargo-ai/congress。
curl
curl "https://www.bargo.ai/free-apis/congress/v1/trades?ticker=NVDA&limit=5"
# With a free key
curl -H "X-Api-Key: $BARGO_API_KEY" \
"https://www.bargo.ai/free-apis/congress/v1/trades?chamber=senate&type=buy&limit=10"
端点
| 端点 | 返回内容 |
|---|---|
GET /trades | 披露信息,可按成员、议院、类型和日期筛选 |
GET /trades/{ticker} | 单个股票代码的披露信息 |
GET /members | 有披露活动的国会议员 |
GET /members/{member_slug} | 一名成员的披露信息 |
GET /stats | 汇总交易统计数据 |
GET /health | API 状态和数据集最新情况 |
每笔交易都包含成员和所属议院、股票代码和资产描述、交易类型、披露金额范围、交易和披露日期、官方申报门户,以及可用时提供的价格表现字段。
Agent 技能
bargo-congress-api— 使用 Bargo 的 REST API、官方客户端或托管的 Congress MCP 服务,研究并说明近期美国国会议员股票交易披露信息。
MCP
可使用托管的 Congress MCP 服务:
https://www.bargo.ai/free-apis/congress/mcp,通过 X-Api-Key
请求头进行身份验证。请参阅 docs/mcp.md。
限制
- 无密钥:每个 IP 每天 30 次请求和 100 行数据
- 免费 API 密钥:每天 100 次请求和 1,000 行数据
- 页面大小:无密钥时最多 100 行,使用密钥时最多 250 行
每个响应的 X-RateLimit-* 请求头中都会报告配额。请以这些信息为准。
注意事项
根据 STOCK Act,披露信息的申报时间最多可能比交易时间晚约 45 天,因此这不是实时数据源。本服务独立且非官方,与美国众议院、美国参议院或任何国会议员均无关联,也未获得其认可。本服务中的任何内容均不构成投资建议。
署名
如果你公开展示 Bargo Congress API 数据,请添加醒目的署名并链接到 Bargo。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。