Fibonacci Time Zones Annotation

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

Overview

An indicator used by technical traders to identify periods in which the price of an asset will experience a significant amount of movement. This charting technique consists of a series of vertical lines that correspond to the sequence of numbers known as Fibonacci numbers (1, 2, 3, 5, 8, 13, 21, 34, etc.). Once a trader chooses a starting position (most commonly following a major move) on the chart, a vertical line is placed on every subsequent day that corresponds to the position in the Fibonacci number sequence.

Fibonacci Time Zones 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 Time Zones annotation to a chart you need to, as with any other annotation, add an annotation node, assign the id, set "FibonacciTimezones" type and specify the chart id using chart attribute.

In fibonacci_timezones_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 Time Zones annotation:

Levels

Since version 1.7 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.

Visual settings

You have a total control over the look of the Fibonacci Time Zones, 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.

Live sample below contains Fibonacci Time Zones Annotation colored and dashed, 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

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 (in this snippet only a part of default levels is 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 where annotation labels 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 value and/or {%Date} — to display 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: