Fibonacci Fan Annotation

• Overview
• Adding annotation via settings
• Levels
• Visual settings
• Labels
  • Enable/Disable
  • Format
  • Visual Settings

Overview

Fibonacci Fan is a Fibonacci retracement tool that takes both price and time into consideration. Comparing to horizontal Fibonacci lines it offers an additional feature — price movement projection far further in time.

Fibonacci Fan annotation allows to add this type of drawing to the chart, as any other annotation it can be drawn by user or added to the chart via XML or JSON settings. In this article you can learn how to add it via XML or JSON settings and what visual settings can be done.

To learn about basic settings, that can be done with an annotation please refer to: Drawing Tools and Annotations: General Settings.

Adding annotation via settings

To add a Fibonacci Fan annotation to a chart you need to, as with any other annotation, add an annotation node, assign the id, set "FibonacciFan" type and specify the chart id using chart attribute.

In fibonacci_fan_annotation node you need specify value and time anchors, which define two points needed to draw this type of annotation.

All this you can see in the basic XML/JSON snippet below:

Live sample below shows a chart with this sample basic Fibonacci Fan annotation:

Levels

Version 1.7 introduces new, improved, Fibonacci Fan: with configurable number of Price Levels and Time Levels.

You have an option to choose what levels are displayed and even specify the ratio of levels. It is done in <levels> node, like shown in the snippet below. Please note, that this snippet also shows default levels and ratios: you can define any number of levels and set any ratio in value attribute, even if these values do not match Fibonacci sequence.

Note: in this snippet we show how to alter levels of a single annotation, but you can override defaults and change all annotations of a given type, learn about changing default in Annotations General Settings: Defaults.

Another important thing you should understand is the fact that level node can be used to configure visualization of a level: label, line and states settings, it can be done like that:

Take a look at the live sample where levels and visualization are changed in defaults section:

Note: do not forget that only levels specified in <levels> node will be displayed, you can't change one level only - you should at least specify values for all other levels.

Please also take a look at the settings and sample that show how defaults should be modified to revert Fibonacci Fan to the state it was in versions 1.6.1 and earlier:

And here is a live sample with such settings put into defaults section:

Visual settings

You have a total control over the look of the Fibonacci Fan, to define visual settings you need to add settings node and then use line node to set how it should look like. Sample XML/JSON snippet below shows this.

If you click on line node in the snippet, XML or JSON reference will be opened and you will be able to browse all possible settings, including the look of the line in different states.

Version 1.7 introduces more complex Fibonacci Fan: with Price lines, Time lines, Grid and separate settings for Trend line. Whilst the settings above still work and, if set, are applied to all lines at once, you can also configure all lines separately with access to states and all the stuff, that is available:

Note: all lines (<trend_line>, <grid_line>, <price_level_grid_line>, <time_level_grid_line>, <price_level_line>, <time_level_line>) inherit settings specified in <line> node; <price_level_grid_line> and <time_level_grid_line> inherit setting from <grid_line>.

Thus: be careful with this inheritance, it can be used to minimize and simplify settings, but you should understand how settings depend on each other.

Live sample below contains Fibonacci Fan Annotation colored, note that editing markers coloring is also modified here:

Labels

Since version 1.7 all Fibonacci annotations has labels and they are enabled by default, this section describes how you can disable them, configure text displayed and tune visualization.

Note: in this section we show how to alter settings of a single annotation, but you can override defaults and minimize the size of configs, learn about changing default in Annotations General Settings: Defaults.

Enable/Disable

Unlike other Fibonacci tools, Fan has four sets of labels and you can turn them all on and off separately: Price levels labels (near and far) and Time levels labels (near and far).

To disable labels for all levels in all states for a single annotation you need to set the following XML:

To disable label for one or several selected levels you need to use <levels> node and do enable/disable there, please note that all required levels should be specified, see Levels for clarification:

You can also make labels appear only in some states, for example when annotation is selected or hovered:

Here is a sample of a chart with two annotations, one without any labels, and another with labels that appear only if annotation is hovered or selected:

Format

You can define the text to be displayed in labels, you can either put static text in them or use tokens: {%LevelValue} — to display level values and/or {%Value} and {%Date} — to display value (price) and timestamp corresponding to the level. Sample XML snippet shows basic formatting syntax:

As you can see, you can use common Number and Date Time formatting options. And, of course, you can use all Font configuration options.

See sample chart in the next section to see how formatting, font and visual settings work together.

Visual Settings

Level labels, like any other label, has background with fill and border and font confuguration options, by default labels are formatted like this:

You can change these settings for any annotation or all of them, you can change the look of the label in some state, you can even change the labels behavior for the given levels. Please take a look at the sample below: defaults section and labels visual settings can completely change the look of annotations: