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

# ScreenerSharesState

> Latest shares outstanding and fractional changes against earlier report rows. Report periods are not included in this message. Startup excludes reports with missing shares before selecting row offsets. Live snapshots can include those reports in the offsets, so growth values can change after a restart.

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

**Proto definition**

```protobuf schema.proto theme={null}
message ScreenerSharesState {
  Decimal shares_outstanding = 1;
  Decimal shares_outstanding_growth_4q = 2;
  Decimal shares_outstanding_growth_8q = 3;
  Decimal shares_outstanding_growth_12q = 4;
}
```

## Fields

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

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

Latest available shares outstanding. Company metadata is used when the selected report has no value. The value is a share count.

shares\_outstanding\_growth\_4q
[Decimal](https://api.unusualwhales.com/docs/kafka/types/Decimal.md)
2

(current\_shares - shares\_4\_rows\_earlier) / abs(shares\_4\_rows\_earlier). Absent when either value is unavailable or the earlier value is zero.

shares\_outstanding\_growth\_8q
[Decimal](https://api.unusualwhales.com/docs/kafka/types/Decimal.md)
3

(current\_shares - shares\_8\_rows\_earlier) / abs(shares\_8\_rows\_earlier). Absent when either value is unavailable or the earlier value is zero.

shares\_outstanding\_growth\_12q
[Decimal](https://api.unusualwhales.com/docs/kafka/types/Decimal.md)
4

(current\_shares - shares\_12\_rows\_earlier) / abs(shares\_12\_rows\_earlier). Absent when either value is unavailable or the earlier value is zero.