OPEN-SOURCE SCRIPT
更新済

BK AK-GannBox King

754
BK AK-GannBox King

A unified price-and-time geometry framework built from one common market range.

Acknowledgment and Source Credit

All glory and gratitude to G-d.

The “AK” in BK AK-GannBox King honors my mentor, A.K., whose discipline, patience, market judgment, and commitment to clean execution continue to influence every serious tool I build.

BK AK-GannBox King incorporates and adapts selected source-code components from Gann Box (Zeiierman) by TradingView author Zeiierman.

The source-derived foundation includes portions of the originating Gann Box framework and the legacy paired-ray fan construction using the original 25%, 38.2%, 50%, 61.8%, 75%, and 100% level configuration.

Full credit is given to Zeiierman for that originating work. He's one of the best on Tradingview. This publication does not claim authorship of Zeiierman’s original Gann Box or legacy fan implementation.

The BK development substantially restructures and expands that foundation through independently developed anchor governance, isolated price-and-time engines, structural reversal logic, normalized Gann-angle families, curve systems, real-time confluence, Square of Nine calculations, harmonic-pattern analysis, extension projections, higher-timeframe comparisons, signal logic, and dashboard telemetry.

This is therefore a credited open-source derivative with substantial additional architecture—not a claim that the original Gann Box foundation was created by BK.

What BK AK-GannBox King Is

BK AK-GannBox King is a full-chart geometry and confluence framework designed to organize price, time, range structure, angles, curves, ratios, projections, and pattern context around one shared anchor system.

The indicator begins with two structural anchors:

A swing high
A swing low

Those anchors define:

The active price range
The measured time span
The direction of the original move
The coordinate system used by the surrounding modules

From that common foundation, the script can construct:

Gann and Fibonacci price divisions
Horizontal price zones
Box-time percentage coordinates
Legacy paired-ray fans
Normalized Gann-angle fans
Corner-based diagonal geometry
Quarter-circle curve projections
Gann degree time cycles
Fibonacci time zones
Square of Nine price levels
Harmonic-pattern structures and PRZs
Higher-timeframe range comparisons
Fibonacci extensions
Symmetry projections
Real-time ATR confluence zones
Reaction and breakout markers
A dashboard and drawing-budget monitor

These are not unrelated indicators placed together.

The complete framework follows one connected sequence:

Anchor range → price measurement → time measurement → projection geometry → independent feature comparison → confluence context

The purpose is not to predict every market turn. It is to provide a consistent geometric map showing where multiple independent calculations reference the same price or time area.

Anchor Engine

The anchor engine governs the entire framework.

Auto: Visible Range

In Auto (Visible Range) mode, the script identifies the highest high and lowest low among the bars currently visible on the chart.

This mode is useful for:

Exploring different market legs
Studying alternate ranges quickly
Comparing short-term and long-term structure
Rebuilding the geometry as the chart viewport changes

Because the anchors come from the visible chart, scrolling, zooming, resizing the chart, changing timeframe, or loading additional history can change the selected high and low.

When the visible range changes, the geometry can also change.

This is intentional viewport-dependent behavior.

Manual: Fixed

In Manual (Fixed) mode, the user enters exact prices and timestamps for the high and low anchors.

Every major module then reads the same fixed anchor core, including:

Box levels
Fans
True Gann angles
Curves
Time cycles
Square of Nine
Extensions
Confluence

Manual mode is appropriate when the trader has selected a specific structural move and wants the geometry to remain unchanged while scrolling or zooming.

The manual prices should correspond reasonably with the selected anchor times and the intended market swing.

Price Grid and Box Structure

The core box divides the anchor price range into configurable internal ratios.

Available ratio systems include:

Classic
Gann 1/8ths
Extended
Custom

The grid can display levels such as:

12.5%
23.6%
25%
33.3%
38.2%
50%
61.8%
66.6%
75%
78.6%
87.5%
Custom percentages

The horizontal levels divide the measured move into proportional price areas.

