# Unusual Options Activity Scraper — Stocks, ETFs & Indices (`bovi/unusual-options-activity`) Actor

Pull today's unusual options activity for stocks, ETFs or indices in one call. One clean record per signal — ticker, type, strike, expiration, volume, open interest, Vol/OI, IV. Filter by call/put, min volume or Vol/OI. Pay once per run.

- **URL**: https://apify.com/bovi/unusual-options-activity.md
- **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 85.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $960.30 / 1,000 unusual options tables

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Unusual Options Activity Scraper — Stocks, ETFs & Indices

Get today's **unusual options activity** in one call. Pick an asset class
(stocks, ETFs or indices) and the actor returns **one clean record per option
signal** — ready to pipe into a screener, alerting bot, or trading model.
**Pay once per run** — no login, no external proxy key.

### What you get (one record per signal)

| Field | Description |
|---|---|
| `ticker` | Underlying symbol (e.g. `AAPL`, `SPY`) |
| `optionSymbol` | Full option contract symbol |
| `optionType` | `Call` or `Put` |
| `strike` | Strike price |
| `expiration` | Expiration date |
| `daysToExpiry` | Days to expiration (DTE) |
| `underlyingPrice` | Underlying price at scrape time |
| `moneyness` | % in/out of the money |
| `bid` / `ask` / `lastPrice` | Quote at scrape time |
| `volume` | Contract volume |
| `openInterest` | Open interest |
| `volumeOIRatio` | Volume ÷ open interest — the unusual-activity signal |
| `impliedVolatility` | Implied volatility (%) |
| `volatility` | Historical volatility (%) |
| `delta` | Option delta (greek) |
| `lastTradeTime` | Last trade timestamp |
| `assetClass` / `source` | Which board the signal came from |

**Clean dataset, by design.** The dataset holds **only signals** — the
per-run summary (counts, filters, timestamp) is written to the run's `OUTPUT`,
not mixed into your data as a junk row. Pipe the dataset straight into your
tools without filtering anything out first.

### Input

| Field | Type | Notes |
|---|---|---|
| `assetClass` | select | `stocks` (default), `etfs`, or `indices`. |
| `optionType` | select | `all` (default), `call`, or `put`. |
| `maxResults` | integer | Cap on signals returned. Default `100`. |
| `minVolume` | integer | Optional. Keep signals with volume ≥ this. `0` = off. |
| `minVolumeOIRatio` | integer | Optional. Keep signals with Vol/OI ≥ this. `0` = off. |
| `proxyConfiguration` | proxy | Default Apify **Residential**. |

#### Example

