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

# ThirteenFAlert

> A summary of an institution's quarterly 13F report: position counts, bought/sold values and the top holdings by category.

Message
fields**25**
topic[sec-filings](/docs/kafka/topics/sec-filings.md)

**Proto definition**

```protobuf schema.proto theme={null}
message ThirteenFAlert {
  string name = 1;
  string short_name = 2;
  string cik = 3;
  repeated string tags = 4;
  repeated string people = 5;
  int64 stock_positions = 6;
  int64 stock_added_to_positions = 7;
  int64 stock_reduced_positions = 8;
  int64 stock_new_positions = 9;
  int64 stock_closed_positions = 10;
  int64 stock_buy_avg_weighted_prem = 11;
  int64 stock_sell_avg_weighted_prem = 12;
  repeated string top_ten_holdings = 13;
  string report_date = 14;
  string ticker = 15;
  repeated string top_ten_closed_holdings = 16;
  repeated string top_ten_new_holdings = 17;
  repeated string top_ten_added_holdings = 18;
  repeated string top_ten_reduced_holdings = 19;
  int64 total_value = 20;
  int64 share_value = 21;
  bool holds_options = 22;
  string document_url = 23;
  int64 option_changed_positions = 24;
  repeated ThirteenFOptionHolding option_holdings = 25;
}
```

## Fields

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

name
string
1

the name of the filing institution

short\_name
string
2

the short name of the filing institution (e.g. 'Vanguard' for 'VANGUARD GROUP INC')

cik
string
3

the CIK of the filing institution

tags
string
repeated
4

tags associated with the institution (e.g. hedge-fund)

people
string
repeated
5

people associated with the institution (e.g. 'Bill Ackman' for 'PERSHING SQUARE CAPITAL MANAGEMENT, L.P.')

stock\_positions
int64
6

number of distinct stock/fund positions in the institution's latest 13F report

stock\_added\_to\_positions
int64
7

number of existing positions the institution added to this quarter (units increased, not new positions)

stock\_reduced\_positions
int64
8

number of positions the institution reduced but still holds this quarter (units decreased, remaining units > 0)

stock\_new\_positions
int64
9

number of new positions the institution opened this quarter

stock\_closed\_positions
int64
10

number of positions the institution fully exited this quarter (remaining units == 0)

stock\_buy\_avg\_weighted\_prem
int64
11

total USD value of shares bought this quarter

stock\_sell\_avg\_weighted\_prem
int64
12

total USD value of shares sold this quarter

top\_ten\_holdings
string
repeated
13

tickers (stocks only) of the ten largest currently-held positions, by reported value

report\_date
string
14

the filing's report period end date

ticker
string
15

the institution's own stock ticker, if it is itself a public company with options (empty otherwise)

top\_ten\_closed\_holdings
string
repeated
16

tickers (stocks only) of the ten largest positions fully exited this quarter, by sold value

top\_ten\_new\_holdings
string
repeated
17

tickers (stocks only) of the ten largest newly-opened positions this quarter, by reported value

top\_ten\_added\_holdings
string
repeated
18

tickers (stocks only) of the ten largest added-to positions this quarter, by bought value

top\_ten\_reduced\_holdings
string
repeated
19

tickers (stocks only) of the ten largest reduced (but still held) positions this quarter, by sold value

total\_value
int64
20

total USD value of all reported 13F holdings (across all security types) REMARK: since options are reported with their notional value, any instituion that holds options will/might have a very bloated up total value that does not really represent the actual value they hold. Use this value with care.

share\_value
int64
21

total USD value of share and fund holdings only (excludes options, warrants, debt, etc.)

holds\_options
bool
22

whether the institution holds put/call options

document\_url
string
23

URL to the filing on SEC EDGAR

option\_changed\_positions
int64
24

Number of option positions whose units changed in this report period, including opened and fully closed positions. Zero also represents older producer messages that do not supply this field.

option\_holdings
[ThirteenFOptionHolding](/docs/kafka/types/ThirteenFOptionHolding.md)
repeated
25

Open option holdings, including unchanged holdings, and positions closed during this report period (units == 0 with a nonzero units\_changed). Holdings without a resolved ticker or call/put type are omitted. The option\_changed\_positions count includes those omitted holdings.