pigment-docs -- operator_manual -- 132x48
Welcome to PigmentOS Docs v2026.5.25
Operator Reference

PigmentOS Documentation

A practical guide for reading the terminal and building cleaner market context.
PigmentOS is built for research, confirmation, and fast situational awareness. This manual focuses on how to read the outputs clearly and combine them into a practical market workflow.
> open gamma_wall --compare prior_session
: then scan fish_finder for contract confirmation

Getting Started

Recommended loop: read Gamma Wall first, compare it to the prior session, then use Fish Finder and Flow to confirm whether options activity supports the structure.
The terminal is strongest when it is used as a decision-support system. Do not start by asking "what should I buy?" Start by asking what the market is focused on, where pressure may build, and whether independent panels agree.

1. Establish Context

Start with Gamma Wall. Compare the current read against the prior session to understand what changed before you chase price or flow.

2. Identify Structure

Use Gamma Wall, Price Action, and Market Map to find the zones and breadth conditions that may matter. Treat these as reaction areas, not automatic entries.

3. Validate Participation

Move into Fish Finder after Gamma Wall. Scan the ticker for active contracts, then use Flow or Net Premium to inspect whether activity supports the Gamma read.

4. Grade The Read

Strong setups usually have narrative, price, positioning, flow, and breadth pointing in the same direction. Mixed signals mean slow down.

Operator Playbooks

These workflows describe how to use the terminal in common sessions. They are interpretation guides, not mechanical trading rules.

Morning Scan

Use this when you first open the dashboard and need a clean read before the day gets noisy.

Open Gamma Wall First

Compare the current Gamma Wall against the prior session. Focus on what shifted, what stayed anchored, and whether spot is approaching a meaningful zone.

Scan Fish Finder

Use Fish Finder on the tickers that matter from the Gamma read. Look for contracts where activity, moneyness, expiry, and side profile tell a consistent story.

Confirm Outside The Pair

Use Price Action, Market Map, Intel, Net Premium, and Discord bot alerts to decide whether the setup has enough outside confirmation.

Intraday Confirmation

Use this after a stock or index is already moving and you need to know whether the move has support.

Return To Gamma

Check whether the move is pressing into, rejecting from, or moving through a Gamma Wall zone. Focus on how price behaves around the visible structure.

Inspect Fish Results

Use Fish Finder to see whether activity is concentrated in specific expiries, strike regions, call/put profiles, or repeated contracts.

Check The Bot Layer

Use Discord bot alerts as a second screen for notable activity and reminders, then return to the dashboard for context.

Event Risk Watch

Use this around macro releases, earnings, policy headlines, or major probability shifts.

Start With Narrative

Intel and event views help identify what participants are repricing.

Watch Positioning

Gamma Wall can help locate areas where reactions may become crowded or unstable.

Avoid Single-Panel Bias

When event risk is high, require more agreement before treating a signal as useful.

Dashboard Modules

Each module answers a different market question. Use the module for the question it is good at, then combine outputs for a higher-confidence read.

Gamma Wall

Use Gamma Wall to identify positioning zones where price may react, stall, accelerate, or become more sensitive to nearby levels. Your main comparison should be current structure versus prior-session structure.

Best Used For

  • Finding areas to watch before price reaches them.
  • Comparing today's map against yesterday's visible context.
  • Checking whether a flow idea lines up with market structure.

Do Not Overread

A bright level is not a guaranteed trade. Treat Gamma Wall as structure, then require confirmation from Fish Finder, Flow, price action, and broader market context.

Trifecta Mode

Trifecta transforms Gamma Wall into a side-by-side comparison matrix, allowing you to monitor up to three concurrent tickers simultaneously without leaving the page.

Best Used For

  • Comparing index positioning (SPY vs QQQ vs IWM) in real-time.
  • Monitoring sector peers together (e.g., AAPL, MSFT, NVDA).
  • Maintaining a broad view while trading multiple correlated assets.

Tracer Mode

Tracer converts the expanded Gamma Wall into an intraday tunnel view. It uses the same Gamma Wall structure, but renders the most meaningful positive and negative zones as projected price reaction corridors.

Best Used For

  • Watching where price may be pulled, pinned, rejected, or accelerated intraday.
  • Seeing whether important gamma zones are strengthening or fading as the session updates.
  • Keeping a compact one-day Gamma Wall panel beside the Tracer map for strike-level context.

How To Read It

Bright tunnel zones are not targets by themselves. They show where current gamma structure is most meaningful. Use price behavior, Fish Finder, Flow, and broader context before assigning trade meaning.

Intel

Use Intel to determine what the market may be reacting to before interpreting price, options flow, or sentiment.

Best Used For

  • Separating broad market themes from single-name catalysts.
  • Spotting macro, volatility, and event-risk narratives.
  • Deciding whether a move is news-driven or technically driven.

Price Action

Use the view switcher to compare individual chart behavior with stocks, indices, and global market tone.

Best Used For

  • Checking whether your ticker is moving alone or with the market.
  • Spotting leadership, laggards, and index pressure.
  • Confirming whether flow is showing up in visible price behavior.

Polymarket Odds

Use event odds as an expectation gauge. The value is in how expectations shift, not in treating probabilities as certainty.

Best Used For

  • Understanding what the market is pricing around major events.
  • Watching whether event expectations are stabilizing or changing quickly.
  • Adding context to macro-sensitive price moves.

