Documentation
API reference
Overview
api.py is a read-only FastAPI layer: one generic route per dataset, driven by a declarative RELATIONS table, plus three hand-built routes for the core congressional-trades scope. Interactive Swagger docs are auto-generated at /docs on any running instance.
| Endpoint | Description |
|---|---|
GET / | Dataset names and row counts |
GET /trades | Unified congress-trades view. Filters: tkr, last_name, chamber |
GET /politician/{name} | Per-politician summary + trade listing (substring match) |
GET /ticker/{symbol} | All activity for one ticker (exact, case-insensitive) |
GET /lobbying · /contracts · /insiders · /13f-positions · /13f-changes · /13f-top-holders · /short-volume · /patents · /donors · /pageviews · /exec-comp · /trump-trades · /senate-assets · /senate-liabilities | Generic filtered listing per dataset. See RELATIONS in api.py for exact filter columns |
Every listing route accepts ?limit= (default 100, max 1000) and ?offset=. Not built: authentication, rate limiting, CORS. Designed to run on 127.0.0.1 for personal use.
Prev: Datasets
Next: Data model