Unusual Options Activity

OptionActivity V1

curl --request GET \
  --url 'https://api.benzinga.com/api/v1/signal/option_activity?token='

const options = {method: 'GET'};

fetch('https://api.benzinga.com/api/v1/signal/option_activity?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.benzinga.com/api/v1/signal/option_activity?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.benzinga.com/api/v1/signal/option_activity?token="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v1/signal/option_activity?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "option_activity": [
    {
      "aggressor_ind": "0.73",
      "ask": "5.75",
      "bid": "5.2",
      "cost_basis": "336000.0",
      "date": "2025-12-29",
      "date_expiration": "2026-09-18",
      "description": "Freeport-McMoRan Option Alert: Sep 18 $50 Puts at the Ask: 600 vs 636 OI; Earnings 1/22 Before Open [est] ",
      "description_extended": "Freeport-McMoRan Option Alert: Sep 18 $50 Puts at the Ask: 600 @ $5.6 vs 636 OI; Earnings 1/22 Before Open [est] Ref=$51.4",
      "exchange": "NYSE",
      "execution_estimate": "AT_ASK",
      "id": "6952ef7b6ab0a40001b39586",
      "midpoint": "5.475",
      "open_interest": "636",
      "option_activity_type": "TRADE",
      "option_symbol": "FCX260918P00050000",
      "price": "5.6",
      "put_call": "PUT",
      "sentiment": "BEARISH",
      "size": "600",
      "strike_price": "50.00",
      "ticker": "FCX",
      "time": "16:15:32",
      "trade_count": 1,
      "underlying_price": "51.4",
      "underlying_type": "STOCK",
      "updated": 1767042939,
      "volume": "1601"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

GET

api

signal

option_activity

OptionActivity V1

curl --request GET \
  --url 'https://api.benzinga.com/api/v1/signal/option_activity?token='

const options = {method: 'GET'};

fetch('https://api.benzinga.com/api/v1/signal/option_activity?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.benzinga.com/api/v1/signal/option_activity?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.benzinga.com/api/v1/signal/option_activity?token="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v1/signal/option_activity?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "option_activity": [
    {
      "aggressor_ind": "0.73",
      "ask": "5.75",
      "bid": "5.2",
      "cost_basis": "336000.0",
      "date": "2025-12-29",
      "date_expiration": "2026-09-18",
      "description": "Freeport-McMoRan Option Alert: Sep 18 $50 Puts at the Ask: 600 vs 636 OI; Earnings 1/22 Before Open [est] ",
      "description_extended": "Freeport-McMoRan Option Alert: Sep 18 $50 Puts at the Ask: 600 @ $5.6 vs 636 OI; Earnings 1/22 Before Open [est] Ref=$51.4",
      "exchange": "NYSE",
      "execution_estimate": "AT_ASK",
      "id": "6952ef7b6ab0a40001b39586",
      "midpoint": "5.475",
      "open_interest": "636",
      "option_activity_type": "TRADE",
      "option_symbol": "FCX260918P00050000",
      "price": "5.6",
      "put_call": "PUT",
      "sentiment": "BEARISH",
      "size": "600",
      "strike_price": "50.00",
      "ticker": "FCX",
      "time": "16:15:32",
      "trade_count": 1,
      "underlying_price": "51.4",
      "underlying_type": "STOCK",
      "updated": 1767042939,
      "volume": "1601"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

{
  "option_activity": [
    {
      "aggressor_ind": "0.73",
      "ask": "5.75",
      "bid": "5.2",
      "cost_basis": "336000.0",
      "date": "2025-12-29",
      "date_expiration": "2026-09-18",
      "description": "Freeport-McMoRan Option Alert: Sep 18 $50 Puts at the Ask: 600 vs 636 OI; Earnings 1/22 Before Open [est] ",
      "description_extended": "Freeport-McMoRan Option Alert: Sep 18 $50 Puts at the Ask: 600 @ $5.6 vs 636 OI; Earnings 1/22 Before Open [est] Ref=$51.4",
      "exchange": "NYSE",
      "execution_estimate": "AT_ASK",
      "id": "6952ef7b6ab0a40001b39586",
      "midpoint": "5.475",
      "open_interest": "636",
      "option_activity_type": "TRADE",
      "option_symbol": "FCX260918P00050000",
      "price": "5.6",
      "put_call": "PUT",
      "sentiment": "BEARISH",
      "size": "600",
      "strike_price": "50.00",
      "ticker": "FCX",
      "time": "16:15:32",
      "trade_count": 1,
      "underlying_price": "51.4",
      "underlying_type": "STOCK",
      "updated": 1767042939,
      "volume": "1601"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

Authorizations

token

string

query

required

Query Parameters

page

integer

default:0

Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date. Default is 0

pageSize

integer

default:100

Number of results returned. Limit 1000

parameters[date]

string<date>

Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest

parameters[date_from]

string<date>

Start date in YYYY-MM-DD format

parameters[date_to]

string<date>

End date in YYYY-MM-DD format

parameters[date_sort]

enum<string>

Sort by date

Available options:

date

parameters[tickers]

string<csv>

One or more ticker symbols separated by a comma. Maximum 50 tickers

parameters[id]

string

parameters[updated]

integer

Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated

Response

Option Activity

aggressor_ind

string

Example:

"1"

ask

string

Example:

"4.35"

bid

string

Example:

"4.25"

cost_basis

string

Example:

"2156000"

date

string

Example:

"2024-01-09"

date_expiration

string

Example:

"2024-01-19"

description

string

Example:

"Trade"

description_extended

string

Example:

"Sweep | Bullish | Above Ask"

exchange

string

Example:

"NASDAQ"

execution_estimate

string

Example:

"Above Ask"

string

Example:

"60a7f5e8e4b0f5a3c8e9f5ad"

midpoint

string

Example:

"4.30"

open_interest

string

Example:

"1523"

option_activity_type

string

Example:

"Sweep"

option_symbol

string

Example:

"AAPL240119C00195000"

price

string

Example:

"4.31"

put_call

string

Example:

"Call"

sentiment

string

Example:

"Bullish"

size

string

Example:

"500"

strike_price

string

Example:

"195.00"

ticker

string

Example:

"AAPL"

time

string

Time of the option activity (EST)

Example:

"14:35:22"

trade_count

integer

Example:

1

underlying_price

string

Example:

"185.92"

underlying_type

string

Example:

"Common Stock"

updated

integer

Example:

1704819600

volume

string

Example:

"2845"

API Documentation

Guides

Analyst Insights

Bars

Bulls Say Bears Say

Calendars

Company Fundamentals

Corporate Logos

Conference Call Transcripts

Delayed Quotes

Government Trades

Insider Transactions

Market Data

Newsfeed

NewsQuantified

Press Releases

Ticker Trends

Why Is It Moving (WIIMs)

Authorizations

Query Parameters

Response