# Unusual Trades by Ticker

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

Returns congressional trades filtered by one or more tickers, with optional date range,
transaction type, and politician name filters. Includes price-at-trade and current-price context.

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



## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `tickers` | string | No | Comma-separated list of tickers to filter by. |
| `transaction_type` | string | No | Filter to either buy- or sell-side transactions. |
| `date_from` | string | No | Inclusive lower bound on transaction_date (ISO 8601). |
| `date_to` | string | No | Inclusive upper bound on transaction_date (ISO 8601). |
| `politician` | string | No | Case-insensitive substring match against the politician's full name. |
| `limit` | integer | No |  |
| `page` | integer | No |  |


## 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/by-tickers" \
  -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/by-tickers", 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"
    }
  ]
}
```