congress-trades-api

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.

Package Information

Released: 4 mo ago
Downloads: 11 weekly / 306 monthly
Latest Version: 0.1.1
Author: John Cole

Documentation

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:

  1. In n8n, open Settings > Community Nodes.
  2. Select Install.
  3. Enter n8n-nodes-congress-trades-api as the npm package name.
  4. 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.

  1. Sign in to the Apify Console.
  2. Open Settings > Integrations and copy your Personal API token.
  3. In n8n, create a new Apify API credential and paste the token.
  4. 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, and owner. 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

  1. Manual Trigger.
  2. Congress Trades: Last Name Pelosi, Output Simplified.
  3. Google Sheets: append each transaction's ticker, transactionType, amountRange, and date.

2. Watch trades in a specific stock

  1. Schedule Trigger: run daily.
  2. Congress Trades: Stock Symbol NVDA, Start Date the last week.
  3. Slack: alert on any new disclosed trades.

3. Let an AI Agent answer disclosure questions

  1. AI Agent node.
  2. Attach Congress Trades as a tool.
  3. 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

License

MIT

Discussion