Real-time Congress stock trades API —
freshest public data with webhooks

curl https://congressinfor-production.up.railway.app/trades/NVDA

{
  "ticker":                    "NVDA",
  "total":                    15,
  "offset":                   0,
  "limit":                    50,
  "has_more":                 false,
  "data_current":            true,
  "cache_loading":           false,
  "last_updated":            "2026-05-31T10:04:17Z",  // UTC timestamp of last scrape
  "data_lag_minutes":        14,                         // minutes since last refresh
  "next_refresh_in_minutes": 346,                        // minutes until next incremental refresh
  "trades": [
    {
      "member":     "John Boozman",
      "chamber":    "Senate",
      "ticker":     "NVDA",
      "trade_type": "buy",
      "amount":     "$1,001 - $15,000",
      "tx_date":    "2026-03-19",
      "disclosed":  "2026-04-14",
      "asset":      "NVIDIA Corporation - Common Stock",
      "link":       "https://efdsearch.senate.gov/search/view/ptr/..."
    }
  ]
}

curl https://congressinfor-production.up.railway.app/trades/NVDA

curl -H "X-Api-Key: YOUR_PRO_KEY" \
     https://congressinfor-production.up.railway.app/trades/NVDA/summary

{
  "ai_analysis": {
    "sentiment":         "bullish",
    "summary":           "Congressional trading in NVDA is skewed toward buying, with 31 buys (62%) vs 19 sells (38%)...",
    "notable_patterns":  "Cleo Fields is responsible for 27% of all trades, with a concentrated buying campaign...",
    "cached":            true,  // false on the first call of the day; true after that
    "stats": {
      "total_trades":    50,
      "buys":           31,
      "sells":          19,
      "unique_members": 16,
      "date_range": {
        "earliest": "2025-06-24",
        "latest":   "2026-04-24"
      }
    }
  }
}

curl "https://congressinfor-production.up.railway.app/trades/recent?limit=25&days=30"

curl -H "X-Api-Key: YOUR_KEY" \
     "https://congressinfor-production.up.railway.app/trades/recent?limit=500"

pip install requests

import requests

BASE = "https://congressinfor-production.up.railway.app"

resp = requests.get(f"{BASE}/trades/NVDA")
data = resp.json()

print(f"Data as of: {data['last_updated']}  ({data['data_lag_minutes']} min ago)")
for t in data["trades"]:
    print(f"{t['member']} ({t['chamber']}) {t['trade_type'].upper()} {t['ticker']} — {t['amount']}")

headers = {"X-Api-Key": "YOUR_PRO_KEY"}
resp = requests.get(f"{BASE}/trades/NVDA/summary", headers=headers)
data = resp.json()
ai   = data["ai_analysis"]

print(f"Sentiment: {ai['sentiment'].upper()}")   # BULLISH / BEARISH / MIXED
print(f"Summary:   {ai['summary']}")
print(f"Patterns:  {ai['notable_patterns']}")
print(f"Cached:    {ai['cached']}")              # True after first call of the day

resp = requests.get(f"{BASE}/trades/recent", params={"limit": 25, "days": 30})
data = resp.json()

for t in data["trades"]:
    print(f"{t['disclosed']}  {t['member']}  {t['ticker']}  {t['trade_type']}")

headers = {"X-Api-Key": "YOUR_KEY"}
resp   = requests.get(f"{BASE}/trades/recent", headers=headers, params={"limit": 500})
print(resp.json()["total"], "trades available")

const BASE    = "https://congressinfor-production.up.railway.app";
const headers = { "X-Api-Key": "YOUR_PRO_KEY" };

const res  = await fetch(`${BASE}/trades/NVDA/summary`, { headers });
const data = await res.json();
const { sentiment, summary, notable_patterns, cached, stats } = data.ai_analysis;

console.log(`Sentiment: ${sentiment.toUpperCase()}`); // BULLISH / BEARISH / MIXED
console.log(`Summary:   ${summary}`);
console.log(`Patterns:  ${notable_patterns}`);
console.log(`Cached:    ${cached}`);                  // true after first call of the day

const BASE = "https://congressinfor-production.up.railway.app";

const res        = await fetch(`${BASE}/trades/NVDA`);
const { trades } = await res.json();

console.log(`Data as of: ${data.last_updated} (${data.data_lag_minutes} min ago)`);
trades.forEach(t =>
  console.log(`${t.member} (${t.chamber}) ${t.trade_type.toUpperCase()} ${t.ticker} — ${t.amount}`)
);

const res  = await fetch(`${BASE}/trades/recent?limit=25&days=30`);
const data = await res.json();

data.trades.forEach(t =>
  console.log(`${t.disclosed}  ${t.member}  ${t.ticker}  ${t.trade_type}`)
);

const res  = await fetch(`${BASE}/trades/recent?limit=500`, {
  headers: { "X-Api-Key": "YOUR_KEY" }
});
const data = await res.json();
console.log(data.total, "trades available");

curl -X POST https://congressinfor-production.up.railway.app/webhooks/subscribe \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url": "https://your-server.com/hook", "ticker": "NVDA", "events": ["any"]}'

from flask import Flask, request, jsonify
app = Flask(__name__)

@app.route("/hook", methods=["POST"])
def hook():
    trade = request.get_json()
    print(f"🔔 {trade['politician']} {trade['trade_type']} {trade['ticker']} — {trade['amount']}")
    return jsonify({"ok": True})