Congressional trading and government data API
Nine datasets built from United States government disclosure filings, served as JSON over HTTPS with a single API key. Congressional stock trades by chamber, lobbying registrations, federal contract awards, corporate insider filings, quarterly institutional holdings, off-exchange volume, and a daily ranking of politician portfolios marked to market.
The distinction worth understanding before you compare options: these are read from the offices that publish the filings, not bought from an aggregator and passed along. Bottle Blue moved off its last commercial data vendor on 2026-08-18 for exactly that reason. Every source below is the originating publisher.
Endpoints
5 endpoints. Request and response examples for each one are in the full reference.
| Method | Endpoint | What it returns |
|---|---|---|
| GET | /government/{dataset}api.bottlebluellc.com |
US government financial-disclosure datasets. |
| GET | /government/leaderboardapi.bottlebluellc.com |
Daily performance ranking of politician stock portfolios. |
| GET | /government/portfolio/{chamber}/{name}api.bottlebluellc.com |
One politician's current book, positions marked to market. |
| GET | /labor/layoffsapi.bottlebluellc.com |
WARN layoff notices, as published by state labor agencies, newest notice first. |
| GET | /labor/h1bapi.bottlebluellc.com |
H-1B labor condition applications, as published by the US Department of Labor, for one decision date. |
Datasets
One route serves nine datasets, selected by a path parameter. Every one of them is built from filings published by the office named beside it.
dataset | What it contains |
|---|---|
congress |
Stock transactions disclosed by members of both chambers, combined into one series. |
senate |
Senate transactions only, read from the Senate's electronic disclosure system. |
house |
House transactions only, read from the House Clerk's yearly index and the e-filed report PDFs. |
lobbying |
Lobbying registrations and reports filed under the Lobbying Disclosure Act. |
contracts |
Federal contract award transactions. |
insiders |
Corporate insider transactions from Form 4 filings. |
13f-changes |
Quarter over quarter changes in institutional holdings, diffed from 13F-HR filings. |
off-exchange |
Daily off-exchange share volume. |
wsb |
Tickers ranked by how often they are discussed in public Reddit investing communities. |
Where the data comes from
| Data | Published by |
|---|---|
| Congressional stock trades, both chambers | Senate Electronic Financial Disclosure and the House Clerk's periodic transaction reports |
| Lobbying registrations and reports | Senate Lobbying Disclosure Act REST API |
| Federal contract awards | USASpending transaction search |
| Corporate insider transactions | SEC EDGAR Form 4 |
| Quarterly institutional holdings changes | SEC EDGAR 13F-HR, diffed against the prior quarter |
| Off-exchange share volume | FINRA daily short volume files |
| Retail discussion volume | Our own crawl of public Reddit investing communities |
Getting started
Every endpoint is JSON over HTTPS and takes one API key in an x-api-key header. There is no SDK to install and no OAuth dance.
curl "https://api.bottlebluellc.com/v1/government/congress?year=2026" \
-H "x-api-key: $BBL_API_KEY"Quickstart, authentication and errors and rate limits are documented in the reference. Keys are issued from the Bottle Blue dashboard.
Common questions
Where does the congressional trading data come from?
Directly from the two offices that receive the filings: the Senate's Electronic Financial Disclosure system and the House Clerk's financial disclosure index, including the e-filed periodic transaction report PDFs. Nothing in this dataset is relayed through a commercial aggregator.
How current is it?
It is as current as the filings themselves, which is the real constraint on every provider of this data. The STOCK Act allows a member of Congress up to 45 days to disclose a transaction, so a trade reaching the API today may have been executed weeks earlier. Collection runs on a schedule and new filings appear after the next run.
What is the politician portfolio leaderboard?
A daily build that reconstructs each politician's book from their own disclosed trades and marks it to market, then ranks the results. Because disclosure reports a dollar range rather than an exact amount, every figure it produces is an estimate derived from those ranges. It is not a reported return, and it should not be read as one.
Which chambers and datasets are covered?
The dataset parameter accepts congress, senate, house, lobbying, contracts, off-exchange, insiders, wsb and 13f-changes. Separate routes serve the daily leaderboard and a single politician's current positions.
What does it cost to use?
The government datasets sit behind the same single API key as the rest of the Bottle API, metered per plan. See the pricing and rate limit sections of the full reference for the current tiers.