```json
{
  "assetClass": "stocks",
  "optionType": "call",
  "maxResults": 50,
  "minVolumeOIRatio": 3
}
````

### How it works

1. Opens the unusual-activity board for the chosen asset class through a
   residential proxy.
2. Lets the page complete its own session handshake and read its activity
   feed, captures that feed, and maps it to a clean schema. If the feed is
   unavailable it falls back to reading the rendered table **structurally** —
   by column header, never by CSS class — so it keeps working when the page is
   restyled.
3. Drops footer/summary rows, applies your filters, and returns one clean
   record per signal.

### Notes

- Unusual options activity is most populated during US market hours.
- Billing event: `unusual-options-table` — one flat charge per run that
  returns at least one signal.

### More scrapers from our toolkit

Building a data pipeline? These actors pair well with this one — each runs on your own Apify account with the same pay-per-result pricing, no subscription:

- [Companies France](https://apify.com/bovi/companies-france)
- [Companies House UK Scraper](https://apify.com/bovi/companies-house-uk)
- [Crunchbase Scraper](https://apify.com/bovi/crunchbase-scraper)
- [Seeking Alpha Scraper](https://apify.com/bovi/seeking-alpha-scraper)
- [Transfermarkt Scraper](https://apify.com/bovi/transfermarkt-scraper)
- [Yahoo Finance Scraper](https://apify.com/bovi/yahoo-finance-scraper)

Chain any of them together from the **Integrations** tab (the *Run succeeded* trigger) to build a multi-step workflow — one actor's output feeds the next.

### Use it from your existing tools

#### Use with Claude Desktop / Cursor / Cline (MCP)

Load this actor as a tool in your AI assistant. Call it directly from your AI assistant via the Apify MCP server — no Store browsing needed. Paste this into your MCP client config (e.g. `claude_desktop_config.json`) and restart the client:

```json
{
  "mcpServers": {
    "apify-unusual-options-activity": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--tools",
        "bovi/unusual-options-activity"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}
```

Replace `YOUR_APIFY_TOKEN` with your own Apify API token (free at apify.com → Settings → Integrations). Curated to a handful of tools so the agent selects reliably.

#### Works with Clay

Run this actor as an HTTP enrichment step inside a Clay table:

- **Method:** `POST`
- **URL:** `https://api.apify.com/v2/acts/bovi~unusual-options-activity/run-sync-get-dataset-items?token={{apify_token}}`
- **Body (JSON):** map your Clay columns to the actor input (see the Input section above), e.g. `{"assetClass": "{{clay_column}}"}`

The run finishes synchronously and returns the dataset rows straight into your Clay table. It runs on Apify's cloud under your own token and usage. Synchronous runs must complete within 300 seconds.

# Actor input Schema

## `assetClass` (type: `string`):

Which unusual-activity board to scrape.

## `optionType` (type: `string`):

Keep only calls, only puts, or both.

## `maxResults` (type: `integer`):

Cap on the number of option signals returned in one run.

## `minVolume` (type: `integer`):

Optional. Keep only signals whose contract volume is at least this. 0 = no filter.

## `minVolumeOIRatio` (type: `integer`):

Optional. Keep only signals whose volume-to-open-interest ratio is at least this. 0 = no filter.

## `maxPages` (type: `integer`):

Safety cap on how many table pages to render per run. Most runs need 1.

## `proxyConfiguration` (type: `object`):

The site requires a residential proxy for reliable access. Defaults to Apify Residential proxy — no setup needed.

## Actor input object example

```json
{
  "assetClass": "stocks",
  "optionType": "all",
  "maxResults": 100,
  "minVolume": 0,
  "minVolumeOIRatio": 0,
  "maxPages": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset of unusual options signals (ticker, optionSymbol, optionType, strike, expiration, daysToExpiry, underlyingPrice, moneyness, bid, ask, lastPrice, volume, openInterest, volumeOIRatio, impliedVolatility, volatility, delta, lastTradeTime, assetClass, source).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxResults": 100,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("bovi/unusual-options-activity").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxResults": 100,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("bovi/unusual-options-activity").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call bovi/unusual-options-activity --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=bovi/unusual-options-activity",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Unusual Options Activity Scraper — Stocks, ETFs & Indices",
        "description": "Pull today's unusual options activity for stocks, ETFs or indices in one call. One clean record per signal — ticker, type, strike, expiration, volume, open interest, Vol/OI, IV. Filter by call/put, min volume or Vol/OI. Pay once per run.",
        "version": "0.1",
        "x-build-id": "BqNiHuu4xdQhhkPk2"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/bovi~unusual-options-activity/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-bovi-unusual-options-activity",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/bovi~unusual-options-activity/runs": {
            "post": {
                "operationId": "runs-sync-bovi-unusual-options-activity",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/bovi~unusual-options-activity/run-sync": {
            "post": {
                "operationId": "run-sync-bovi-unusual-options-activity",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "assetClass": {
                        "title": "Asset class",
                        "enum": [
                            "stocks",
                            "etfs",
                            "indices"
                        ],
                        "type": "string",
                        "description": "Which unusual-activity board to scrape.",
                        "default": "stocks"
                    },
                    "optionType": {
                        "title": "Option type",
                        "enum": [
                            "all",
                            "call",
                            "put"
                        ],
                        "type": "string",
                        "description": "Keep only calls, only puts, or both.",
                        "default": "all"
                    },
                    "maxResults": {
                        "title": "Max signals",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Cap on the number of option signals returned in one run.",
                        "default": 100
                    },
                    "minVolume": {
                        "title": "Minimum volume",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Optional. Keep only signals whose contract volume is at least this. 0 = no filter.",
                        "default": 0
                    },
                    "minVolumeOIRatio": {
                        "title": "Minimum Vol/OI ratio",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Optional. Keep only signals whose volume-to-open-interest ratio is at least this. 0 = no filter.",
                        "default": 0
                    },
                    "maxPages": {
                        "title": "Max pages to render",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "Safety cap on how many table pages to render per run. Most runs need 1.",
                        "default": 5
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "The site requires a residential proxy for reliable access. Defaults to Apify Residential proxy — no setup needed.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```