n8n-nodes-congress-trades-api
v0.1.1
Published
Search US Congress financial disclosures and stock trades by member, ticker, or date. Apify-backed n8n community node, pay-per-result, and usable as an AI agent tool.
Maintainers
Readme
n8n-nodes-congress-trades-api
An n8n community node that searches US Congress financial disclosures and stock trades and returns structured transaction records: member, ticker, asset, transaction type, amount range, and date. It is backed by the Congress Financial Disclosures API on Apify and bills per result, so there are no subscriptions and no minimums.
Installation · Credentials · Operations · Output · Example workflows · Pricing · Resources
What it does
Filter disclosed congressional trades by member name, ticker, or date, and it returns one item per transaction with the member, chamber, asset, ticker, transaction type, amount range, and date. It also works as an AI Agent tool, so an agent can answer questions about disclosed trades on demand.
- Filter by member first and last name, ticker, and date range
- Covers both the House and the Senate
- Choose how much data to return per transaction: Simplified, Raw, or Selected Fields
Installation
Follow the n8n community nodes installation guide:
- In n8n, open Settings > Community Nodes.
- Select Install.
- Enter
n8n-nodes-congress-trades-apias the npm package name. - Agree to the risks of using community nodes, then select Install.
After it installs, the Congress Trades node appears in the nodes panel.
n8n Cloud only allows verified community nodes. Until this node is verified, install it on a self-hosted n8n instance.
Credentials
You need a free Apify account and an API token.
- Sign in to the Apify Console.
- Open Settings > Integrations and copy your Personal API token.
- In n8n, create a new Apify API credential and paste the token.
- Use the credential's Test button to confirm it works.
The node also supports Apify OAuth2 if you prefer to connect that way.
Operations
Trade > Search returns disclosed transactions that match your filters.
| Parameter | Description |
| --- | --- |
| First Name / Last Name | Filter by the member's name. Optional. |
| Stock Symbol | Filter by the traded ticker. Optional. |
| Start Date / End Date | Restrict to a trade date range, YYYY-MM-DD. |
| Date Reported | Filter by the disclosure report date. |
| Maximum Results | How many transactions to return. |
| Output | How much data to return: Simplified, Raw, or Selected Fields. |
Output
Each transaction is returned as its own n8n item. The API returns more than ten fields per transaction, so the Output parameter lets you choose how much to return:
- Simplified (default): a compact object with
member,house,stateDistrict,asset,ticker,transactionType,amountRange,date, andowner. This mode is also used automatically when the node runs as an AI Agent tool, to keep responses small. - Raw: every field the API returns for each transaction, using the original field names below.
- Selected Fields: pick exactly which fields to include.
Fields (Raw and Selected Fields)
| Field | Type | Description |
| --- | --- | --- |
| id | string | Unique transaction identifier |
| Owner | string | Who holds the asset, for example SP (spouse) |
| Asset | string | Asset name |
| Ticker | string | Ticker symbol |
| Asset_Type_Code | string | Asset type code, for example ST (stock) |
| Transaction_Type | string | Transaction type, for example P (purchase) or S (sale) |
| Date | string | Transaction date |
| Notification_Date | string | Disclosure notification date |
| Amount_Range | string | Disclosed dollar amount range |
| Capital_Gains_Over_200 | string | Whether capital gains exceeded $200 |
| Details | string | Additional details |
| First_Name | string | Member first name |
| Last_Name | string | Member last name |
| State_District | string | State and district, for example LA06 |
| House | string | Chamber: House or Senate |
| Filing_ID | string | Filing identifier |
| DocID | string | Document identifier |
| Year | string | Disclosure year |
| PDF_Quality | string | Source PDF quality |
Example workflows
1. Track a member's trades
- Manual Trigger.
- Congress Trades: Last Name
Pelosi, OutputSimplified. - Google Sheets: append each transaction's
ticker,transactionType,amountRange, anddate.
2. Watch trades in a specific stock
- Schedule Trigger: run daily.
- Congress Trades: Stock Symbol
NVDA, Start Date the last week. - Slack: alert on any new disclosed trades.
3. Let an AI Agent answer disclosure questions
- AI Agent node.
- Attach Congress Trades as a tool.
- Ask "Which members traded semiconductor stocks this year?" The agent calls the node (in Simplified mode) and answers with disclosed trades.
Pricing
This node calls the Congress Financial Disclosures API on Apify, which is billed pay-per-result: about $0.002 per transaction returned (plus a small per-run fee), with no subscription and no minimums. Apify also includes a free monthly usage tier that covers typical volumes. See the Actor page for current rates.
Resources
- Congress Financial Disclosures API on Apify
- npm package
- n8n community nodes documentation
- Apify n8n integration guide
