Gator Oscillator
The Gator turns the Alligator's mouth-open state into a histogram: the two bars measure the Lips−Teeth and Teeth−Jaw distances — open/closed becomes countable instead of eyeballed.
What it is
The Gator Oscillator, developed by Bill Williams, is the quantitative companion of the Alligator: the upper histogram = |Teeth − Jaw| (the distance between the 8- and 13-period lines), the lower histogram = −|Lips − Teeth| (the 5- vs 8-period distance, drawn downward). It answers "how wide is the alligator's mouth right now": growing bars = the mouth widens (trend expanding), shrinking bars = it closes (exhaustion or range) — turning the entangled-or-fanned judgment into a numeric scale.
Origin
The Gator comes from Williams's chaos framework ("New Trading Dimensions", 1998), same family as the Alligator, Fractals and AO. Its motive is engineering: the "open mouth" was a visual call, imprecise on small or low-resolution charts — the Gator quantifies it so both programs and eyes can measure the opening precisely. In MT5 it shares data with the Alligator (the Alligator's buffers carry the Gator-prefixed names).
Download Camovia Tray free — check quotes, manage positions, and hide in one click from your system tray.
Download FreeThe formula
Two histograms (no parameters):
The Gator itself has no parameters — everything comes from the Alligator's default trio (13/8/5). The absolute-value design means it does not know which way the mouth opens (bull/bear mouths are both positive distances) — direction always belongs to the Alligator; the Gator measures only the width.
Worked example
A Gator life cycle:
- Sleeping: the three lines tangle → both histograms are tiny with alternating colors — numerically confirmed trendlessness.
- Opening: the Lips leave the Teeth → the lower histogram (negative) deepens; then the Teeth leave the Jaw → the upper histogram grows — the two jaws open in sequence.
- Feeding: both histograms hold maximum width — full-speed trend; colors alternate but the width holds.
- Closing: bar widths contract bar by bar — exhaustion; the alligator is about to sleep.
Reading the Gator is one sentence: widening bars = the trend is unfolding; narrowing bars = it is winding down. The most eyeball-dependent step of the Williams system becomes a precise scale.
How to read it
Reading the histograms:
| Range | Common interpretation |
|---|---|
| Both histograms tiny | The alligator sleeps — confirmed range; trend strategies stand down |
| Both histograms widening | Mouth opening — the trend is expanding (direction from the Alligator) |
| Width holding at highs | Feeding — full-speed trend; hold |
| Width contracting | Mouth closing — exhaustion; protect profit |
| One side widening, the other shrinking | A transition shape — typical of gear changes or consolidation breaths |
The Gator shares AO's coloring rule but not its meaning: AO measures the gap between fast/slow centers (momentum), the Gator measures line separations (structural expansion) — a speedometer versus a caliber gauge.
Common signals & usage
Wake-up confirmation
Histograms turning from double-tiny to widening together — the alligator wakes; with a fractal breakout this is the system's highest-quality entry window.
Mouth-closing exit
Both histograms contracting consecutively — numeric confirmation of exhaustion, earlier and more objective than eyeballing three converging lines.
Holding while feeding
Width holding at highs — the trend is still at full speed; no hand-off until the histograms contract (less screen-staring than MA crosses).
Gator + AO double confirmation
AO growing in the same direction + the Gator widening — momentum and structure expanding together: full-health trend.
Limitations & common mistakes
- No direction information: the Gator measures how wide, not which way — direction always comes from the Alligator (or a trend tool); never call bull/bear from the histograms.
- Partially redundant with the Alligator: if you are used to eyeballing three lines, the Gator's added value is mainly precision and programmatic use — visual traders may skip it.
- One layer of lag: bar-width changes trail the actual line separations (it is a derived read) — the closing signal comes long after the price turn; it confirms, it does not warn.
- AO-style color misreads: green = widening, not bullish — the lower histogram "deepening" (more negative) also renders green, meaning "opening wider".
- Double-tiny noise in ranges: minuscule width changes still flip colors — the "sleeping" call needs a persistent state, not one bar.
Gator in MT5
The Gator is a built-in MT5 Bill Williams indicator (upper/lower histograms in a sub-window). The MQL5 function for programmatic use is iGator:
| MQL5 function | iGator() |
| Default parameters | Same as the Alligator: Jaw 13/8, Teeth 8/5, Lips 5/3 |
| Buffers | 0=upper histogram (UPPER_HISTOGRAM), 1=lower (LOWER_HISTOGRAM) |
| Value semantics | Upper = |Teeth − Jaw|, lower = −|Lips − Teeth| |
| Display window | Sub-window (paired histograms around zero) |
iGator's parameter shape is identical to iAlligator (it is a re-processing of Alligator data) — keep the system defaults. The lower histogram values are negative (drawn downward); take absolute values when comparing widths. Coloring is bar-to-bar rendering; the buffers carry values only.
Behavior across timeframes
15-minute
Sleep/open cycles churn fast — take only the double-tiny-to-widening launch confirmations
1-hour / 4-hour
The framework's main swing period: wake-up confirmation + mouth-closing exits are most classic here
Daily
The framework's native habitat: the daily "feeding width holds" state is a powerful hold confirmation
Weekly
A widening weekly Gator = a quarter-scale trend expansion — structural confirmation for long-term allocation
Indicator combinations
The standard in-system pairings for the Gator:
- With Alligator: the Alligator sets direction, the Gator measures expansion — direction and intensity read separately, the framework's core combo. ALLIGATOR
- With AO: the Gator reads structural expansion, AO reads momentum speed — structure plus speed double confirmation. AO
- With Fractals: Gator wake-up confirmation + the fractal breakout trigger — the complete in-system entry flow. FRACTALS
FAQ
Q What is the relationship between the Gator and the Alligator?
The Gator is the Alligator's quantitative companion: the upper histogram = the Teeth−Jaw distance, the lower = the Lips−Teeth distance. It turns the mouth-open/closed shape into a numeric scale — direction stays with the Alligator; the Gator only measures how wide. Parameters are fully shared (13/8/5).
Q Why is the Gator's lower histogram negative?
A drawing convention: the lower histogram plots −|Lips−Teeth| below zero, mirroring the upper histogram (|Teeth−Jaw|). Read widths as absolute values — the more negative, the wider the mouth. Mind the sign in code.
Q Is a green Gator bar bullish?
No. The coloring rule matches AO — bar-to-bar: widening = green, narrowing = red, independent of direction. The lower histogram deepening (more negative) also renders green, meaning "opening wider". Direction judgment always belongs to the Alligator.
Q Can I trade the Gator alone?
Not recommended. It has no direction information (it cannot tell a bull mouth from a bear mouth) and only measures structural expansion — Williams designed it to work with the Alligator (direction), Fractals (triggers) and AO (momentum). The Gator alone sees "how wide the mouth opens" but never "which way".
Q How do I add the Gator in MT5?
Menu: Insert → Indicators → Bill Williams → Gator Oscillator, or drag it from the Navigator onto a sub-window. Parameters match the Alligator (13/8, 8/5, 5/3 period/shift) — keep defaults for the original system; the paired histograms render automatically.
Turn MT5 / MT4 into a Tray Tool
Check quotes, manage positions, and hide in one click.
Download Camovia TrayThis page is educational content about a technical indicator. It is not investment advice. Indicator signals can and do fail — always combine them with your own risk management.