pitchfan

Draws a Pitchfan: three-point “fan” lines derived from a pitchfork idea (one center point and two side points). It gives you angled rails that follow trend direction, useful for spotting dynamic support/resistance and pullback zones as price moves.

Syntax

pitchfan(originPoint, leftFanPoint, rightFanPoint, styles?)

Parameters

• originPoint (PricedData) · The center/handle of the fan (time & price). Example: newPoint(time(60), closeC(60)).

• leftFanPoint (PricedData) · Sets one side of the fan and helps define slope. Example: newPoint(time(40), high(40)).

• rightFanPoint (PricedData) · Sets the other side of the fan and overall opening. Example: newPoint(time(20), low(20)).

• styles (PitchFanLineToolOverrides) · Visual and level options (enable only what you need):

  • fillBackground (boolean) · Fill area between selected rays.

  • transparency (number) · Background transparency (0–100).

  • median (LinesLevels without coeff) · Default line look (e.g.,visible, linestyle, linewidth, color).

  • level0 … level8 (LinesLevels) · Per-ray options:

    • coeff (number) · set the coeff.

    • visible (boolean) · Show this ray.

    • color (RGBAColor | BaseColors) · Line color (e.g., color.blue or color.rgba(0,0,255,1)).

    • linestyle (number) · 0=solid, 1=dotted, 2=dashed…

    • linewidth (number) · Line width.

Return Value

• (string) The drawing ID of the created Pitchfan (store it if you’ll update or remove it later).

Example

Small demo: every 40 candles we drop a pitchfan aligned to recent structure. We define a single style object to keep everything tidy and reusable.

//@version=1
init = () => {
  // Draw on the main price chart and inherit price formatting
  indicator({ onMainPanel: true, format: 'inherit' });
};

onTick = () => {
  // Draw occasionally to avoid clutter (change 100 to taste)
  if (index % 100 === 0) {
    // 1) Choose three anchors so the fan follows structure
    const origin = newPoint(time(60), closeC(60)); // center/handle
    const left = newPoint(time(42), high(42));   // defines one ray
    const right = newPoint(time(24), low(24));    // defines the other ray

    // 2) One place for style settings (easy to tweak & reuse)
    const style = {
      fillBackground: true,        // soft fill between active rays
      transparency: 85,            // 0=opaque, 100=transparent
          median: { color:color.gray, linestyle: 2, linewidth: 5 }, // dashed base look
      // Turn on a few rays with distinct colors
      level1: { coeff: 0, visible: true, color: color.blue, linestyle: 0, linewidth: 1 },
      level2: { coeff: 1, visible: true, color: color.green, linestyle: 0, linewidth: 1 },
      level3: { coeff: 2, visible: true, color: color.gray, linestyle: 0, linewidth: 1 },
      level4: { visible: false },
      level5: { visible: false },
      level6: { visible: false },
      level7: { visible: false },
      level8: { visible: false }
      // Add more: level4..level11 as needed
    };

    // 3) Build the fana
    pitchfan(origin, left, right, style);
  }
};

Result

Tips

• Use meaningful pivots (clear swing highs/lows) for leftFanPoint and rightFanPoint so the rays align with the real trend.

• If the view feels busy, enable only 2–3 rays (level*) and hide the rest (visible: false) to keep focus.

• Combine with a trend filter (e.g., moving average slope) so you only draw fans in trending conditions.

Warning

Don’t pass malformed points (missing time or price). Always create anchors with newPoint(time(offset), priceValue); otherwise nothing will be drawn.

Good Practice

• Keep all visual choices in a single const style and reuse it across tests—this makes comparisons more reliable.

• Start minimal (two or three rays) and add more only if they improve clarity.