Trader Fear Index

TFI is a sentiment and risk-appetite read. Use it as a market pulse, not as a standalone timing tool.

Best Used For

  • Checking whether conditions favor risk-taking or caution.
  • Comparing sentiment against price action and breadth.
  • Recognizing when aggressive flow is fighting the broader mood.

Market Map

Use Market Map to confirm whether the tape is broad, concentrated, defensive, or speculative.

Best Used For

  • Evaluating sector participation.
  • Separating index strength from broad strength.
  • Finding whether a move has support beyond one ticker.

Unusual Flow

Use the Flow workspace when you need contract-level context. It is where a broad idea becomes a specific options read.

Best Used For

  • Reviewing contract snapshots, moneyness, DTE, notional activity, and volume behavior.
  • Checking whether activity is isolated or repeated.
  • Jumping from broad ticker interest into specific contracts.

Fish Finder

Use Fish Finder after Gamma Wall. It turns a structural read into a contract search by showing where notable options activity is appearing inside a ticker.

Best Used For

  • Finding active contracts before selecting one manually.
  • Comparing call and put interest around the same ticker.
  • Moving from scanner results into Flow for deeper inspection.

Net Premium

Use Net Premium to compare directional premium pressure over the current session.

Best Used For

  • Checking whether call and put premium pressure supports the visible move.
  • Seeing when pressure is building, fading, or diverging from spot.
  • Confirming whether flow is persistent or only a single burst.

Sector Rotation

Use Rotation to understand relative strength across sectors or market groups. The goal is to see where larger market participants may be rotating before the move becomes obvious on one ticker.

Best Used For

  • Finding where capital appears to be rotating.
  • Comparing shorter and longer market tone.
  • Checking whether a ticker belongs to a strengthening or weakening group.

RADAR + Stages

Use RADAR to move from broad discovery into a ticker dossier. The Stage Map organizes names by price-action cycle so users can quickly see whether a ticker is reclaiming, advancing, breaking out, extended, fading, or declining.

Best Used For

  • Separating early setups from crowded momentum.
  • Finding whether a ticker is strengthening, stretching, or losing structure.
  • Loading a dossier before moving into Flow, Fish Finder, or Gamma Wall confirmation.

Discord Bots

Use Dexter as the alert and monitoring layer. Dexter surfaces open-interest trackers, GEX watches, and Fish Finder repeated-hit flow while the dashboard provides the deeper context needed to interpret it.

Best Used For

  • Keeping an eye on notable activity away from the main screen.
  • Tracking contracts into the next morning's open-interest update.
  • Using Fish Finder and GEX alerts as prompts to check Gamma Wall, Flow, and price action.

Status + Sessions

Status labels, session indicators, and latency displays tell you whether the read is healthy enough to trust.

Status Labels

  • LIVE: The panel is operating normally.
  • CACHED: The panel is showing a recent saved view while fresh data is not required or still loading.
  • STALE: The panel has a usable last-known read, but freshness is reduced.
  • OFFLINE: The panel is unavailable or did not return usable data.

Sector Rotation Logic

Sector Rotation is our relative-strength map. It compares sectors and selected market groups against SPY across multiple timeframes so users can see where leadership is improving, fading, or quietly building.

What It Is Measuring

The backend compares each sector or ETF return against SPY over the selected window. If a group is outperforming SPY, its RS-Ratio moves above the neutral 100 line. If it is underperforming, it moves below 100.

User Read

Above 100 means relative strength. Below 100 means relative weakness. The map is about leadership versus the market, not whether the group is green or red on the day.

Why Timeframes Matter

The 1W, 2W, and 1M views help separate quick rotation from more durable leadership. A group can look hot on the short view while still weak on the longer view, or start improving before the broader market notices.

User Read

Use the short view for fresh movement and the longer view for confirmation. Cleaner rotation usually appears across more than one timeframe.

RS-Momentum

RS-Momentum tracks whether relative strength is accelerating or fading. A sector above 100 RS-Ratio but losing RS-Momentum may still be a leader, but leadership is cooling.

User Read

The strongest read is not just strong. It is strong and still improving.

Rotation Map

The map plots RS-Ratio and RS-Momentum together. The recent tail shows direction of travel, which helps users see whether a group is moving toward leadership, losing momentum, or repairing from weakness.

User Read

Watch the path, not only the current dot. Rotation is a movement pattern.

Heat Bars + Tape

The Trending ETFs view ranks groups by composite heat. Heat combines relative strength, momentum, and recent velocity so the tape can quickly surface the hottest, fastest, and weakest pressure points.

User Read

Use heat as a discovery layer, then confirm with price action, Flow, Fish Finder, and Gamma Wall.

How It Updates

Rotation is built from closing price data and cached by timeframe. The dashboard shows an as-of date in the tape so users know which close the current read is based on.

Important

This is not a live tick-by-tick flow feed. It is a relative-strength rotation lens designed to show where larger capital may be shifting over days and weeks.

Stages Engine

The Stages Engine is the RADAR classification layer. It is based on Oliver Kell-style price-action stage analysis: stocks tend to move through repeatable cycles of basing, advancing, extending, topping, and declining.

What It Answers

Stages answers one question quickly: where is this ticker in its price-action life cycle?

User Goal

