Wolves of Capitol HillAPI Docs

Wolves of Capitol Hill API

Congressional stock-trade disclosures — trades, politicians, tickers, and source filings — over plain HTTP, webhooks, and MCP.

The Wolves of Capitol Hill public data API serves published congressional stock-trade disclosures: every trade extracted from House and Senate periodic transaction reports (PTRs), reviewed by a human, and enriched with committee conflict signals — flags on trades that overlap an industry the disclosing member oversees.

Base URL

https://www.wolfofcapitolhill.com

All endpoints live under /api/v1. You can start without an API key — anonymous callers get evaluation-grade rate limits — and add a key from your account dashboard for production limits.

Endpoints

EndpointWhat it returns
GET /api/v1/tradesThe published-trades feed: filterable, keyset-paginated, optional CSV export.
GET /api/v1/politicians/{slug}One member's profile, recent trades, and counts.
GET /api/v1/tickers/{symbol}Congressional activity in one symbol, with buy/sell aggregates.
GET /api/v1/filingsThe published source filings, with official document URLs.

The machine-readable spec is served at /api/v1/openapi.json, and these docs are available as one plain-text dump at /llms-full.txt for LLM ingestion.

Response shapes

List endpoints return a page plus an opaque cursor:

{ "data": [ /* ... */ ], "nextCursor": "MjAyNi0wNi0zMFQ..." }

Single-resource endpoints wrap their payload in data. Errors are always:

{ "error": "machine_readable_code", "hint": "Optional human guidance." }

Every response — success or failure — carries X-RateLimit-* headers.

Next steps

  • Getting started — account, key, first request.
  • Authentication & tiers — keys, plans, and their real limits.
  • Rate limits & pagination — the minute/month windows and cursor semantics.
  • The trades data model — every Trade field, STOCK Act amount ranges, conflict signals.
  • Webhooks — signed trade.published pushes to your server.
  • MCP server — the API as tools in Claude Desktop, Claude Code, or any MCP client.
  • API Reference — every endpoint, generated from the OpenAPI spec, in the sidebar.