GET /v1/ JSON SIGNAL REST AUTH ALPHA WEBHOOK API
v1 API — Closed Beta Now Live · Partner Program Open

Political Alpha. API-First.

The only data feed that cross-references congressional stock trades with the bills they oversee. 14 years of history. Bill-level ML scoring. Real-time markup alerts. Built for AI trading bots and quants.

Start Free — Get API Key Build a Trading Bot →
GET /functions/v1/api-gateway/v1/signals
# Get top signals — convergence-scored opportunities
response = requests.get(
    "https://tsubgvnlqpkcmklfftav.supabase.co/functions/v1/api-gateway/v1/signals",
    headers={"X-API-Key": "gg_live_your_key_here"},
    params={"min_score": 50, "limit": 10}
)

# Response envelope:
{
  "data": [{"ticker": "BAH", "opportunity_score": 447.2, ...}],
  "meta": {
    "request_id": "req_a1b2c3d4e5f6",
    "count": 10,
    "rate_limit": {"daily_used": 13, "daily_limit": 100}
  }
}
Official Registered API Partners:
Congress.gov (Library of Congress) · FEC (Federal Election Commission) · SEC EDGAR · Senate LDA · USASpending.gov
0
Historical Trades (2012–2026)
0
Federal API Partnerships
0
Bills Scored (3 Congresses)
0
Active Triple Signals
0
ML Signal Validation
Signals

Five Signals. One Edge.

Each signal alone is circumstantial. Cross-referenced together, they're the clearest picture of where political money is flowing before the market knows.

Triple Signal

Political Insider Alert

Fires when a politician sits on the committee controlling a bill, has traded stock in an affected company, and received campaign contributions from that industry. Why these three together? Each alone is circumstantial. A committee seat is just a job. A trade is just a portfolio decision. A contribution is just fundraising. But when all three converge on the same ticker — the probability of informed trading jumps to 78% based on our 14-year backtest. This is the strongest corruption indicator we track.

752 active Live updates 119th Congress
Exec Timing Signal

Corporate Insider Pre-Vote Buys

SEC Form 4 disclosures cross-referenced with congressional vote calendars. When a CEO buys $2M of stock 41 days before a congressional vote on legislation affecting their company — that's not coincidence. Form 4 filings reveal what corporate insiders know about their own regulatory environment. We measure the timing gap between executive buys and upcoming congressional votes, flagging purchases that cluster in the 4-90 day pre-vote window where informed positioning is statistically significant.

22,731 exec trades Form 4 sourced 2-day lag
Markup Calendar

Committee Hearing Alerts

When a committee schedules a markup, insiders know the bill is moving. This is the buy window — typically 4-21 days before the broader market prices in the legislative progress. Committee members see the calendar before it's public. The markup announcement is the catalyst — but the congressional buying that precedes it is the signal. Our backtest shows that trades placed within 14 days of a markup outperform the S&P 500 by an average of 8.3% at the 30-day mark.

17,104 meetings tracked 167 markups Webhook support
Bill ML Score

Investability Scoring

Machine learning model trained on 3 congressional sessions (42,143 bills, 188K historical trades). The model uses 25 features — sponsor committee seniority, co-sponsor count velocity, bill subject overlap with active lobbying, historical enactment rates by committee, and more. Bills scoring 70+ are enacted at 9.1% vs 1.7% for medium-tier — a validated 5.4× signal. High-investability bills also attract 3.2× more congressional trading volume in the 30 days following introduction. All inference runs in PostgreSQL — no external ML service dependency.

253 high-score bills 5.4× validated 25 features
Exec Flock Signal

Consortium Buy Detection

When 5+ C-suite officers buy simultaneously with zero sellers, that's a flock. This matters because executive buying is the highest-conviction insider signal — officers are risking personal capital on their own company's future. GovGreed tracks buyer headcount, capital deployed, and sector clustering across 22,731 SEC Form 4 transactions. Our enrichment layer separates PE fund exits from genuine C-suite conviction using officer tenure, title hierarchy, and transaction history. When a flock coincides with a congressional trade in the same sector, the combined signal has delivered a 67% win rate over 10 years.

22,731 Form 4 trades Buyer headcount scoring 10-year backtest
GovGreed API data flow: government data sources flow through AI processing into trading bot signals and JSON API responses
Intelligence Engine

How We Score Every Signal

Every API response is powered by a 7-layer scoring engine. Understanding the layers helps you interpret signal strength and build smarter trading logic.

40%
Congressional Behavior
Politician win rate (20%) + Herd detection when 3+ politicians converge on the same ticker (20%). The behavioral layer is the foundation — who traded and whether others followed.
16%
Legislative Timing
Bill markup proximity + committee seat alignment. Scores higher when a trade occurs within 21 days of a committee markup on legislation the trader's committee controls.
24%
Market Signals
Technical indicators (12%) — RSI, volume anomalies, momentum. Sector momentum (12%) — industry flow and rotation signals. Confirms whether the market agrees with the political thesis.
20%
Influence Patterns
Campaign contributions (10%) + Lobbying patterns (10%). Follow the money — PAC contributions and lobbying filings that precede trades independently confirm the legislative angle.
When 3+ layers align on the same ticker, the score multiplies: 3 layers = 1.3×, 4 = 1.5×, 5+ = 2.0×. See full model breakdown →
Authentication