Use the stage to decide whether a ticker looks early, clean, extended, fading, or structurally weak before moving into deeper confirmation.

How The Cycle Works

The broad cycle is Stage 1 basing/reclaim, Stage 2 advancing, Stage 3 fading/distribution, and Stage 4 declining. The letters break each broad phase into more actionable sub-stages.

Plain English

The number tells the broad cycle. The letter tells whether the ticker is earlier, more developed, or later in that phase.

Reclaim: 1A / 1B

The stock is trying to repair structure after weakness or consolidation. This is the early watch area where a ticker may begin to regain important levels.

User Read

Interesting for early setup discovery, but it still needs confirmation from price action and participation.

Advance: 2A

The stock is in an improving trend phase. This is usually the cleaner early trend zone before the move becomes crowded or visibly stretched.

User Read

Often the best lane for users looking for trend participation without chasing the latest-stage move.

Breakout: 2B

The stock is attempting expansion from structure into stronger momentum. This is where users should confirm whether the move has real follow-through.

User Read

Check price action, volume, Flow, Fish Finder, and market context before treating the breakout as clean.

Extended: 2C

The trend is still strong, but the ticker may already be stretched. Strong does not always mean attractive entry.

User Read

Use this lane to avoid blindly chasing. Look for pullback context, continuation evidence, or exhaustion risk.

Fade: 3A / 3B

The stock may be losing momentum or moving into a topping/distribution phase. It can still look strong visually while structure starts to weaken.

User Read

Useful for caution, trimming bias, or watching whether prior leaders are starting to lose control.

Decline: 4A / 4B / 4C

The stock is in a weaker structural phase. Failed rallies, downside control, and weak reclaim attempts become more important.

User Read

Do not evaluate these names the same way as Reclaim or Advance names. They require stronger evidence before bullish reads carry weight.

Confidence

Confidence tells users how cleanly the ticker fits the stage. It is not a win rate, price target, or probability that a trade will work.

Example

A 73% confidence label means the current structure fits that stage more cleanly than a lower-confidence name.

ATR Extension

ATR extension shows how stretched price is relative to recent movement. Positive extension means price is stretched upward; negative extension means price is stretched downward.

User Read

Use ATR extension to avoid confusing strength with a good entry, or weakness with a clean short.

Recommended Workflow

Start with the stage lane, then open the ticker dossier. After that, confirm the read with price action, Fish Finder, Flow, Gamma Wall, and broader market context.

Rule

Stages are market-cycle labels, not buy or sell signals.

Gamma Wall Comparison Guide

Gamma Wall is most useful when users compare today's map against the prior session. The goal is to understand what changed, what stayed anchored, and where price is sitting relative to the visible structure.

1. Start With The Prior Session

Before reacting to the current wall, compare it against yesterday's visible context. A level that remains in place can act differently from a level that just appeared or shifted.

Look For

  • Levels that stayed anchored across sessions.
  • Levels that moved closer to spot.
  • Levels that disappeared, weakened, or shifted away.

2. Read Percentage Change

Percentages should be read as relative change, not trade probability. A larger percentage change means the visible condition changed more compared with its reference point.

How To Use It

  • Positive change: The displayed value increased versus the comparison point.
  • Negative change: The displayed value decreased versus the comparison point.
  • Small change: The structure may be stable or unchanged enough to require other confirmation.
  • Large change: The area deserves attention, but still needs price and flow confirmation.

3. Separate Distance From Strength

A level can be important but too far away to matter immediately. A nearby level can matter intraday even if the broader setup still needs confirmation.

User Check

Ask: is price approaching the level, rejecting from it, holding below it, or moving cleanly through it?

4. Watch Reaction, Not Just Location

The best read comes after price interacts with the area. Look for stalls, rejections, accelerations, failed breaks, or repeat tests.

Confirmation

After the Gamma read, move to Fish Finder and Flow to check whether contracts near the same ticker or zone are active.

5. Use Percentages As Weight

A percentage can help rank what changed most, but it should not override context. Users should combine percentage change with level location, price behavior, freshness, and flow.

Plain English

Percentages answer "how much did this visible read change?" They do not answer "will this trade work?"

6. Decide What To Monitor

After comparing today versus yesterday, pick the zones worth watching. Then use alerts, Fish Finder, and price action to monitor whether the market starts respecting those zones.

Output

The end result should be a watchlist of levels, not an automatic trade.

Gamma Wall + Tracer Legend

The side emojis mark the role of an important strike. Tracer uses color and brightness to show the same gamma structure as projected intraday zones.

Gamma Wall Emojis

  • 🧲 Magnet: The strongest positive-GEX level in the weighted front expiries. Price may be pulled toward it or become more stable around it.
  • 🚀 Trigger: The strongest negative-GEX level in the weighted front expiries. Price moving through this area may become more reactive or accelerate.
  • 🐋 Unusual call-heavy node: An unusually concentrated call-side GEX level outside the primary magnet.
  • 🐻 Unusual put-heavy node: An unusually concentrated put-side GEX level outside the primary trigger.

Tracer Colors

  • Purple: Positive-GEX structure.
  • Pink / red: Negative-GEX structure.
  • Brighter tunnel: Greater relative gamma intensity at that strike.
  • Dark or muted area: Lower relative gamma intensity between the stronger zones.

These markers describe positioning structure, not guaranteed support, resistance, or trade direction. Always confirm how price reacts at the level.

