Flow Layer — signed options flow (the WHO / WHEN)
The strategy's 3rd dimension, next to structure (EMA trend, §5.1) and the quality map (GEX/VEX nodes). Structure says if/where, the map says where to enter/stop/target, flow says WHO is aggressing and WHEN — it turns a static setup into a timed entry. Ref.: spec §5 (features), quality-map brief, DECISIONS 29/06 (signed dark pool prints).
1. What "flow" means (and does NOT mean)
Flow = SIGNED options order flow. Not "big volume" — the sign and the aggressor are everything. Founding lesson (29/06): a dark pool print is volume, not direction. A block can be directional accumulation, a hedge, or distribution. Signed flow settles that.
2. The 6 flow signals (strongest to softest)
| Signal | What it says | §5 feature |
|---|---|---|
| Signed net premium (aggressor) | calls bought + puts sold = bullish; the reverse = bearish | flow_align (z, signed) |
| Dark pool print at the node | DP level aligned with the OTE → confluence | darkpool_aligned (× node) |
| ΔOI real vs hedge | OI building at the target strike = real positioning | real_node, oi_build |
| Sweeps / urgency | multi-exchange sweep = someone is paying now (conviction) | weights flow_align |
| Block prints ≥ size | institutional size | weights flow_align |
| Persistence / repetition | flow repeating over several days = conviction (DIX logic) | longitudinal boost |
3. Its role in the scan: the TRIGGER
The map + the trend define WHERE and IF. Flow defines WHEN: at the OTE tap, is real money aggressing in the setup's direction? = the "buyers are coming back" confirmation (TailThatWagsDog).
Two modes (the 3rd open decision): - Flow = GATE: no long without signed net buying at the tap (strict, fewer signals, better quality). - Flow = SCORE: flow contributes to the §5 score (flexible, more signals). - v1 recommendation: flow as a score contributor, with a config flag to promote it to a hard gate once it has passed the gauntlet.
4. Where it lives in the funnel
Stage 2 of the scan = the §5 score has two halves: the WHERE (structure + nodes) and the WHO (flow). Flow can also be promoted to stage 2.5 · trigger: only push the notification if flow confirms at the tap (not just when price touches the MA). That is what separates "setup present" from "setup armed".
5. Confluence (the "extra")
When, at the same price, these stack: pullback MA (EMA55/144) + GEX node + S/R + dark pool
+ signed net premium in the direction → the darkpool×node cross term (w 1.2) compounds. A 4-5/5
confluence is worth infinitely more than 5 signals added up. Flow is the confirmer of that stack.
6. Data (Unusual Whales — spec §2.2)
flow-alerts, net-prem-ticks (signed net premium), darkpool (prints), open-interest/ΔOI,
greek-exposure. The UnusualWhalesProvider adapter maps these endpoints → the flow features.
Meanwhile: the mock provider simulates signed flow to build/gauntlet the pipeline.
7. Gauntlet discipline (non-negotiable)
Flow is not directional until it has proven its edge: - |t| ≥ 2 out-of-sample, walk-forward, with costs — a massive print is NOT a signal until it has passed the gate. - First case to validate as soon as UW access lands: signed dark pool prints on indices/majors (DECISIONS 29/06) — replay: directional accumulation (call net premium + real nodes) or hedge (put net premium / hedge nodes)? - Anti-leakage: the label = realized ex-post R, never recomputed from the flow features.
In one sentence: structure filters, the map sets the geometry, flow pulls the trigger — and nothing goes out until flow, too, has proven its edge.