# US Congress Trades Data API (https://www.socialcrawl.dev/platforms/us_congress_trades)

> US Congress Trades API: 19 endpoints for House and Senate STOCK Act disclosures. Search filings, look up a politician by last name or a ticker, then pull party, sector, unusual-activity, and late-filer stats. Every live miss is 1 credit.

TL;DR: SocialCrawl's US Congress Trades API exposes 19 endpoints, 1 credit per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Trades | GET | `/v1/us_congress_trades/trades` | 1 | Search US Congress stock trades |
| Trades Latest | GET | `/v1/us_congress_trades/trades/latest` | 1 | Latest US Congress trades (48 hours) |
| Trades Recent | GET | `/v1/us_congress_trades/trades/recent` | 1 | Recent US Congress trades (7 days) |
| Members | GET | `/v1/us_congress_trades/members` | 1 | List members of Congress who have disclosed trades |
| Politician | GET | `/v1/us_congress_trades/politician` | 1 | Get a politician's trading summary |
| Politician Trades | GET | `/v1/us_congress_trades/politician/trades` | 1 | List trades for one politician |
| Ticker | GET | `/v1/us_congress_trades/ticker` | 1 | Get congressional trading stats for a ticker |
| Ticker Trades | GET | `/v1/us_congress_trades/ticker/trades` | 1 | List congressional trades for a ticker |
| State Trades | GET | `/v1/us_congress_trades/state/trades` | 1 | List trades from a state's congressional delegation |
| Stats | GET | `/v1/us_congress_trades/stats` | 1 | Dataset summary |
| Stats Party | GET | `/v1/us_congress_trades/stats/party` | 1 | Compare trade counts by party |
| Stats Sectors | GET | `/v1/us_congress_trades/stats/sectors` | 1 | Trade counts by industry sector |
| Stats Issuers | GET | `/v1/us_congress_trades/stats/issuers` | 1 | Most-traded issuers in Congress |
| Stats Politicians | GET | `/v1/us_congress_trades/stats/politicians` | 1 | Most-active congressional traders |
| Stats Tickers | GET | `/v1/us_congress_trades/stats/tickers` | 1 | Most-traded tickers in Congress |
| Stats Volume | GET | `/v1/us_congress_trades/stats/volume` | 1 | Congressional trade volume over time |
| Stats Unusual | GET | `/v1/us_congress_trades/stats/unusual` | 1 | Tickers with unusual congressional activity |
| Stats Buy Sell | GET | `/v1/us_congress_trades/stats/buy-sell` | 1 | Congressional buy vs sell ratio |
| Stats Reporting Gaps | GET | `/v1/us_congress_trades/stats/reporting-gaps` | 1 | Politicians ranked by late STOCK Act filings |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/us_congress_trades/trades" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## SocialCrawl vs House and Senate disclosure portals

| Feature | SocialCrawl | House and Senate disclosure portals |
| --- | --- | --- |
| Chambers in one call | House and Senate STOCK Act rows on one search route | Two portals, two formats, per-member documents |
| Lookup by ticker or last name | ticker=NVDA or handle=Pelosi as query params | Browse filings one member at a time |
| Response shape | Same JSON envelope as the rest of the catalog | HTML, XML, and scanned PDFs mixed by chamber |
| Stats | Party, sector, unusual activity, and late filers included | You compute aggregates after downloading files |
| Auth and price | One x-api-key, 1 credit per live miss | No API. Manual download from each portal |

## FAQ

### How do I get congressional stock trades with an API?

Call GET /v1/us_congress_trades/trades with your x-api-key. Filter by ticker, politician last name, party, chamber, sector, buy/sell/exchange, and publication date. SocialCrawl returns structured JSON on the same envelope as the rest of the catalog.

### What does the US Congress Trades API return?

STOCK Act periodic transaction reports from the House and Senate. Each filing row has the member, issuer, ticker, transaction type, disclosed value, trade and publication dates, and the reporting gap in days.

### Can I look up one politician's STOCK Act filings?

Yes. Pass the last name as handle to GET /v1/us_congress_trades/politician for the summary, then the same handle to politician/trades for every filing. Example: handle=Pelosi.

### How much does the Congress stock trades API cost?

Every US Congress Trades route costs 1 credit on a live miss. Cache hits, empty lists, and missing politicians, tickers, or states are not charged. New accounts start with 100 credits.

### Does this API return live stock quotes?

No. This is disclosure data, not a market-data feed. Use it for who filed, what they reported, and when. For prices, call the Finance quote routes instead.

### How do I filter trades by ticker or chamber?

On /v1/us_congress_trades/trades pass ticker=NVDA and chamber=senate or chamber=house. Bare tickers such as NVDA are accepted. Invalid enums return 400 before a credit is spent.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What is the SocialCrawl US Congress Trades API?
- How do I get congressional stock trades with an API?
- Does SocialCrawl have a STOCK Act disclosure API?