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

# ScreenerTickerInfoState

> Company and security metadata for the ticker. Decimal fields are absent when their source value is unavailable.

Message
fields**18**
used by[StockScreenerState](/docs/kafka/types/StockScreenerState.md)

**Proto definition**

```protobuf schema.proto theme={null}
message ScreenerTickerInfoState {
  Decimal company_marketcap = 1;
  Decimal company_outstanding = 2;
  Date next_earnings_date = 3;
  optional AnnounceTime er_time = 4;
  optional Sector sector = 5;
  Date next_dividend_date = 6;
  Decimal avg30_volume = 7;
  Decimal rv_1d_last_12q = 8;
  Decimal week_52_high = 9;
  Decimal week_52_low = 10;
  optional string industry_type = 11;
  bool has_options = 12;
  Decimal short_int = 13;
  optional bool is_s_p_500 = 14;
  optional uint32 years_reducing_shares_outstanding = 15;
  optional uint32 years_increased_dividend = 16;
  optional Decimal beta = 17;
  optional RegShoStatus reg_sho_status = 18;
}
```

## Fields

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

company\_marketcap
[Decimal](/docs/kafka/types/Decimal.md)
1

Stored company market value in dollars. For ETFs the source uses latest assets under management. Other issue types generally use shares outstanding multiplied by a regular-session close, subject to source fallback checks.

company\_outstanding
[Decimal](/docs/kafka/types/Decimal.md)
2

Shares outstanding from the latest available stock report, with company metadata as a fallback. The value is a share count.

next\_earnings\_date
[Date](/docs/kafka/types/Date.md)
3

Next scheduled earnings date. Absent when unknown.

er\_time
[AnnounceTime](/docs/kafka/types/AnnounceTime.md)
optional
4

Earnings announcement timing. Absent when no timing is available.

sector
[Sector](/docs/kafka/types/Sector.md)
optional
5

Company sector. Absent when unavailable.

next\_dividend\_date
[Date](/docs/kafka/types/Date.md)
6

Next scheduled ex-dividend date. Absent when unknown.

avg30\_volume
[Decimal](/docs/kafka/types/Decimal.md)
7

Average regular-session share volume for observations later than 30 calendar days before the latest market open. This is not exactly 30 trading sessions.

rv\_1d\_last\_12q
[Decimal](/docs/kafka/types/Decimal.md)
8

Arithmetic mean of abs(one-day post-earnings fractional return / expected move fraction) over up to the 12 most recent earlier earnings reports. Reports with a missing realized move, missing expected move, or zero expected move do not contribute. A value of 1 means the realized absolute move equaled the expected move on average. Rounded to six decimal places.

week\_52\_high
[Decimal](/docs/kafka/types/Decimal.md)
9

Maximum split-adjusted regular-session high among observations later than one calendar year before the latest market open.

week\_52\_low
[Decimal](/docs/kafka/types/Decimal.md)
10

Minimum split-adjusted regular-session low among observations later than one calendar year before the latest market open.

industry\_type
string
optional
11

Free-form company industry label. Absent when unknown.

has\_options
bool
12

True when metadata says the security has listed equity options. False also represents unavailable metadata because this field has no protobuf presence.

short\_int
[Decimal](/docs/kafka/types/Decimal.md)
13

Short interest as a fraction of public float. For example, 0.086 means 8.6 percent.

is\_s\_p\_500
bool
optional
14

Whether the ticker is an S\&P 500 constituent. Absent when unavailable.

years\_reducing\_shares\_outstanding
uint32
optional
15

Number of consecutive year-to-year decreases ending with the latest year in the stock-report data. Each year uses its minimum reported shares outstanding. Zero can mean no annual data or no consecutive decrease.

years\_increased\_dividend
uint32
optional
16

Number of consecutive completed calendar years in which the annual sum of regular dividends increased. Irregular, special, final, interim, and unspecified dividends are excluded. Some tickers use a stored historical baseline because the full history is unavailable. Zero can mean no qualifying history or no consecutive increase.

beta
[Decimal](/docs/kafka/types/Decimal.md)
optional
17

Beta against SPY from up to one year of daily returns including dividends, taken from the latest daily calculation on or before the parent state date. A value of 1.2 means the ticker moved 1.2 times as much as SPY on average. Absent when unavailable.

reg\_sho\_status
[RegShoStatus](/docs/kafka/types/RegShoStatus.md)
optional
18

Latest Reg SHO short sale price test state reported by Nasdaq for the parent state date. Absent when no state was reported for that date.