Options Unusual Activity by Symbol

Retrieve options unusual activity for a specific underlying symbol (e.g. AAPL, TSLA). Returns options unusual activity data such as unusual volume and block trades.

Use Case: Show unusual options activity for a single underlying (e.g. on a stock detail page) to surface notable call/put flow and block trades.

GET /v1/options/unusual_activity/{symbol}

Get Options Unusual Activity by Symbol

cURL

curl --request GET \
  --url https://api.aries.com/v1/options/unusual_activity/{symbol} \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "trades": [
    {
      "symbol": "AAPL",
      "timestamp": "2026-02-25T20:55:00.1041000+00:00",
      "type": "block",
      "total_value": 143000.0019,
      "total_size": 200,
      "average_price": 7.15,
      "contract": "AAPL__260306P00280000",
      "ask_at_execution": 7.15,
      "bid_at_execution": 6.95,
      "sentiment": "bearish",
      "underlying_price_at_execution": 274.59
    }
  ],
  "next_page": "https://api.aries.com/v1/options/unusual_activity/AAPL?next_page=eyJwYWdlIjoyfQ=="
}

Path parameter

Parameter	Type	Required	Description
symbol	string	Yes	Underlying stock symbol (e.g. AAPL, TSLA).

Response

Success returns 200 OK with a JSON object containing a trades array. Each trade includes:

Field	Type	Description
symbol	string	Underlying symbol (e.g. AAPL)
timestamp	string	Trade timestamp (ISO 8601)
type	string	Trade type (e.g. block)
total_value	number	Total dollar value of the trade
total_size	number	Total contract size
average_price	number	Average price per contract
contract	string	Option contract identifier
ask_at_execution	number	Ask price at execution
bid_at_execution	number	Bid price at execution
sentiment	string	Sentiment (e.g. bearish, bullish)
underlying_price_at_execution	number	Underlying price at execution

Example response:

{
  "trades": [
    {
      "symbol": "AAPL",
      "timestamp": "2026-02-25T20:55:00.1041000+00:00",
      "type": "block",
      "total_value": 143000.0019,
      "total_size": 200,
      "average_price": 7.15,
      "contract": "AAPL__260306P00280000",
      "ask_at_execution": 7.15,
      "bid_at_execution": 6.95,
      "sentiment": "bearish",
      "underlying_price_at_execution": 274.59
    }
  ]
}

Errors: 400 when symbol is missing or invalid, 401 unauthorized, 500 when the feature is not available or server error.

Authorizations

Authorization · string · header · required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Path Parameters

symbol · string · required

Underlying stock symbol (e.g. AAPL, TSLA).

Response

200

application/json

Options unusual activity: object with trades array. Each trade has symbol, timestamp, type (e.g. block), total_value, total_size, average_price, contract, ask_at_execution, bid_at_execution, sentiment, underlying_price_at_execution.

Response for GET /v1/options/unusual_activity/{symbol}. Contains unusual activity trades and optional pagination pointer.

trades · object[]

List of unusual options activity trades

Show child attributes

next_page · string | null

Absolute link to the next page when more results are available.