They provide location context rather than automatic support, resistance, reversal, or breakout guarantees.

The box can be rendered using different geometry domains, including the anchor span and a broader projected span.

The visual projection endpoint does not alter the original measured anchor duration used by the independent Gann and Fibonacci time engines.

Reverse and Dynamic Orientation

The Reverse function changes how the price grid is measured.

Instead of merely changing label text, the active price-ratio set is mirrored so the physical grid is rebuilt from the opposite anchor.

This allows the same range to be viewed as either:

Measurement from the first anchor
Retracement measurement from the second anchor

Reversal affects the horizontal price-measurement layer.

It does not move the independent Gann degree or Fibonacci time coordinates.

Dynamic Reversal

Dynamic Reversal uses the most recent confirmed structural pivot to determine the grid orientation.

A confirmed structural pivot high can orient the price grid downward from the high.
A confirmed structural pivot low can orient the price grid upward from the low.

The Structural Pivot Length controls how significant a pivot must be before it can change the orientation.

Larger values respond only to broader structural turns.

Smaller values react sooner but can produce more frequent orientation changes.

Because structural pivots require bars on both sides, the orientation changes only after confirmation.

Legacy Gann Fan

The legacy fan preserves and adapts the source-derived paired-ray construction from Zeiierman’s Gann Box.

The Original Source Levels option uses:

25%
38.2%
50%
61.8%
75%
100%

The Follow Active Fibonacci Preset option routes the fan through the currently selected internal price-ratio set.

BK additions to this module include:

Alternate preset routing
Independent transparency and styling
Last-N-box clipping
Dynamic-direction governance
Optional unified fan controls
Real-time confluence integration

The fan lines represent geometric projections from the anchor framework. They do not guarantee that price will follow or react at a particular ray.

True Gann Angles

The True Gann Angle module is separate from the legacy paired-ray fan.

It includes normalized rays from:

1x8
1x4
1x3
1x2
1x1
2x1
3x1
4x1
8x1

The normalized 1x1 ray travels the complete anchor price range over one complete anchor time span.

The other rays are calculated as slope multiples of that normalized relationship.

This makes the mathematical slopes dependent on the anchor geometry rather than the chart’s visual zoom.

The lines will only appear visually equivalent to traditional screen angles when the chart itself uses an appropriate locked price-to-time scale.

The user can display:

The fan from the first anchor
The fan from the second anchor
Both fans
Only the direction associated with the latest confirmed structural pivot

Rays can also be clipped when they leave the box’s price range.

A clipped ray stops contributing to confluence after its calculated exit.

Gann Angles

The separate corner-angle module draws diagonal geometry from selectable box corners:

Bottom-left
Top-left
Bottom-right
Top-right

This module is based on box-corner relationships and remains distinct from the normalized True Gann Angle engine.

The two systems can be used independently because they answer different geometric questions.

Gann Curves

The curve engine draws quarter-circle-style projections at selected ratios of the anchor domain.

Available curve ratios can include:

25%
38.2%
50%
61.8%
75%
87.5%
100%

The script supports:

Full quarter arcs
Last-N-box clipping
Optional arches beyond the original box
Cascade-tail rendering
Optional midpoint arches
Pivot-anchored cascade arches

Pivot Cascade Arches originate from the latest confirmed structural pivot rather than the original box origin.

From a confirmed pivot low, the projected family rises forward.

From a confirmed pivot high, the projected family descends forward.

Curve projections are geometric references. They do not imply that price must trace the arc or reverse at its endpoint.

Independent Time Cycles

The time-cycle engine is isolated from the box’s horizontal price ratios.

This separation prevents a price-grid change from accidentally moving a timing line.

Gann Degree Cycles

In Anchor Span mode, the measured duration between the first and second anchor represents 360 degrees.

Additional degree coordinates are projected as proportional multiples of that duration.

For example:

90 degrees represents one-quarter of the anchor duration.
180 degrees represents one-half.
360 degrees represents one complete anchor span.
720 degrees represents two complete anchor spans.

In Raw Bars mode, the selected degree number is treated as a literal bar count.

Fibonacci Time Zones

The Fibonacci time engine uses whole multiples of the anchor duration:

F1
F2
F3
F5
F8
F13
F21
F34
F55
F89
F144

F1 represents one anchor span.

F2 represents two anchor spans.

These timing coordinates are contextual observation windows. They do not require price to reverse or accelerate when reached.

Square of Nine

The Square of Nine module projects price levels above and below a configurable reference price.

Available reference choices can include:

Current close
Box high
Box low
Box midpoint
Custom price

The system can classify projected levels by rotational family, including:

Diagonal intervals
Cardinal intervals
Opposition or cross intervals
Full rotations

The module supports:

User-selected degree steps
Multiple rotations above and below the anchor
ATR-based spacing adjustment
A live ATR display radius
Automatic rotation extension toward the current market
Dynamic directional display
Right-edge bridge levels
Optional clipping to the box or an expanded box range

ATR Auto-Adjust increases the effective degree interval when the selected base interval would create levels that are too closely spaced for the current volatility environment.

Square of Nine levels are mathematical price projections. They are not guaranteed targets, support, or resistance.

Real-Time ATR Confluence

The confluence engine operates on the latest market area and compares independently calculated feature prices.

Potential contributors include:

Gann and Fibonacci price levels
Legacy fan rays
True Gann angles
Corner angles
Curve values
Higher-timeframe levels
Square of Nine prices
Fibonacci extensions
Harmonic PRZ values
Time alignment

Nearby prices are clustered using an ATR-based tolerance.

A zone qualifies only when the configured minimum number of independent feature types are present.

The engine can display:

The nearest currently touched zone
The nearest qualifying zone above price
The nearest qualifying zone below price
The nearest zones by distance
The strongest zones by feature count

The resulting confluence strength is a count of independent module types contributing to the cluster.

It is not a success probability.

A three-feature confluence zone means three independent feature families reference approximately the same price—not that the zone has a quantified probability of holding.

Harmonic Patterns

The harmonic engine can evaluate:

Gartley
Butterfly
Bat
Crab

It reconstructs X-A-B-C-D pivot relationships and tests them against configurable ratio tolerances.

The engine supports:

Confirmed patterns
Adaptive or consecutive pivot searches
Nested and overlapping candidates
Strict topology requirements
Skipped-pivot integrity checks
Developing X-A-B-C structures
Projected D zones
Potential Reversal Zones
PRZ touch tracking
Failure detection and retirement
Completed-pattern age limits

A projected D? is a future geometric PRZ marker. It is not attached to a confirmed market pivot and does not claim that price will complete there.

A completed D pivot confirms only after the configured number of right-side bars.

A failed PRZ can be marked D×, faded, hidden, or retained according to the selected lifecycle setting.

Harmonic patterns provide ratio and structural context. They do not guarantee reversal at D.

Fibonacci Extensions

The extension engine projects configurable levels beyond the original anchor range.

Typical levels include:

127.2%
161.8%
200%
261.8%

These levels can be used as proportional continuation references after price moves beyond the original range.

They are analytical objectives rather than promised targets.

Higher-Timeframe Structure

The script can compare the active chart geometry with a higher-timeframe high-and-low range.

Higher-timeframe levels can contribute to:

Visual box overlays
Price-location comparison
Real-time confluence

Higher-timeframe readings can change until the source timeframe has completed.

Heatmap and Level Testing

The heatmap counts how frequently price has interacted with each calculated level over the selected lookback.

Greater color intensity indicates more historical tests under the script’s proximity rules.

Repeated interaction can mean that a level is actively recognized, but it can also mean that the level is being weakened or crossed repeatedly.

Touch count alone does not determine direction.

Signal Markers

The optional signal engine evaluates price interaction with the nearest Gann level.

It can classify:

Upward reactions
Downward reactions
Breaks above a level
Breaks below a level

Optional volume confirmation can be required.

These markers identify that the script’s price, proximity, direction, and optional volume conditions have aligned.

They are not complete trade instructions and should not be interpreted independently from:

Anchor quality
Market structure
Confluence
Current volatility
Candle confirmation
Risk and invalidation
Dashboard

The dashboard summarizes the active framework and can report information such as:

Anchor mode
Grid orientation
Active ratio preset
Current box structure
Enabled feature modules
Nearest levels
Confluence status
Directional context
Drawing-object usage

Drawing-budget telemetry reports the number of active lines, labels, and boxes relative to TradingView’s object limits.

This helps explain why highly populated configurations can lose older drawings when platform limits are reached.

The dashboard is an informational summary. It does not replace direct inspection of the chart geometry.

How to Use BK AK-GannBox King
1. Begin with a clean chart

Use standard candles and remove unrelated drawings or indicators while learning the framework.

Start with only:

The horizontal price box
Price labels
The dashboard

Do not enable every module immediately.

2. Select the anchor mode

Use Auto (Visible Range) while exploring structure.

Adjust the visible chart so the intended market swing is clearly contained inside the viewport.

Use Manual (Fixed) after choosing a specific swing that should remain stable.

Enter the exact high price, low price, and associated timestamps.

3. Confirm the anchor direction

Check which anchor occurred first.

Determine whether the measured move runs:

Low to high
High to low

Use Reverse only when you want the price grid measured from the opposite side of the same range.

Use Dynamic Reversal when you want confirmed structural pivots to govern orientation automatically.

4. Choose the price-ratio preset

Start with one preset:

Classic for commonly used Fibonacci retracements
Gann 1/8ths for equal eighth divisions
Extended for a denser preset
Custom for your own percentages

Avoid changing presets merely to force a level onto current price.

The anchor and ratio selection should be determined before evaluating the reaction.

5. Read the horizontal grid first

Before adding projections, study how price behaves around:

The midpoint
Quarter divisions
Major retracement ratios
The upper and lower boundaries

Look for:

Acceptance
Rejection
Repeated testing
Clean breaks
Failed breaks
Consolidation between levels

A level becomes analytically relevant when price is interacting with it—not simply because it exists on the chart.

6. Add one projection family

Choose either:

Legacy fan
True Gann angles
Corner angles
Curves

Learn how that family interacts with the horizontal grid before adding another.

The legacy fan preserves the source-derived paired-ray construction.

The True Gann Angle module provides normalized slope relationships.

The curve engine provides non-linear geometric projections.

They should not be treated as interchangeable.

7. Enable confluence

After understanding the primary geometry, enable Real-Time ATR Confluence.

Begin with a minimum of three independent feature types.

Use the actionable display mode to show:

A touched zone
The nearest zone above
The nearest zone below

Review each zone’s hover information to see exactly which feature families created it.

Give greater analytical weight to true multi-module overlap than to several lines produced by the same module.

8. Add Square of Nine selectively

Choose a reference that matches the analysis:

Close for current-market calculations
Box high or low for anchor-based projections
Midpoint for range-centered projections
Custom for an independently selected price

Leave ATR Auto-Adjust enabled when manual degree spacing creates excessive visual density.

Use Square of Nine as another independent price family inside the broader framework.

9. Add time cycles separately

Enable Gann and Fibonacci time cycles only after the price structure is clear.

Observe when a time coordinate occurs near:

A horizontal level
A fan or angle
A curve
A Square of Nine level
A harmonic PRZ

A timing line by itself is not a reversal signal.

Its value comes from coinciding with a relevant price condition.

10. Use harmonic patterns as a secondary module

Do not treat every projected D? as a completed pattern.

Separate:

Developing X-A-B-C structure
Projected D?
PRZ interaction
Confirmed D
Failed D×

Wait for the selected pivot confirmation when using completed patterns.