Tracer Logic

Tracer starts from the expanded Gamma Wall payload and focuses the view around the most meaningful gamma structure, especially the weighted magnet and trigger region used by the standalone Gamma Wall. It does not tighten the chart around spot alone.

Projection Behavior

  • Before market open: Tracer displays a projected tunnel map from premarket/current gamma.
  • During market hours: Tracer switches to live status and redraws as refreshed gamma snapshots update the current structure.
  • Spot line: The dotted spot guide updates with the latest spot read, but the tunnel zones come from gamma intensity around strikes.
  • Side PIP: The plus button can add compact one-day Gamma Wall panels for up to three tickers without changing the main Tracer symbol.

Important Limitation

Tracer currently redraws from the latest gamma payload; it does not preserve a full historical gamma tape for each prior intraday column. Treat it as a live structure view, not a saved replay.

GEX Structure Playbook

A Gamma Wall is more than a list of strikes. Read the position of positive and negative GEX relative to spot, then decide whether the map contains boundaries, a route, open space, or conflicting pressure.
Start with spot. Mark the strongest positive-GEX nodes, scan for negative-GEX regions, and read the space between them. These structures describe market conditions; price reaction and flow still provide confirmation.

Boomstick Above Spot

The clearest standalone Boomstick is a dominant 0DTE positive-GEX node above spot. It acts as the contextual ceiling and can make a rally less efficient as price approaches.

Operator Read

  • Treat the Boomstick as a reaction zone, not an automatic entry or guaranteed rejection.
  • Watch for a stall, rejection, hold, or clean break when price reaches the node.
  • Refresh the read during the session because 0DTE structure can change quickly.

Trigger + Boomstick

A dominant positive-GEX node above spot is the Boomstick, acting as the ceiling. A dominant negative-GEX node below spot is the Trigger, acting as the floor. Together they define the structural range for the session.

Operator Read

  • Watch the nodes themselves for reaction.
  • Use the distance between them to judge available travel and movement speed.
  • Do not treat the midpoint as support or resistance unless separate evidence establishes it.
  • The names do not change polarity: Trigger is negative GEX; Boomstick is positive GEX.

Staircase

A Staircase forms when a dominant positive-GEX target has smaller positive-GEX nodes between it and spot. Those intermediate nodes turn a distant destination into a sequence.

Operator Read

Price must clear each intermediate node to keep the Staircase active. If one holds and rejects the move, reassess the full target instead of assuming price will skip the checkpoint.

Target vs. Entry

The node that defines a destination may be different from the node that provides entry structure after a pullback. Reaching a correct target does not turn that target into an entry.

Operator Read

Mark the target, identify any negative-GEX transit rows, and locate the separate entry-support node. Wait for price to return and confirm its reaction instead of initiating risk at the destination.

Entry Sequence

Entry Sequence begins after price tests a strong base formed by nearby dominant Triggers. The next question is whether the positive-GEX wall overhead continues absorbing the rally or changes polarity.

Operator Read

Treat the paired Triggers as one structural floor. Then wait while the overhead wall remains green and track that same strike across updates. When it flips red, absorption has released and negative gamma can reinforce the advance; require price confirmation before treating the flip as a continuation entry.

Air Pockets

An air pocket is a band of strikes where net dealer GEX stays near zero and no meaningful positive- or negative-GEX node occupies the interior.

Operator Read

With little gamma structure available to slow price, movement can travel more quickly through the band. Treat the pocket as open space—not a level—and watch its boundaries, nearby nodes, and polarity changes.

Positive-GEX Clusters

Several positive-GEX nodes across nearby strikes can behave as one structural band. Magnitude and density determine how much influence the cluster carries.

Location Matters

  • Above spot: Layered resistance.
  • Below spot: Layered support.
  • Around spot: Rotation and possible pinning.

Smaller nodes may be porous. A dense, high-value cluster can slow movement and contain price for longer.

Rug Pull

Rug Pull is a bearish unpaired-Boomstick structure: positive GEX forms the Boomstick ceiling above spot while separated negative-GEX rows supply downside fuel below.

Confirmation

The Boomstick can cap a rally while negative gamma below can reinforce a decline. Rejection identifies the setup; downside acceptance or acceleration provides the stronger confirmation.

Whiplash

Closely related instruments can produce incompatible maps—for example, one bullish, one bearish, and another pinned around spot.

Trade Posture

Treat the conflict as a directional no-trade filter. Failed breaks and two-sided chop become more likely. If a clean range forms, confirmed outer-boundary fades may remain viable; mid-range entries have no structural edge.

Structure Checklist

  • Where is spot relative to the strongest positive-GEX nodes?
  • Does the map contain a paired range, an unpaired boundary, a cluster, or an air pocket?
  • Are intermediate nodes blocking the route to a larger target?
  • Do SPX, SPY, QQQ, or other related instruments confirm the same directional structure?
  • Has price confirmed the read through a hold, rejection, clean break, or acceleration?

Rule

The map defines the structure. Price behavior determines whether that structure is active.

Fish Finder Deep Dive

Fish Finder is the bridge between a Gamma Wall thesis and specific options contracts. Use it after the Gamma read tells you which ticker or region deserves attention.

1. Start From A Gamma Read