X-API-Key Header

All requests require an API key passed via the X-API-Key header. Get your key from the Account page after approval.

BASE URL
https://tsubgvnlqpkcmklfftav.supabase.co/functions/v1/api-gateway
EXAMPLE REQUEST
curl -H "X-API-Key: gg_live_your_key_here" \
  "https://tsubgvnlqpkcmklfftav.supabase.co/functions/v1/api-gateway/v1/signals?limit=5"
RATE LIMITS
100 requests/day (beta)
2,000 requests/month (beta)
RESPONSE FORMAT
JSON envelope with data + meta
Rate limit info in every response
Endpoints

Clean REST API.

Every endpoint returns structured JSON. Paginated. Filterable. Designed to plug directly into your bot logic or data pipeline.

GET /v1/signals Opportunity briefing — convergence-scored signals
# Python — fetch top triple signals with upcoming markups
import requests

signals = requests.get(
  "https://tsubgvnlqpkcmklfftav.supabase.co/functions/v1/api-gateway/v1/signals",
  headers={"X-API-Key": "gg_live_your_key_here"},
  params={"has_upcoming_markup": true, "min_score": 50, "limit": 20}
).json()

# Returns: [{ticker, bill_number, politician_name, opportunity_score,
# insider_count, days_to_markup, bill_investability, ...}]
GET /v1/signals/convergence Multi-layer convergence opportunities (3+ signal overlap)
# Get markups in the next 14 days with linked triple signals
calendar = requests.get(
  "https://tsubgvnlqpkcmklfftav.supabase.co/functions/v1/api-gateway/v1/signals/convergence",
  headers={"X-API-Key": "gg_live_your_key_here"},
  params={"days_ahead": 14, "has_signals": true}
).json()

# Returns: [{meeting_date, committee, bill_number, bill_title,
# affected_tickers, triple_signal_count, investability_score}]
GET /v1/market/pulse Market pulse — sector momentum, volume, congressional activity
# Exec buys within 90 days before a congressional vote
exec_signals = requests.get(
  "https://tsubgvnlqpkcmklfftav.supabase.co/functions/v1/api-gateway/v1/market/pulse",
  headers={"X-API-Key": "gg_live_your_key_here"},
  params={"category": "ahead_of_vote", "transaction_type": "purchase"}
).json()

# Returns: [{ticker, insider_name, title, transaction_date,
# value, days_before_vote, bill_number, timing_score}]
GET /v1/tickers/:ticker Ticker convergence — all intelligence layers for one stock
# High-investability bills (score ≥ 70) with tickers
bills = requests.get(
  "https://tsubgvnlqpkcmklfftav.supabase.co/functions/v1/api-gateway/v1/tickers/NVDA",
  headers={"X-API-Key": "gg_live_your_key_here"},
  params={"min_score": 70, "congress": 119}
).json()

# Returns: [{bill_number, title, investability_score, affected_tickers,
# sector, committee, sponsor_greediness, status}]
GET /v1/trades 189K+ STOCK Act trades — filter by ticker, politician, date range
# All trades for a specific ticker (14 years of history)
trades = requests.get(
  "https://tsubgvnlqpkcmklfftav.supabase.co/functions/v1/api-gateway/v1/trades",
  headers={"X-API-Key": "gg_live_your_key_here"},
  params={"ticker": "NVDA", "transaction_type": "purchase", "date_from": "2023-01-01"}
).json()

# Returns: [{politician_name, party, state, trade_date, ticker,
# transaction_type, amount_range, committee_assignments}]
POST /v1/webhooks Register webhook URLs for real-time signal push alerts
# Register a webhook for new triple signals (Quant plan)
requests.post(
  "https://tsubgvnlqpkcmklfftav.supabase.co/functions/v1/api-gateway/v1/webhooks",
  headers={"X-API-Key": "gg_live_your_key_here"},
  json={
    "url": "https://your-bot.com/webhook/govgreed",
    "events": ["triple_signal", "markup_scheduled", "exec_pre_vote_buy"],
    "min_score": 100
  }
)
Three use cases for the GovGreed API: AI trading bots, quantitative strategies, and political risk monitoring
Use Cases

Who's Building With It

🤖

AI Trading Bots

Use triple signals and markup calendar alerts as entry triggers. Connect GovGreed signals → Alpaca or IBKR for execution. Political alpha is uncorrelated with technical signals — pure additive edge.

📊

Quant Strategies

14 years of historical data for backtesting. Rank signals by opportunity score, test forward returns by signal type. The exec pre-vote buy signal has a 4-day to 90-day return window worth measuring.

⚠️

Political Risk