Use the PRZ as a geometric observation area, not an automatic order level.

11. Use signal markers last

Enable bounce and breakout markers only after establishing:

The anchor
Ratio preset
Current grid orientation
Relevant confluence
Market structure

Markers should summarize an already understood condition rather than initiate analysis.

12. Define risk independently

The indicator does not determine appropriate position size, stop distance, leverage, or account risk.

Before acting, define:

Entry confirmation
Invalidation level
Position size
Maximum account risk
Exit plan
Recommended Starting Configuration

For a clean initial setup:

Anchor Mode: Auto while exploring, Manual when fixed
Box: On
Price labels: On
Vertical Grid Ownership: Time Cycles Only
Legacy Fan: Off
True Gann Angles: Off
Curves: Off
Harmonic Patterns: Off
Square of Nine: Off
Time Cycles: Off
Real-Time ATR Confluence: On
Minimum Independent Feature Types: 3
Confluence Display: Actionable
Dashboard: On

Then activate one additional module at a time.

Realtime Behavior and Limitations
Auto anchors can change when the visible chart range changes.
Manual anchors remain fixed until the user changes their inputs.
Dynamic orientation changes only after structural pivots confirm.
Harmonic pivots require right-side confirmation bars.
Developing harmonic structures can change or fail before D confirmation.
Higher-timeframe values can update until their source bars close.
Current-bar signals can change before the candle closes.
Confluence is based on ATR clustering and depends on current volatility.
Square of Nine density can change when ATR Auto-Adjust is enabled.
Drawing-object limits can cause older graphics to be removed when too many modules are enabled.
Geometry can appear visually different when chart zoom or price scale changes.
Price levels, angles, curves, cycles, patterns, and signals can fail.
No module guarantees support, resistance, reversal, continuation, or target completion.
Suitable Markets and Timeframes

BK AK-GannBox King can be applied to:

Futures
Equities
Forex
Cryptocurrency
Commodities

It is generally clearest on liquid markets with defined structural swings.

Lower timeframes produce faster but noisier anchor changes and pivot confirmation.

Higher timeframes produce broader geometry but fewer structural updates.

The appropriate anchor, pivot length, ATR tolerance, and feature density depend on the instrument and timeframe.

Original BK Contribution

The original Gann Box foundation and legacy paired-ray fan are credited to Zeiierman.

The separate BK contribution includes the expanded architecture connecting:

Shared Auto and Manual anchor governance
Deterministic fixed geometry
Independent price, box-time, Gann-time, and Fibonacci-time engines
Correct physical grid reversal
Structural-pivot dynamic orientation
Independent and unified fan governance
Normalized 1x8 through 8x1 Gann angles
Box-clipped ray participation
Extended, midpoint, cascade, and pivot-based curve families
Time-axis isolation and timestamp deduplication
ATR-adjusted Square of Nine
Real-time independent-feature confluence
Harmonic-pattern search and PRZ lifecycle management
Higher-timeframe comparisons
Fibonacci extensions
Heatmap analysis
Signals, alerts, dashboard, and drawing-budget telemetry

The value of BK AK-GannBox King is not that every module is enabled simultaneously.

Its purpose is to provide one governed coordinate system in which several independent geometric methods can be compared without allowing their price and time calculations to conflict.

Risk Disclosure

BK AK-GannBox King is provided for analytical and educational purposes.

It does not provide investment advice, guarantee performance, predict future market direction with certainty, or eliminate trading risk.

Users remain responsible for their own:

Analysis
Entries
Exits
Position sizing
Stop placement
Target selection
Order execution
Account risk

Anchor the move. Separate price from time. Measure the confluence. Confirm the reaction.
リリースノート
Arc logic, tooltips.

免責事項

これらの情報および投稿は、TradingViewが提供または承認する金融、投資、取引、またはその他の種類の助言もしくは推奨であることを意図したものではなく、またこれらに該当するものでもありません。詳細は利用規約をご覧ください。