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

# PredictionsInsider

> A potential insider signal: a fresh, low-activity account taking an unusually large position in a single market. Published to the `predictions-insiders` Kafka topic each time insider detection runs; an existing signal is re-published when its underlying position changes. A position is flagged when all of the following hold: - its cost basis is at least $1,000, at an average entry price of at most $0.90 per share, and its realized loss is no worse than -$100 - the account holds fewer than 5 distinct positions - the account's first observed trade was fewer than 20 days ago

Message
fields**17**
topic[predictions-insiders](/docs/kafka/topics/predictions-insiders.md)

**Proto definition**

```protobuf schema.proto theme={null}
message PredictionsInsider {
  int64 user_id = 1;
  int64 asset_id = 2;
  int64 question_id = 3;
  int32 n_positions = 4;
  int32 days_since_first_trade = 5;
  Decimal total_invested_usd = 6;
  Decimal avg_price = 7;
  Decimal mean_invested_usd = 8;
  Decimal std_invested_usd = 9;
  Decimal invested_zscore = 10;
  Category category = 11;
  optional string username = 12;
  optional string question = 13;
  optional string outcome_label = 14;
  optional string user_address = 15;
  optional string token_id = 16;
  Decimal realized_pnl = 17;
}
```

## Fields

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

user\_id
int64
1

Internal numeric id of the flagged user's wallet. Same id space as PredictionsTrade.maker\_id/taker\_id and PredictionsPosition.user\_id.

asset\_id
int64
2

Internal numeric id of the outcome token the position is in. Same id space as PredictionsTrade.asset\_id and PredictionsPosition.asset\_id.

question\_id
int64
3

Internal numeric id of the market (question) the token belongs to.

n\_positions
int32
4

Number of distinct outcome tokens the user holds positions in, across all markets. Always fewer than 5 by construction.

days\_since\_first\_trade
int32
5

Days since the user's first observed trade. Always fewer than 20 by construction.

total\_invested\_usd
[Decimal](/docs/kafka/types/Decimal.md)
6

USDC the user invested in this token (cost basis of the position).

avg\_price
[Decimal](/docs/kafka/types/Decimal.md)
7

User's average entry price per share, in USDC (between 0 and 1).

mean\_invested\_usd
[Decimal](/docs/kafka/types/Decimal.md)
8

Mean invested USDC across all positions held in this token — the market baseline the user is compared against.

std\_invested\_usd
[Decimal](/docs/kafka/types/Decimal.md)
9

Population standard deviation of invested USDC across all positions held in this token.

invested\_zscore
[Decimal](/docs/kafka/types/Decimal.md)
10

How unusual the position size is versus the market baseline: (total\_invested\_usd - mean\_invested\_usd) / std\_invested\_usd, or 0 when std\_invested\_usd is 0. Values >= 2.0 are treated as strong insider signals.

category
[Category](/docs/kafka/types/Category.md)
11

Category of the market's question.

username
string
optional
12

Polymarket username of the user, when known.

question
string
optional
13

Text of the market's question (e.g. "Will X win the election?"), when known.

outcome\_label
string
optional
14

Label of the outcome the position is on (e.g. "Yes"), when known.

user\_address
string
optional
15

User wallet address (0x-prefixed hex), when known.

token\_id
string
optional
16

Polymarket CTF (ERC-1155) token id of the outcome token, as a decimal string. Matches PredictionsTrade.asset\_address and PredictionsPosition.asset\_address.

realized\_pnl
[Decimal](/docs/kafka/types/Decimal.md)
17

User's realized profit or loss on this token so far, in USDC.