{
  "markdown": "# Bargo Free API Packages\n\nOfficial lightweight clients for Bargo Free APIs.\n\n## Packages\n\n- `packages/npm` - npm package: `@bargo-ai/congress`\n- `packages/python` - Python package: `bargo-congress`\n\nBoth packages currently support the Bargo Congress Trades API.\n\nAPI docs: https://www.bargo.ai/free-apis/congress\n\n## Quickstart\n\nNo key is required to try the API. A free key raises your quota — get one at\nhttps://www.bargo.ai/free-apis/dash\n\n### Python\n\n```bash\npip install bargo-congress\n```\n\n```python\nfrom bargo_congress import BargoCongressClient\n\nclient = BargoCongressClient()  # or BargoCongressClient(api_key=\"...\")\n\n# Recent disclosures for one ticker\ndata = client.ticker_trades(\"NVDA\", limit=5)\nfor trade in data[\"trades\"]:\n    print(trade[\"member\"], trade[\"type\"], trade[\"amount_range\"], trade[\"transaction_date\"])\n\n# Filter across both chambers\nsenate_buys = client.trades(chamber=\"senate\", type=\"buy\", limit=10)\n\n# Members, one member's disclosures, aggregates, dataset freshness\nclient.members(limit=50)\nclient.member(\"gilbert-cisneros\")\nclient.stats()\nclient.health()\n```\n\n### JavaScript / TypeScript\n\n```bash\nnpm install @bargo-ai/congress\n```\n\n```js\nimport { BargoCongressClient } from \"@bargo-ai/congress\";\n\nconst client = new BargoCongressClient({ apiKey: process.env.BARGO_API_KEY });\n\nconst { trades } = await client.tickerTrades(\"NVDA\", { limit: 5 });\nfor (const t of trades) {\n  console.log(t.member, t.type, t.amount_range, t.transaction_date);\n}\n\nconst senateBuys = await client.trades({ chamber: \"senate\", type: \"buy\", limit: 10 });\n```\n\nAlso published on JSR as `@bargo-ai/congress`.\n\n### curl\n\n```bash\ncurl \"https://www.bargo.ai/free-apis/congress/v1/trades?ticker=NVDA&limit=5\"\n\n# With a free key\ncurl -H \"X-Api-Key: $BARGO_API_KEY\" \\\n  \"https://www.bargo.ai/free-apis/congress/v1/trades?chamber=senate&type=buy&limit=10\"\n```\n\n## Endpoints\n\n| Endpoint | Returns |\n|---|---|\n| `GET /trades` | Disclosures, filterable by member, chamber, type, and date |\n| `GET /trades/{ticker}` | Disclosures for a single ticker |\n| `GET /members` | Members of Congress with disclosure activity |\n| `GET /members/{member_slug}` | One member's disclosures |\n| `GET /stats` | Aggregate trading statistics |\n| `GET /health` | API status and dataset freshness |\n\nEvery trade includes member and chamber, ticker and asset description,\ntransaction type, disclosed value range, transaction and disclosure dates, the\nofficial filing portal, and price-performance fields where available.\n\n## Agent Skill\n\n- [`bargo-congress-api`](skills/bargo-congress-api/SKILL.md) — research and\n  explain recent U.S. congressional stock-trade disclosures with Bargo's REST\n  API, official clients, or hosted Congress MCP server.\n\n## MCP\n\nA hosted Congress MCP server is available at\n`https://www.bargo.ai/free-apis/congress/mcp`, authenticated with an `X-Api-Key`\nheader. See [`docs/mcp.md`](docs/mcp.md).\n\n## Limits\n\n- Keyless: 30 requests/day and 100 rows/day per IP\n- Free API key: 100 requests/day and 1,000 rows/day\n- Page size: up to 100 rows keyless, up to 250 rows with a key\n\nQuotas are reported per response in the `X-RateLimit-*` headers. Treat those as\nauthoritative.\n\n## Notes\n\nDisclosures are filed under the STOCK Act and can legally appear up to roughly\n45 days after a trade, so this is not a real-time feed. This is an independent,\nunofficial service, not affiliated with or endorsed by the U.S. House of\nRepresentatives, the U.S. Senate, or any member of Congress. Nothing here is\ninvestment advice.\n\n## Attribution\n\nIf you display Bargo Congress API data publicly, include visible attribution linking to Bargo.\n",
  "bytes": 3623,
  "sha": "260ff58d76a921f11676cb77800a547530b9cbe6561c9eacd0af82340009ef53",
  "repo_slug": "bargo-ai/bargo-free-api-packages",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bargo_ai_congress_trades_d7f8735f/readme"
}