# US Congress Trades (/docs/us_congress_trades)

STOCK Act disclosures from the House and Senate: who traded, which issuer, buy or sell, disclosed value, and reporting gap

STOCK Act disclosures from the US House and Senate. Search by ticker, politician last name, party, chamber, sector, or date. Every trade row has the member, issuer, ticker, transaction type, disclosed value, dates, and reporting gap in days.

Base URL: `/v1/us_congress_trades/...`

## Quickstart

### Search recent filings

```bash
curl "https://www.socialcrawl.dev/v1/us_congress_trades/trades?ticker=NVDA&tx_type=buy&limit=20" \
  -H "x-api-key: YOUR_API_KEY"
```

Bare tickers such as `NVDA` are sent as `NVDA:US`. Page with `cursor` (or `offset`) from the response.

### Read one politician

```bash
curl "https://www.socialcrawl.dev/v1/us_congress_trades/politician?handle=Pelosi" \
  -H "x-api-key: YOUR_API_KEY"
```

The summary has trade count, buy vs sell, disclosed value, and top tickers. Pass the same `handle` to `GET /v1/us_congress_trades/politician/trades` for the filings.

### Rank late filers

```bash
curl "https://www.socialcrawl.dev/v1/us_congress_trades/stats/reporting-gaps?chamber=senate" \
  -H "x-api-key: YOUR_API_KEY"
```

Politicians are ranked by average days between the trade date and the public filing.

## Endpoints

## Notes

- All endpoints use `GET` with query parameters
- Authentication via `x-api-key` header
- Every path costs 1 credit. Cache hits cost 0. Empty lists and missing politicians are refunded
- `handle` is the last name (Pelosi, Tuberville). `keyword` is the ticker (AAPL or AAPL:US)