> ## 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

# ScreenerIvRankState

> Rank and percentile statistics for 30-calendar-day implied volatility. Values use a scale from 0 through 100.

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

**Proto definition**

```protobuf schema.proto theme={null}
message ScreenerIvRankState {
  Decimal iv_rank = 1;
  Decimal iv_rank_1m = 2;
  Decimal iv_percentile_1m = 3;
  Decimal iv_percentile_1y = 4;
}
```

## Fields

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

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

Rank over observations later than one calendar year before the parent state date. Calculated as 100 \* (current - minimum) / (maximum - minimum). Absent when maximum equals minimum or the source value is unavailable.

iv\_rank\_1m
[Decimal](https://api.unusualwhales.com/docs/kafka/types/Decimal.md)
2

Rank over observations later than 30 calendar days before the parent state date. Calculated as 100 \* (current - minimum) / (maximum - minimum). Absent when maximum equals minimum or the source value is unavailable.

iv\_percentile\_1m
[Decimal](https://api.unusualwhales.com/docs/kafka/types/Decimal.md)
3

Percent rank within observations later than 30 calendar days before the parent state date, multiplied by 100. Tied values share a rank.

iv\_percentile\_1y
[Decimal](https://api.unusualwhales.com/docs/kafka/types/Decimal.md)
4

Percent rank within observations later than one calendar year before the parent state date, multiplied by 100. Tied values share a rank.