Fish Finder works best when you already know why you care about the ticker. Start with the Gamma Wall comparison, then scan the ticker to see whether options activity supports the structure.

User Goal

Turn "this area matters" into "which contracts are traders actually using?"

2. Filter The Contract Field

Use expiry, moneyness, call/put type, size, premium, and today/history controls to narrow the table. The goal is to remove noise until the active contracts become obvious.

Useful Reads

  • Near-dated activity can show urgency.
  • Repeated activity in the same contract can show persistence.
  • Activity near important structure deserves extra attention.

3. Read Moneyness

ATM, ITM, and OTM labels help users understand how aggressive or speculative the selected activity may be. Combine moneyness with expiry and side profile before drawing a conclusion.

Interpretation

ATM often matters for immediate sensitivity, ITM can indicate stronger conviction or hedging, and OTM can indicate speculative upside or downside interest.

4. Read Side Profile

Fish Finder separates activity into buy-side, sell-side, midpoint, stale, and missing-quote contexts when available. This helps users avoid treating every large print as directional.

Interpretation

  • Clean ask-side activity can suggest urgency from buyers.
  • Clean bid-side activity can suggest selling pressure or closing flow.
  • Midpoint, stale, or missing-quote activity requires more caution.

5. Look For Repeat Behavior

A single print can be interesting, but repeated activity in the same contract or nearby contracts is usually more useful. Look for persistence across time, expiry, and strike region.

Confirmation

Repeated Fish Finder activity becomes more meaningful when it lines up with Gamma Wall structure, visible price action, and Discord bot alerts.

6. Jump Into Flow

When a Fish Finder row matters, move into Flow for contract-level detail. Use the snapshot, moneyness, DTE, notional context, and volume behavior to decide whether the activity is useful or noisy.

Decision Rule

Fish Finder finds candidates. Flow helps inspect them. Gamma Wall keeps the candidate tied to market structure.

Reading A Fish Finder Row

A row is useful only when the fields tell a coherent story. Read from broad context into contract detail instead of reacting to the largest number on the screen.

Ticker + Contract

Start by confirming the ticker, strike, option type, and expiration. A contract only matters if it connects back to the Gamma Wall area or active price zone you are watching.

Ask

Is this contract located near the level that made you interested in the ticker?

Expiry + DTE

Short-dated contracts can show urgency, while longer-dated contracts may reflect a slower thesis. Compare DTE with the catalyst, market session, and expected holding window.

Ask

Does the expiration match the speed of the move being implied?

Side + Quote Quality

Ask-side, bid-side, midpoint, stale, and missing-quote labels should change your confidence. Clean side profile is easier to interpret than activity with uncertain quote context.

Important

Side labels help estimate pressure, but they do not prove whether a position is opening, closing, hedging, or part of a larger trade.

Size + Premium

Premium shows money involved; size shows contract count. Large premium in a liquid contract can mean something different from large size in a cheaper contract.

Ask

Is the activity meaningful for this ticker, or only large in isolation?

Volume + Open Interest

Volume compared with open interest helps users understand whether today's activity stands out. Use this as context, not as a standalone signal.

Ask

Is today's contract activity unusual relative to what was already open?

Moneyness + Location

ATM, ITM, and OTM contracts carry different risk profiles. The most useful read combines moneyness with where spot is relative to Gamma Wall structure.

Ask

Is the contract aggressive, defensive, or centered around the level being tested?

Filter Recipes

Filters should reduce noise without forcing a conclusion. Start broad, then tighten only when the first pass shows too many unrelated contracts.

Gamma Confirmation

Use after Gamma Wall highlights a ticker or zone. Filter by ticker first, then compare calls, puts, expiry, and moneyness around the level being watched.

Best For

Checking whether options activity is appearing near the structure that matters.

Repeat Contract

Look for the same contract or nearby strikes appearing more than once. Repeated activity is usually cleaner than a single isolated print.

Best For

Finding persistence across time instead of reacting to one transaction.

Near-Term Urgency

Focus on shorter-dated contracts when a move is happening now or an event is near. Pair this with price action because short-dated flow can change quickly.

Best For

Intraday confirmation, event risk, and fast-moving names.

Cleaner Signal Pass

De-emphasize stale, missing-quote, or scattered midpoint activity when you need a cleaner read. Reintroduce them later if liquidity is thin.

Best For

Reducing false confidence from low-quality quote context.

Discord Bot Alert Playbook

Discord bots are the monitoring layer. Their job is to surface activity quickly; the dashboard is where users decide whether the activity fits the broader market picture.
1. Treat The Alert As A Prompt
Do not assume the alert is a trade. Use it as a reason to open the ticker and start the confirmation loop.
2. Check Gamma Wall
Compare the current Gamma Wall against the prior session and locate where spot is relative to the visible structure.
3. Open Fish Finder
Search the alerted ticker and inspect whether similar contracts, expiries, or strike regions are also active.
4. Inspect Flow
Use Flow to review contract detail: side profile, moneyness, DTE, premium, volume, open interest, and repeat behavior.
5. Confirm The Tape
Check price action, breadth, sector context, and Net Premium before treating the alert as part of a thesis.

Dexter Command List

Dexter supports prefix commands and matching slash commands for the core monitoring workflow.

Core Commands

  • !ping: Check that Dexter is awake.
  • !track ANET 180 Call May 8: Track a contract for next-morning OI reporting.
  • !tracks: List active tracked contracts in the channel.
  • !untrack 12: Stop tracking a contract by id.
  • !cleartracks: Clear active OI trackers in the channel.

