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

> ## Agent Instructions
> API requests use the base URL https://api.unusualwhales.com and require a bearer token in the `Authorization` header (`Authorization: Bearer <API_KEY>`). Create and manage API tokens at https://unusualwhales.com/dashboard/api.
> For live market data inside an AI tool, use the Unusual Whales MCP server at https://unusualwhales.com/public-api/mcp.
> Instructions for agents using Unusual Whales tools: https://unusualwhales.com/skill.md

# ScreenerVolatilityState

> Annualized realized volatility for the parent state date and its paired variance risk premium. Values are fractions, so 0.20 means 20 percent. The realized-volatility window starts 20 market opens before the parent state date and includes both endpoints.

Message
fields**2**
used by[StockScreenerState](https://api.unusualwhales.com/docs/kafka/types/StockScreenerState.md)

**Proto definition**

```protobuf schema.proto theme={null}
message ScreenerVolatilityState {
  Decimal realized_volatility = 1;
  Decimal variance_risk_premium = 2;
}
```

## Fields

The number on the right of each row is the protobuf field number.

realized\_volatility
[Decimal](https://api.unusualwhales.com/docs/kafka/types/Decimal.md)
1

Annualized sample standard deviation of available daily log returns dated from the window start through the parent state date. The inclusive window can contain up to 21 returns. The first return compares the window-start close with the preceding session's close. Calculated as stddev(daily\_log\_returns) \* sqrt(252) and rounded to six decimal places. Absent when fewer than two returns are available.

variance\_risk\_premium
[Decimal](https://api.unusualwhales.com/docs/kafka/types/Decimal.md)
2

Thirty-day implied volatility observed on the window start date minus realized\_volatility. The observation date is not included in this message.