Unusual Whales: Get Flow Alerts
Get unusual options flow alerts. Detects large or unusual options trades including sweeps, large premiums, and abnormal volume. Ideal for: monitoring smart money options activity, detecting institutional positioning, triggering alerts on unusual options volume.
Catalog action Blockchain Data
Get unusual options flow alerts. Detects large or unusual options trades including sweeps, large premiums, and abnormal volume. Ideal for: monitoring smart money options activity, detecting institutional positioning, triggering alerts on unusual options volume.
At a Glance
| Field | Value |
|---|---|
| Action ID | unusualwhales-get-flow-alerts |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | options, flow, alerts, market-data, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
ticker | string | No | Filter by ticker symbol (e.g., 'AAPL', 'TSLA') |
date | string | No | Filter by date (YYYY-MM-DD format). Defaults to current market day |
limit | number | No | Maximum number of alerts to return |
minPremium | number | No | Minimum total premium filter in USD |
maxPremium | number | No | Maximum total premium filter in USD |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
alerts | array | Yes | List of unusual options flow alerts |
Examples
json{ "type": "unusualwhales-get-flow-alerts", "payload": { "ticker": "example-ticker", "date": "2026-04-25T12:00:00Z", "limit": 1, "minPremium": 1, "maxPremium": 1 }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/unusualwhales-get-flow-alerts/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "ticker": "example-ticker", "date": "2026-04-25T12:00:00Z", "limit": 1, "minPremium": 1, "maxPremium": 1 }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.