Dexter Market Tools

Use these when a ticker needs immediate dashboard context or when the channel wants a watch running in the background.

Market Commands

  • !oi MU: Show a top open-interest board.
  • !gex MU: Show the nearest-expiry GEX wall.
  • !gexwatch MU: Monitor intraday GEX changes for a ticker.
  • !gexwatchlist: List active GEX watches in the channel.
  • !gexunwatch MU: Stop monitoring a ticker's GEX watch.
  • !gexcheck: Run the GEX monitor immediately for the channel.
  • !report_now: Run the AM report immediately.

Fish Finder Commands

Dexter uses Fish Finder as the single source for repeated-hit flow alerts, so Discord and the dashboard read from the same logic.

Flow Commands

  • !flows NVDA: Manually scan one ticker for today's repeated-hit clusters.
  • !flowstatus: Show source, last scan, candidate count, alert count, and errors.
  • Automatic scan: Watches the Radar Stage universe on schedule during market hours, then drains unposted session hits after close.

Dexter Message Types

Dexter keeps alerts short so Discord stays usable as a monitoring layer instead of becoming a second dashboard.

Automated Messages

  • Fish Finder scanner // standing by: Market-open readiness ping.
  • Fish Finder scanner // online: Midday check-in.
  • Fish Finder // Repeated hit: Qualified same-contract repeated flow.
  • Fish Finder // Error: Fish Finder source or configuration problem.

Alert Anatomy

Users should know what each alert field is asking them to inspect next.

Key Fields

  • Ticker: Start the dashboard lookup.
  • Contract: Check strike, call/put type, and expiration.
  • Premium/Size: Compare activity against the ticker's normal liquidity.
  • Time: Decide whether the alert is still fresh enough to matter.

Alert Quality

A better alert is not only bigger. It is easier to use because it fits structure, repeats, and confirms across modules.

Cleaner Alert

Gamma Wall location, Fish Finder repetition, Flow detail, and price action all point to the same area.

Example: Premium Spike

A bot flags a large premium contract on a ticker already near a Gamma Wall area.

Next Move

Open Gamma Wall first, confirm whether the ticker is near a visible zone, then use Fish Finder to see whether the same strike region or expiration is seeing repeat activity.

Example: Repeat Ticker Alert

A ticker appears in multiple alerts during the same session.

Next Move

Check whether activity is clustered or scattered. Clustered contracts near similar strikes or expiries are usually easier to interpret than unrelated one-off alerts.

Example: Put Alert Into Weak Tape

A put alert appears while the broader market or sector is weakening.

Next Move

Confirm whether price action, Market Map, and Net Premium agree. If the ticker is moving against broad context, require stronger confirmation.

Example: Alert Without Context

A bot flags a contract, but Gamma Wall, Fish Finder, price action, and breadth do not line up.

Next Move

Mark it as watchlist only. The alert may become useful later, but it is not a complete read by itself.

Fish Finder Repeated-Hit Alerts

Dexter only posts repeated-hit flow when Fish Finder qualifies a fresh cluster. The scanner looks for the same exact contract receiving repeated fresh same-side trades inside the active window.

Contract Match
The alert is grouped by ticker, expiration, strike, and call/put type. Scattered activity across unrelated contracts does not qualify.
Fresh Hits
The default rule requires at least three quote-confirmed BUY or SELL hits in the window.
Premium Floor
Individual tiny prints are ignored, and the repeated cluster must reach the configured total premium threshold.
Side Agreement
The cluster must mostly agree on side. Mixed bid, ask, and midpoint activity is treated as lower quality.
Freshness
Automatic Dexter alerts fire while a repeated-hit cluster is fresh. Manual ticker commands can review today's Fish Finder session, and the after-close drain keeps posting unreported session hits until the day is complete.

Discord Alert Dictionary

Use this dictionary to translate alert fields into the next dashboard action.

Ticker
The symbol that triggered the alert. Open the ticker in Gamma Wall and Fish Finder before assigning meaning.
Call / Put
The contract type. Calls are not automatically bullish and puts are not automatically bearish; context, side profile, and structure matter.
Strike
The contract's price level. Compare strike location against spot, Gamma Wall zones, and nearby active contracts.
Expiration
The contract's expiry date. Shorter expirations may imply urgency; longer expirations may imply a slower thesis.
DTE
Days to expiration. Use it to judge whether the alert fits an intraday move, event window, or longer setup.
Premium
The dollar value tied to the activity. Compare it with the ticker's normal liquidity and whether similar contracts are also active.
Size
The number of contracts. Large size matters more when it also has clean liquidity, repeat behavior, and useful location.
Volume / OI
Volume shows today's activity; open interest shows existing contracts. High volume versus OI can make a contract worth inspecting.
Side
Bid-side, ask-side, or midpoint context. Use it as pressure context, not proof of buyer/seller intent.
Sweep
May indicate urgent multi-venue execution. Confirm with Flow and avoid treating the label alone as a signal.
Repeated Alert
The same ticker or contract region appears more than once. Check whether activity is clustered around the same strike, expiry, or Gamma area.
Timestamp
How fresh the alert is. Fast-moving contracts can become stale quickly, especially near open, close, or major events.

