Data Schema Reference
High-level overview of TradingFlow data: option flow tables, option chain, symbol metadata, and user persistence.
This article summarizes the main data stores behind TradingFlow. For definitions of fields like side, sentiment, dex, and dei, see Options and Flow Concepts and Greeks and GEX.
ClickHouse: Options and Market Data
AggregatedOptionTrades
Real-time option trades in aggregated form: trades in the same option in the same second are merged into one row. Use for block detection and unusual flow.
Main columns: symbol, option_symbol, put_call, strike, expiration_date, size, trade_count, premium, side, sentiment, moneyness, delta, gamma, dex, dei, iv, oi, underlying_price, time, date.
Partition: by date. Order: symbol, date, time.
RawOptionTrades
Unaggregated option trades (raw Time & Sales). Use when you need exact trade-level timestamps and no aggregation.
Main columns: symbol, put_call, strike, expiration_date, size, price, time (millisecond, America/New_York), bid, ask, underlying_price, delta, gamma, oi, dei.
OptionChainTable
Snapshot of the option chain per symbol/date: open interest, volume, bid/ask, and Greeks per strike and expiration. Use for "where is the market positioned?", call/put walls, and GEX-style analysis.
Main columns: symbol, date, option_symbol, put_call, strike, expiration_date, expiry_days, oi, daily_volume, bid, ask, iv, delta, gamma, vega, theta.
SymbolMetaData
Per-symbol, per-day metadata: price, volume, sector, market cap, earnings date, etc. Use for filters and joining with flow/chain tables.
Main columns: symbol, date, sector, description, open, high, low, close, volume, market_cap, earning_date, change_percentage.
DynamoDB: User Data
TradingFlow-Users
Stores user accounts and preferences: email (via GSI), watchlist, table filters, and option-trades UI preferences. Used by the app for persistence and personalization; not part of the market data feed.
Table Summary
| Table | Purpose |
|---|---|
| AggregatedOptionTrades | Option flow (aggregated); UOA, blocks, sentiment/DEX/DEI |
| RawOptionTrades | Option flow (raw); exact T&S |
| OptionChainTable | Option chain snapshot; OI, GEX, walls |
| SymbolMetaData | Underlying metadata; filters, joins |
| TradingFlow-Users | User accounts and settings |
For concept definitions (side, sentiment, DEX, DEI, GEX, OI, etc.), refer to the Options and Flow Concepts, Greeks and GEX, and Option Chain and OI articles.