Recent flows
Returns the latest flows for the given ticker. Optionally a min premium and a side can be supplied in the query for further filtering.
For real time streaming of option trades for a ticker, subscribe to the option_trades:<TICKER> websocket channel, see https://api.unusualwhales.com/docs/websocket/option-trades.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
A single ticker
"AAPL"
Query Parameters
The side of a stock trade. Must be one of ASK, BID, MID. If not set, will return all side's trades.
ALL, ASK, BID, MID "ASK"
The minimum premium requested trades should have.
x >= 050000
Response
The flow data per expiry for a trading day.
The sum of the premium of all the out the money (OTM) call transactions that executed.
"9908777.0"
The amount of out the money (OTM) call transactions that executed.
6338
The sum of the size of all the out the money (OTM) call transactions that executed.
40385
The sum of the premium of all the call transactions that executed.
"9908777.0"
The sum of the premium of all the call transactions that executed on the ask side.
"5037703.0"
The sum of the premium of all the call transactions that executed on the bid side.
"4055973.0"
The amount of call transactions that executed.
6338
The sum of the size of all the call transactions that executed.
990943
The sum of the size of all the call transactions that executed on the ask side.
417251
The sum of the size of all the call transactions that executed on the bid side.
498271
A trading date in ISO format.
"2023-09-08T00:00:00.000Z"
The contract expiry date in ISO format.
"2023-12-22T00:00:00.000Z"
The sum of the premium of all the out the money (OTM) put transactions that executed.
"1204570.0"
The amount of out the money (OTM) put transactions that executed.
4270
The sum of the size of all the out the money (OTM) put transactions that executed.
12638
The sum of the premium of all the put transactions that executed.
"163537151"
The sum of the premium of all the put transactions that executed on the ask side.
"799873.0"
The sum of the premium of all the put transactions that executed on the bid side.
"4055973.0"
The amount of put transactions that executed.
841
The sum of the size of all the put transactions that executed.
808326
The sum of the size of all the put transactions that executed on the ask side.
431791
The sum of the size of all the put transactions that executed on the bid side.
314160
The stock ticker.
"AAPL"