Signal Confidence

PigmentOS is most useful when users grade evidence. The goal is not to find one loud signal; the goal is to understand whether separate parts of the terminal agree.
Low Confidence

A single module flashes interest, but price, breadth, or narrative does not confirm it. This is usually a watchlist item, not a decision.

Medium Confidence

Two or more modules agree, but one major piece is missing. Example: Gamma Wall and Fish Finder agree, but breadth or narrative is still unclear.

High Confidence

Gamma Wall, Fish Finder, price action, breadth, and alert context are aligned. This does not remove risk, but it means the read is cleaner.

Start With The Why
Start with why the Gamma Wall matters, then use Fish Finder to investigate whether active contracts support that view.
Respect Divergence
If price is rising while breadth fades, or flow is aggressive while sentiment is defensive, treat the setup as lower confidence.
Watch The Location
Fish Finder activity near meaningful Gamma structure is more useful than activity floating in the middle of nowhere.
Check Freshness
A stale or cached panel can still provide context, but fresh confirmation should carry more weight.

Example Reads

These examples show how to think through the product in practical workflows. Use them as decision-support patterns, not mechanical trade rules.

Continuation Read

A ticker is approaching an important Gamma Wall area and Fish Finder shows repeated call-side interest in contracts tied to the same region.

User Interpretation

The read improves if price action confirms, Net Premium supports the direction, and Discord alerts continue to flag related activity. The user should still wait for execution context instead of treating the level as a guaranteed breakout.

Rejection Read

Price reaches a Gamma Wall area and stalls while Fish Finder starts showing put activity, closing call interest, or mixed side profile.

User Interpretation

The read is not automatically bearish. It means users should slow down, check whether breadth is fading, and decide whether the tape is rejecting the area or simply pausing.

No-Trade Read

Gamma Wall highlights a meaningful area, but Fish Finder is quiet, stale, or scattered across unrelated expiries and strikes.

User Interpretation

This is often a watchlist condition. The structure may matter later, but the options layer has not confirmed enough participation yet.

Bot Alert Read

A Discord bot flags notable activity while the user is away from the dashboard.

User Interpretation

Treat the alert as a prompt, not a conclusion. Open Gamma Wall first, compare against the prior session, then use Fish Finder and Flow to decide whether the alert fits the broader map.

Fish Finder: Repeat Call Interest

Fish Finder shows several call contracts on the same ticker with similar expiries while spot is moving toward a Gamma Wall area.

User Interpretation

This is a stronger candidate than one isolated print. Check whether the activity is near the same strike region, whether side profile is clean, and whether price is confirming the move.

Fish Finder: Large Print, Weak Context

A single contract shows large premium, but the ticker is far from the Gamma Wall area and other contracts are quiet.

User Interpretation

Do not force the read. Large premium can be useful, but it needs context, repetition, or confirmation before it becomes meaningful.

Fish Finder: Mixed Call And Put Activity

Calls and puts both appear active around the same ticker, with no clean direction from price action.

User Interpretation

This can mean positioning, hedging, event risk, or an unclear tape. Treat it as a caution signal and wait for cleaner confirmation.

Fish Finder: Near-Dated Urgency

Short-dated contracts appear repeatedly while price is already moving quickly.

User Interpretation

Near-dated activity can move fast and fade fast. Confirm freshness, side profile, and price behavior before assigning weight.

What Not To Do

Most bad reads come from using one strong-looking output without context. These are the habits users should actively avoid.
Do Not Treat Gamma As An Entry
Gamma Wall gives structure. It does not replace execution, risk control, or confirmation from Fish Finder, Flow, price action, and breadth.
Do Not Trade One Print
A single options print can be noise. Prefer repeated Fish Finder activity, cleaner side profile, and confirmation from Flow, price action, and Net Premium.
Do Not Ignore Moneyness
ATM, ITM, and OTM contracts can imply different behavior. Users should combine moneyness with expiry, premium, and location before assigning meaning.
Do Not Overreact To Bots
Discord alerts are useful because they surface activity quickly. They still need dashboard confirmation before users treat them as part of a thesis.
Do Not Ignore Freshness
Cached or stale panels can provide background, but fresh agreement should carry more weight when conditions are moving fast.
Do Not Force Mixed Signals
If Gamma Wall, Fish Finder, price action, breadth, and bot context do not line up, the correct read may be patience.
Do Not Treat Percentages As Odds
Gamma Wall percentages help compare visible changes. They are not win rates, price targets, or guarantees that a level will hold or break.
Do Not Confuse Side With Intent
Bid-side and ask-side context helps estimate pressure, but it does not prove whether the trader opened, closed, hedged, or legged into a larger position.

Glossary

