# Unusual Congressional Trades

`GET` `https://api.unusualwhales.com/api/congress/unusual-trades`

Returns congressional trades that have been flagged as unusual, optionally filtered by reason tags.
Supported `types` values include `committee_conflict`, `first_person_to_trade`, `low_marketcap`,
`unusual_industry`, `unusually_large_trade`, and `fec_donation_conflict`.

This is a premium endpoint. Contact dev@unusualwhales.com to request access.



## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `types` | string | No | Comma-separated list of unusual-activity tags to filter by. Returns all unusual trades when omitted. |
| `limit` | integer | No | Number of results per page (max 500). |
| `page` | integer | No | Page number (1-indexed). |


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `amount` | string | The disclosed amount range as a string. |
| `asset` | string | Asset description as disclosed. |
| `asset_type` | string | The asset type. |
| `company_name` | string | The full company name behind the traded ticker. |
| `description` | string | Additional disclosure description, if any. |
| `filing_date` | string | The date the trade was disclosed. |
| `id` | string | The trade's unique ID. |
| `politician_id` | string | The politician's ID. |
| `politician_name` | string | The politician's full name. |
| `ticker` | string | The traded ticker symbol. |
| `transaction_date` | string | The date the transaction occurred. |
| `transaction_type` | string | The type of transaction (e.g., Buy, Sell, Sale Partial). |
| `unusual_activity_meta` | array[object] | Per-tag metadata explaining why each flag was applied. |
| `unusual_activity_tags` | array[string] | Reason tags this trade was flagged as unusual. |


## Example

### curl

```bash
curl -X GET "https://api.unusualwhales.com/api/congress/unusual-trades" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/congress/unusual-trades", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))
```

## Response Example

```json
{
  "data": [
    {
      "amount": "$1,001 - $15,000",
      "asset": "NVIDIA Corp - Common Stock",
      "asset_type": "stock",
      "company_name": "NVIDIA Corp",
      "description": "string"
    }
  ]
}
```