Repository avatar
Monitoring
v1.0.0
active

bourse

io.github.ofylypczuk/bourse

Congress, Trump and Cabinet stock trades, SEC insiders, 13F funds and lobbying data as tools.

Documentation

bourse-sdk

Python client for the Bourse API: stock trades of members of Congress, President Trump and the Cabinet (OGE 278-T), SEC Form 4 insiders, Form 144, 13F funds, lobbying, government contracts, WARN layoffs, Jim Cramer's calls, Google Trends, Treasury yields, COT positioning and backtested strategies.

pip install bourse-sdk            # add [pandas] for DataFrames
from bourse import Bourse

b = Bourse("bk_...")                       # or set BOURSE_KEY
b.get("congress", ticker="NVDA")           # one page
rows = b.all("house", from_="2026-01-01")  # every page
df = b.df("tv-picks", person="Cramer")     # pandas DataFrame
b.ticker("AAPL")                           # everything about one ticker
b.get("insider-clusters", days=30)         # analytics

Get a free key (1,000 requests a day) in the Bourse app: Settings -> API key. Premium raises it to 20,000 a day and adds bulk downloads; API Pro (commercial license) to 250,000.

Webhooks

from bourse import Bourse

ok = Bourse.verify_webhook(secret, request.headers["Bourse-Signature"], request.get_data())

MCP server (Claude, ChatGPT, Cursor)

Remote MCP server with 6 tools (datasets, ticker profile, insider clusters, Congress and Trump trades):

URL:     https://api.bourse.pl/mcp
Header:  Authorization: Bearer bk_...

Clients that only take a URL can use https://api.bourse.pl/mcp?key=bk_.... Listed in the official MCP Registry as io.github.ofylypczuk/bourse.

Links

Data comes from public filings. Not investment advice. The code in this repository is MIT licensed.

No installation packages available.

Remote