These definitions are written for terminal use. They explain how to think about each label while reading the dashboard.
Gamma
A positioning lens that helps identify where options exposure may influence price behavior.
GEX
Gamma exposure. PigmentOS uses net dealer GEX by strike to map where options positioning may stabilize or amplify price movement.
Positive GEX
Positive gamma exposure. Large positive-GEX nodes can attract, stabilize, resist, support, or pin price depending on their location relative to spot.
Negative GEX
Negative gamma exposure. Movement through a negative-GEX region can become more reactive when dealer hedging reinforces the direction of travel.
GEX Node
A strike with a meaningful concentration of net dealer gamma exposure. Compare its sign, size, expiration, and distance from spot.
Air Pocket
A continuous band of strikes with near-zero GEX and no meaningful node inside it. It represents open travel space, not a support or resistance level.
GEX Trigger / Boomstick
A dominant negative-GEX Trigger below spot acts as the floor; a dominant positive-GEX Boomstick above spot acts as the ceiling. Together they form the structural range, and their midpoint is not automatically a level.
Tracer
An expanded Gamma Wall mode that renders meaningful gamma zones as intraday tunnels. It helps users watch live structure around important strikes without treating the zones as guaranteed targets.
VEX
A volatility-focused view used to compare pressure beyond simple price direction.
Theta
A time-decay lens that can help users understand where option value may be sensitive to time.
IV
Implied volatility. Use it to understand how expensive or reactive options may be.
Bid-Ask Spread
The gap between what buyers are bidding and sellers are asking. Wider spreads usually make direction and execution harder to read.
Open Interest
Outstanding option contracts. Useful for context, especially when combined with volume and price behavior.
DTE
Days to expiration. Shorter-dated contracts can behave differently from longer-dated contracts.
ATM
At the money. The strike is close to the current underlying price.
ITM
In the money. The contract already has intrinsic value based on spot versus strike.
OTM
Out of the money. The contract needs price movement before it has intrinsic value.
Bid Side
Activity closer to the bid. It can suggest selling pressure, but does not prove whether the trade opened or closed a position.
Ask Side
Activity closer to the ask. It can suggest buyer urgency, but should still be confirmed with context.
Midpoint
Activity near the middle of the bid-ask spread. It is harder to interpret directionally than clean bid-side or ask-side activity.
Sweep
A label for activity that may indicate urgency or multi-venue execution. Use it with context.
BTO / STO
Buy to open and sell to open. Flow side can help with context, but users should not assume every ask-side trade is BTO or every bid-side trade is STO.
Notional
The approximate dollar exposure represented by a trade or contract. Use it to compare scale across contracts.
Premium
The dollar value associated with the options activity. Compare it against the ticker's normal liquidity before assigning importance.
Liquidity
How easily a contract can trade without large price impact. Liquid contracts usually have tighter spreads and cleaner reads.
Repeat Activity
The same contract, expiry, or strike region appearing multiple times. Repetition can make a read cleaner than one isolated print.
Volume/OI
A comparison between today's traded contracts and existing open interest. It can help identify contracts seeing fresh attention.
Net Premium
A session view of premium pressure. It helps compare whether activity leans toward calls, puts, or mixed flow.
RS-Ratio
Relative strength versus SPY. Above 100 means the group is outperforming the benchmark over the selected window; below 100 means it is lagging.
RS-Momentum
The rate of change in relative strength. It helps show whether leadership is accelerating, cooling, repairing, or weakening.
Breadth
The degree to which a move is supported by many stocks or sectors rather than a few leaders.
Stage Analysis
A price-action framework that groups stocks by market-cycle phase: basing, advancing, extending, fading, or declining.
Reclaim
An early repair phase where price is trying to regain structure after weakness or consolidation.
Advance
A cleaner trend participation phase where structure is improving and price is moving in a stronger direction.
Extended
A later momentum phase where the trend may still be strong but risk of chasing is higher.
ATR Extension
A stretch read based on recent price movement. Positive extension means price is stretched upward; negative extension means price is stretched downward.

Troubleshooting

Data tools can degrade, especially during heavy market activity. These notes help users decide what to do without needing to know the backend.
Panel Shows Offline
Use other panels for context and wait for recovery before relying on that module. Offline means the panel did not return usable data.
Panel Shows Stale
Treat the read as background context. It may still be directionally useful, but it should not be your only confirmation.
Sparse Options Data
Some tickers or expiries naturally have less usable activity. Prefer liquid names when you need cleaner reads.
Mixed Signals
Do not force a read. Mixed modules often mean the market is transitioning, liquidity is uneven, or the move is not clean.
Fast Market Conditions
During fast moves, prioritize fresh panels, visible price action, and agreement across modules. Avoid leaning on one delayed or isolated read.

FAQ

Is this financial advice?

No. PigmentOS is an educational and research tool. Users should make their own decisions and use independent risk controls.

Why do some panels show offline?

Different modules depend on different data services. A single widget can degrade while others remain healthy, especially during provider interruptions.

Where should new users spend time first?

Start with Gamma Wall, compare it to the prior session, then use Fish Finder and Flow to inspect whether active contracts support the structure. Use Intel, Price Action, Market Map, and Discord bots for confirmation.

How should I use the prediction data?

Use it as a live expectation gauge for event risk, then compare it with news tone, market breadth, and options positioning for context.

Can I trade from one signal?

The product is designed for confluence. A single signal is a prompt to investigate, not a complete thesis.

Help us tune this manual around real usage. The best docs come from the way experienced users actually read the tape.

Questions For Future Versions

  • What are the top three mistakes new users make when reading the terminal?
  • Do you use PigmentOS differently before market open, during the first hour, midday, and into close?
  • Which signals do you personally require before saying a setup has enough confluence?
  • What parts of the UI do users ask you to explain most often?
  • Which Discord bot alerts should be documented as part of the default Gamma Wall to Fish Finder workflow?
  • What does a great Gamma Wall plus Fish Finder example look like when explained as a user workflow?