Monitor which bills your portfolio companies are exposed to. Get alerts when committees schedule votes on legislation affecting your holdings. Know before the 8-K.

Integrations

Pair With Your Broker

GovGreed is the data layer. Connect to any execution platform. Our guide walks through Alpaca end-to-end.

Alpaca
Execution Layer

Commission-free trading API. The most popular choice for Python bots. Fractional shares, paper trading, real-time data.

QuantConnect
Backtesting Platform

Cloud-based algorithmic trading. Import GovGreed signal history as a custom data source and backtest your political alpha strategy.

Interactive Brokers
Institutional Execution

Professional-grade brokerage API. Use GovGreed signals for automated order routing via IBKR's Python API. Supports options.

Backtrader
Python Backtesting

Open-source Python backtesting framework. Feed GovGreed signals as a custom data feed and test any strategy locally.

Lumibot
Bot Framework

Python trading bot framework with built-in Alpaca integration. Add GovGreed as your signal source with three lines of code.

Tradier
Options + Equity API

REST-based brokerage API with options support. Use GovGreed bill signals to identify option plays around legislation catalysts.

Access

Alpha Phase. Partner With Us.

We're in alpha and selectively onboarding developers and trading teams who want to build on the GovGreed signal stack. Access is discussed individually — pricing depends on data needs and use case.

Consumer Access
Dashboard
For traders & researchers
  • Full signal dashboard
  • All 752 Triple Signals
  • Bill ML scores
  • Exec insider tab
  • Committee pipeline
  • Politician trading profiles
  • Reading list & watchlist
  • Daily signal digest
Join Waitlist →
What Makes This Different
Other providers give you raw STOCK Act filings. We give you the reasoning chain. Every signal comes with the politician's committee assignments, the specific bill in markup, the PAC money trail, lobbying activity, and a convergence score. You don't just know what Congress traded — you know why the signal fired and how strong the thesis is. That's the difference between raw data and actionable intelligence.
Alpha Program

We're onboarding select developers and trading teams during alpha. If you have a compelling use case, we're willing to discuss extended API access, custom signal feeds, and co-development arrangements. Reach out — we respond to every serious inquiry.

FAQ

Common Questions

Is this data legal to trade on?
Yes. All data is sourced from mandatory public disclosures under federal law. STOCK Act trades are publicly filed by members of Congress (45-day mandatory disclosure). SEC Form 4 executive trades are public filings required within 2 business days. Bill data is from Congress.gov's public API. There is no material non-public information (MNPI) in this dataset — it is all public disclosure with mandatory reporting lags. Consult your compliance team before deploying in a regulated fund context.
How is GovGreed different from other congressional data providers?
Other providers surface raw STOCK Act trade data — the same disclosures everyone sees. GovGreed cross-references those trades with the specific bills those politicians are voting on, their committee assignments, campaign contributions, corporate executive SEC Form 4 trades, and ML-scored bill passage probability. Beyond the federal APIs, GovGreed subscribes to private professional databases — including LinkedIn executive profiles, social media disclosures, and enriched SEC filing data — to validate officer identity, surface career history, and detect coordinated positioning. This enrichment layer powers the Exec Flock Signal and the lobbying relationship graph. The result is a derived signal nobody else has: the Triple Signal, which fires when all three corruption indicators align on the same ticker. We're also official registered API partners with five federal disclosure systems — not scraping unofficial sources.
What's the data latency? How fresh is it?
Congressional trades are updated daily from public disclosure systems (45-day mandatory lag, but we collect as they're filed). Executive trades (SEC Form 4) are updated daily and are typically 2 business days behind the transaction. The markup calendar is updated daily from Congress.gov. ML scores are recomputed weekly. Webhook events fire within minutes of our daily collection run.
How do I validate the signal before going live?
We recommend starting with the historical backtest: pull all triple signals from 2018–2023 via /v1/trades/historical, cross-reference with price data from FMP or Polygon, and measure forward returns at 5d/30d/90d windows. Our internal validation shows bills scoring 70+ on investability are enacted at 9.1% vs 1.7% for medium-tier (5.4× over 37,143 bills). The markup calendar signal (trade the day a markup is scheduled) is the highest-conviction near-term catalyst. Start on paper trading with Alpaca before deploying capital.
Do you support crypto or options?
The underlying signal data (congressional trades, bill impacts) covers publicly traded equities. Many of the affected companies (defense contractors, healthcare, energy) have active options markets, and the GovGreed signals can be used to identify options catalysts around markup dates. Crypto is not covered — the legislation we track primarily affects traditional equities and some ETFs.
How do I get started / is there a free trial?
The API is now in closed beta. Join the waitlist and we'll review your application — approved users get an API key immediately from their Account page. Beta tier includes 100 requests/day and 2,000/month. If you have an urgent development use case, apply as a Developer Partner for higher limits.

Closed Beta — Limited Spots

The API is live and delivering. 189K+ trades, 14 years of history, 7-factor scoring — apply for beta access and start pulling congressional trading signals into your bot today.

Join the Waitlist → Trading Bot Guide