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

# StockScreenerState

> Latest assembled stock-screener state for a ticker. option_flow and memberships are present in each published payload. Other nested messages are absent when their source group has no value. Individual Decimal fields are absent when unavailable unless their nested-message comments describe a zero fallback.

Message
fields**19**
topic[stock-screener](/docs/kafka/topics/stock-screener.md)

**Proto definition**

```protobuf schema.proto theme={null}
message StockScreenerState {
  Ticker ticker = 1;
  Date date = 2;
  ScreenerOptionFlowState option_flow = 3;
  ScreenerStockState stock = 4;
  ScreenerInterpolatedIvState interpolated_iv = 5;
  ScreenerIvRankState iv_rank = 6;
  ScreenerTickerInfoState ticker_info = 7;
  ScreenerFlexState flex = 8;
  ScreenerGexState gex = 9;
  ScreenerPerformanceState performance = 10;
  ScreenerVolatilityState volatility = 11;
  ScreenerMembershipsState memberships = 12;
  ScreenerEtfState etf = 13;
  ScreenerEarningsState earnings = 14;
  ScreenerSharesState shares = 15;
  ScreenerDividendState dividend = 16;
  ScreenerInsiderState insider = 17;
  TwoSidedQuote quote = 18;
  TaIndicatorValues daily_ta = 19;
}
```

## Fields

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

ticker
[Ticker](/docs/kafka/types/Ticker.md)
1

Ticker represented by this screener state and the Kafka message key. The issue type is absent when the producer has not classified the ticker.

date
[Date](/docs/kafka/types/Date.md)
2

New York trading date represented by this state.

option\_flow
[ScreenerOptionFlowState](/docs/kafka/types/ScreenerOptionFlowState.md)
3

Option flow metrics.

stock
[ScreenerStockState](/docs/kafka/types/ScreenerStockState.md)
4

Latest accepted stock-session metrics. Prices can come from premarket, regular, or postmarket, and the nested message does not identify the session.

interpolated\_iv
[ScreenerInterpolatedIvState](/docs/kafka/types/ScreenerInterpolatedIvState.md)
5

Fixed calendar-day expected-move and implied-volatility metrics.

iv\_rank
[ScreenerIvRankState](/docs/kafka/types/ScreenerIvRankState.md)
6

Implied volatility rank and percentile metrics on a 0-through-100 scale.

ticker\_info
[ScreenerTickerInfoState](/docs/kafka/types/ScreenerTickerInfoState.md)
7

Company and security metadata.

flex
[ScreenerFlexState](/docs/kafka/types/ScreenerFlexState.md)
8

Open interest and FLEX option metrics.

gex
[ScreenerGexState](/docs/kafka/types/ScreenerGexState.md)
9

Gamma exposure metrics.

performance
[ScreenerPerformanceState](/docs/kafka/types/ScreenerPerformanceState.md)
10

Price performance metrics.

volatility
[ScreenerVolatilityState](/docs/kafka/types/ScreenerVolatilityState.md)
11

Realized volatility metrics.

memberships
[ScreenerMembershipsState](/docs/kafka/types/ScreenerMembershipsState.md)
12

ETF and option flow group memberships.

etf
[ScreenerEtfState](/docs/kafka/types/ScreenerEtfState.md)
13

ETF specific metrics.

earnings
[ScreenerEarningsState](/docs/kafka/types/ScreenerEarningsState.md)
14

Historical EPS growth metrics.

shares
[ScreenerSharesState](/docs/kafka/types/ScreenerSharesState.md)
15

Shares outstanding and historical quarterly growth metrics.

dividend
[ScreenerDividendState](/docs/kafka/types/ScreenerDividendState.md)
16

Latest dividend and current yield metrics.

insider
[ScreenerInsiderState](/docs/kafka/types/ScreenerInsiderState.md)
17

Discretionary insider purchase and sale share volumes.

quote
[TwoSidedQuote](/docs/kafka/types/TwoSidedQuote.md)
18

Latest best bid and ask quote. Absent until a quote with a nonzero source time is available for the ticker.

daily\_ta
[TaIndicatorValues](/docs/kafka/types/TaIndicatorValues.md)
19

Regular-session daily technical indicators for the parent date. During trading these describe the forming daily candle.