congress-trades
Track US congress member and politician stock trades in real-time using the Quiver Quant API. Syncs trades to a local SQLite database, detects new significant trades above 15K, and sends alerts via OpenClaw messaging. Only requires Python with the requests library and a QUIVER_API_KEY environment variable. Use when setting up congressional trade monitoring, politician stock trade alerts, insider trading surveillance, or tracking what senators and representatives are buying and selling.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/armax/congress-tradesWhat This Skill Does
The Congress Trades Tracker is an automated intelligence tool designed to monitor and report US congressional stock market activity in real-time. By leveraging the Quiver Quant API, this skill periodically scans for new trade disclosures submitted by senators and representatives. It processes these filings, deduplicates entries using a unique trade key, and stores them in a local SQLite database for historical reference. The skill filters for significant market movements—defaulting to transactions over $15,000—and triggers an automated alert system when new high-value activity is identified. This data is then formatted into concise, readable notifications that are picked up by the OpenClaw agent for delivery to the user, ensuring you stay ahead of potential insider trading trends and political market influences without manual oversight.
Installation
- Ensure Python 3.10+ and the
requestslibrary are installed:pip install requests. - Obtain a valid API key from Quiver Quant.
- Set the
QUIVER_API_KEYas an environment variable in your system configuration or shell profile. - Configure the storage path for the SQLite database via the
CONGRESS_DB_PATHvariable if a custom location is required. - Set up your periodic execution via
crontabto run thescraper.pyscript. It is recommended to run this every 5–15 minutes to balance data freshness and API limits. - Update your
HEARTBEAT.mdfile to include the instruction for OpenClaw to monitor thepending_congress_alert.txtfile for incoming signals.
Use Cases
- Insider Trading Surveillance: Identify patterns in stock portfolios of influential politicians before major policy changes are announced.
- Investment Research: Incorporate political trade data into your broader market analysis strategies to hedge against political volatility.
- Automated Alerting: Receive push notifications for high-stakes trades as they are filed, ensuring you never miss a significant disclosure.
- Historical Tracking: Build a local database of congressional financial disclosures for longitudinal trend analysis.
Example Prompts
- "OpenClaw, check if any senators have made trades over $100,000 in the last 48 hours."
- "Alert me immediately whenever Nancy Pelosi buys or sells tech stocks."
- "What are the most recent significant stock trades filed by members of the Senate Armed Services Committee?"
Tips & Limitations
- Rate Limiting: Be mindful of the Quiver Quant API rate limits; frequency should be managed appropriately to avoid service disruptions.
- Threshold Tuning: You can adjust
MIN_TRADE_AMOUNTto be higher if you only want to see institutional-grade trades, reducing alert fatigue. - Privacy: The skill stores data locally; ensure the
data/directory has appropriate permissions (chmod 700) to prevent unauthorized access to sensitive financial tracking data. - Data Lag: Note that while the scraper runs in real-time, the data relies on the timeliness of actual congressional filings, which may vary.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-armax-congress-trades": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, external-api