> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Unusual Whales: Market News

Triggers on market news headlines and Truth Social posts via Unusual Whales in real-time via WebSocket. Optionally filter by tagged ticker or source type.

Trigger Other

Triggers on market news headlines and Truth Social posts via Unusual Whales in real-time via WebSocket. Optionally filter by tagged ticker or source type.

## At a Glance

| Field | Value |
| --- | --- |
| Trigger ID | `unusual-whales-market-news` |
| Category | Other |
| Tags | `news`, `headlines`, `market-data`, `websocket`, `real-time` |

## Trigger Configuration

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `tickers` | `array` | No | Optional ticker filter. Only news tagged with these tickers will trigger. Note: ticker tagging is done by the upstream source and may include false positives \(e.g. 'CDC' in a health headline, 'UAE' in a geopolitics headline\). Consider adding a Filter or AI action after this trigger to verify the headline is actually about the stock. |
| `source` | `string` | No | Optional source filter. Only news from this source will trigger. |
| `isMajor` | `boolean` | No | If true, only major/breaking stories will trigger. Filters out minor press releases and noise. |

## Trigger Result

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `headline` | `string` | Yes | Full headline or post text |
| `timestamp` | `string` | Yes | Publication time \(ISO 8601\) |
| `source` | `string` | Yes | News source \(Tradex, NYT, Benzinga, etc.\) |
| `tickers` | `array` | Yes | Tagged ticker symbols |
| `isTrumpTs` | `boolean` | Yes | Whether this is a Trump Truth Social post |
| `isMajor` | `boolean` | Yes | Whether this is a major/breaking story |
| `sentiment` | `string` | No | Sentiment analysis \(e.g., bullish, bearish, neutral\) |
| `tags` | `array` | No | Tags assigned by the source |
| `meta` | `object` | No | Additional metadata from the source \(e.g., ticker price context\) |

## Workflow Root Example

```json
{
  "nodes": {
    "root": {
      "type": "unusual-whales-market-news",
      "payload": {
        "tickers": [],
        "source": "Tradex",
        "isMajor": true
      },
      "children": [
        "log_event"
      ]
    },
    "log_event": {
      "type": "log",
      "payload": {
        "message": "Triggered at {{$trigger.triggeredAt}}"
      },
      "children": []
    }
  }
}
```

**Reference trigger output**

Downstream nodes can use `{{$trigger.triggeredAt}}` and any result fields listed above. Event triggers usually expose the raw source payload under a field such as `event`, `body`, `trade`, or `raw`.