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

# FlowExpiry

> An option activity update grouped by underlying ticker and contract expiry. Updates are published as INCREMENTAL updates for the time window they computed. If you store the data in a database you should be adding the values to the existing values in the database.

Message
fields**23**
topic[flow-expiry](https://api.unusualwhales.com/docs/kafka/topics/flow-expiry.md)

**Proto definition**

```protobuf schema.proto theme={null}
message FlowExpiry {
  string ticker = 1;
  string date = 2;
  string expiry = 3;
  double call_premium = 4;
  double call_premium_ask_side = 5;
  double call_premium_bid_side = 6;
  int64 call_volume = 7;
  int64 call_volume_ask_side = 8;
  int64 call_volume_bid_side = 9;
  int64 call_otm_volume = 10;
  double call_otm_premium = 11;
  double put_premium = 12;
  double put_premium_ask_side = 13;
  double put_premium_bid_side = 14;
  int64 put_volume = 15;
  int64 put_volume_ask_side = 16;
  int64 put_volume_bid_side = 17;
  int64 put_otm_volume = 18;
  double put_otm_premium = 19;
  int64 call_trades = 20;
  int64 put_trades = 21;
  int64 call_otm_trades = 22;
  int64 put_otm_trades = 23;
}
```

## Fields

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

ticker
string
1

The underlying ticker.

date
string
2

The trading date in YYYY-MM-DD format.

expiry
string
3

The option contract expiry in YYYY-MM-DD format.

call\_premium
double
4

Call premium in dollars in the incremental update.

call\_premium\_ask\_side
double
5

Ask-side call premium in dollars in the incremental update.

call\_premium\_bid\_side
double
6

Bid-side call premium in dollars in the incremental update.

call\_volume
int64
7

Call contracts traded in the incremental update.

call\_volume\_ask\_side
int64
8

Call contracts executed on the ask side in the incremental update.

call\_volume\_bid\_side
int64
9

Call contracts executed on the bid side in the incremental update.

call\_otm\_volume
int64
10

Out of the money call contracts traded in the incremental update.

call\_otm\_premium
double
11

Out of the money call premium in dollars in the incremental update.

put\_premium
double
12

Put premium in dollars in the incremental update.

put\_premium\_ask\_side
double
13

Ask-side put premium in dollars in the incremental update.

put\_premium\_bid\_side
double
14

Bid-side put premium in dollars in the incremental update.

put\_volume
int64
15

Put contracts traded in the incremental update.

put\_volume\_ask\_side
int64
16

Put contracts executed on the ask side in the incremental update.

put\_volume\_bid\_side
int64
17

Put contracts executed on the bid side in the incremental update.

put\_otm\_volume
int64
18

Out of the money put contracts traded in the incremental update.

put\_otm\_premium
double
19

Out of the money put premium in dollars in the incremental update.

call\_trades
int64
20

Number of call trades in the incremental update.

put\_trades
int64
21

Number of put trades in the incremental update.

call\_otm\_trades
int64
22

Number of out of the money call trades in the incremental update.

put\_otm\_trades
int64
23

Number of out of the money put trades in the incremental update.