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

> Returns STOCK Act disclosures across the House and Senate. Filter by ticker (AAPL or AAPL:US), politician last name, party, chamber, sector, transaction type, and publication date range. Sort by publication date, trade date, disclosed value, or reporting gap. Page with offset. Each row has the politician, issuer, ticker, buy/sell/exchange, disclosed value, dates, and reporting gap in days.

TL;DR: `GET /v1/us_congress_trades/trades` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `ticker` | no | Stock ticker. Bare symbols such as AAPL are sent as AAPL:US. Use AAPL:US when the search filter would otherwise miss. |
| `politician` | no | Politician last name (case-insensitive). |
| `party` | no | democrat or republican. (democrat \| republican) |
| `chamber` | no | senate or house. (senate \| house) |
| `sector` | no | Issuer sector slug, for example information-technology or health-care. |
| `tx_type` | no | buy, sell, or exchange. (buy \| sell \| exchange) |
| `start_date` | no | Publication date lower bound (YYYY-MM-DD). |
| `end_date` | no | Publication date upper bound (YYYY-MM-DD). |
| `sort` | no | pub_date (default), tx_date, value, or reporting_gap. (pub_date \| tx_date \| value \| reporting_gap) |
| `order` | no | desc (default) or asc. (asc \| desc) |
| `limit` | no | Page size, 1 to 100. Default 20. |
| `offset` | no | Rows to skip. Prefer the universal cursor parameter. |

## Code example

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

## FAQ

### How do I search congressional stock trades?

GET /v1/us_congress_trades/trades with optional ticker, politician, party, chamber, sector, tx_type, start_date, and end_date. Example: ticker=NVDA&tx_type=buy&limit=20.

### What fields are on each trade row?

The politician, issuer, ticker, buy/sell/exchange, disclosed value, trade date, publication date, and reporting gap in days.

### Do I need AAPL:US or will AAPL work?

Bare tickers such as AAPL and NVDA are accepted on this search route. The gateway sends the US suffix when the filter needs it.

### How do I page through results?

Pass the cursor from each response until it comes back absent. Limit is 1 to 100. Prefer cursor over a raw offset.

### What if the filters match nothing?

You get an empty list and the credit is refunded. Invalid enums such as chamber=parliament return 400 with no charge.

See the full US Congress Trades API: https://www.socialcrawl.dev/platforms/us_congress_trades

## 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:

- How do I search US Congress stock trades with an API?
- What filters does the SocialCrawl Congress trades endpoint take?