FVG Finder [PLLP]

///////////////////////////
ENGLISH (Spanish follows)
///////////////////////////

It is an indicator that shows the FVG (Fair Value Gap) generated by prices in any type of market.
These gaps are important because price generally tends to go through these bounds again and fill in the gaps, which can be a predictor of price action.

As main and differentiating characteristics of this indicator we have that:

• Provides key data on each FVG.
  
• It is highly configurable at the behavior level
  
• It is highly configurable on an aesthetic level.
  
• Includes a statistics panel that allows a quick view of the behavior of the FVGs in the asset and work timing.
  

Basic operation of the indicator:

• This indicator draws a box for each FVG it identifies. For each FVG we will have the input level, or 'IN Boundary', and the output level, or 'OUT Boundary'. The box corresponding to the FVG is limited by the 'IN Boundary' and 'OUT Boundary' levels.
  
• Likewise, each FVG will be assigned an 'Entry Price' and an 'Exit Price'.
  
• The entry price or 'Entry Price' is determined as the entry level of the FVG ('IN Boundary') increased according to the 'Entry Percentage'.
  
• The exit price or 'Exit Price' is determined as the exit level of the FVG ('OUT Boundary') decreased according to the 'Exit Percentage'.
  
• The 'Input Percentage' and 'Output Percentage' can vary from 0 to 50:
  
• >>> When the 'Entry Percentage' is set to 0 it means that the 'Entry Price' coincides with the 'IN Boundary' and when it is set to 50 it means that it is set at the central level of the FVG.
  
• >>> When the 'Exit Percentage' is set to 0 it means that the 'Exit Price' matches the 'Exit Limit' and when it is set to 50 it means that it is set at the central level of the FVG.
  
• It will be considered that a FVG can have 3 states:
  
• >>> 'Clean': when the price has never yet reached the 'Entry Price'.
  
• >>> 'Touched': when the price has reached the 'Entry Price' but not the 'Exit Price'.
  
• >>> 'Sunk': when the price has reached the 'Exit Price'.
  

• Within each FVG the following information is displayed:
  Icon that represents the state of the FVG.
  
• Percentage of price variation between the 'Entry Price' and the 'Exit Price'.
  
• Date and time the FVG is created.
  
• Date and time when the FVG goes into 'Sunk' status.
  
• Number of times a FVG has been 'touched'.
  
• >>> An FVG is considered to have been 'touched' when a candle pierces the 'Entry Price', that is, when the 'high' of a candle is above the 'Entry Price' and the 'low' below, or vice versa.
  
• >>> The first time a FVG is 'touched' its status changes from 'Clean' to 'Sunk'.
  

The statistics panel displays the following information for either bullish FVGs (second column), bearish FVGs (third column) or the total FVG set (fourth column) regardless of whether it is bullish or bearish:

• Number of FVGs that are in the 'Clean' state, that is, that have never been 'touched'.
  
• Number of FVGs that are in the 'Touched' state, that is, that have been 'touched' at some time but have not yet been drilled to 'Exit Price', that is, they have not yet evolved to the 'Sunk' state .
  
• Number of FVGs that are in the 'Sunk' state.
  
• Number of FVG that the first time you see that they have been 'touched' for the first time have also been 'pierced'. Therefore, it corresponds to the number of FVG in which the first 'touch' of the price manages to reach the 'Exit Price' and, therefore, the status changes directly from 'Clean' to 'Sunk' in that same candle.
  
• Mean number of times a FVG is 'touched' before evolving to the 'Sunk' state. This average is only calculated on the FVG in the 'Sunk' state.
  
• Percentage of FVG in 'Sunk' state with respect to the total FVG.
  
• Percentage of FVG whose 'Exit Price' has been pierced on the same candle in which it has been 'touched' for the first time. In other words, it represents the percentage of FVG that have passed from the 'Clean' to 'Sunk' state in a single candle with respect to the total of FVG in 'Sunk' state.
  

At the behavioral level, the configuration options stand out for:

• Possibility of establishing the percentage for the 'Entry Price' and for the 'Exit Price' of the FVG.
  
• Possibility of establishing the minimum price range percentage between the 'Entry Price' and the 'Exit Price' of the FVG. This makes it possible to hide FVGs that have very small price variations.
  
• Possibility of filtering between which start date and which end date you want to calculate the FVG.
  

On an aesthetic level, the configuration options stand out for:

• Possibility of being able to configure the color of bullish and bearish FVGs depending on their status ('Clean', 'Touched' or 'Sunk').
  
• Possibility of configuring the color and type of the bullish and bearish FVG price entry and exit lines depending on their status ('Clean', 'Touched' or 'Sunk').
  
• Possibility of configuring the color of the candles that have 'touched' a FVG (they have pierced the 'Entry Price') and of those that have pierced the 'Exit Price' (they have made it evolve to the 'Sunk' state) .
  
• Possibility of using a custom icon within the FVG text depending on its status.
  
• Possibility of showing, or not, the FVGs in 'Sunk' state. This allows to have a vision only of the 'past of the FVG' or only of the 'future of the FVG' (those that have not yet been sunk).
  
• Possibility of showing, or not, the FVGs in NO 'Sunk' state. This allows to have a vision only of the 'past of the FVG' or only of the 'future of the FVG' (those that have not yet been sunk).
  
• Possibility to show, or not, the number of times a FVG has been 'touched'.
  
• Possibility of showing, or not, when the FVG is created and when it goes to 'Sunk' status.
  
• Possibility of showing, or not, the statistics panel as well as choosing its location, the colors of the cells and the font size.
  

WARNING:
1) Due to TradingView's limitations on the number of boxes and lines that can be added to a chart, it is advisable to always apply a value of no less than '0.1' for the 'Minimum FVG price travel' setting.
2) Due to the internal calculations that this indicator requires, the loading time can be long. In the event that the indicator does not load and a 'time out' error is obtained, the value of the 'Minimum FVG price travel' configuration parameter must be increased, thus reducing the number of FVGs that will be identified.









///////////////////////////
ESPAÑOL
///////////////////////////

Se trata de un indicador que muestra los FVG (Fair Value Gap) que generan los precios en cualquier tipo de mercado.
Estos gaps son importantes porque, en general, el precio tiende a pasar por estas cotas nuevamente y rellenar los gaps, lo cual puede constituir una manera de predecir la acción del precio.

Como características principales y diferenciadoras de este indicador tenemos que:

• Aporta datos clave de cada FVG.
  
• Es altamente configurable a nivel de comportamiento
  
• Es altamente configurable a nivel estético.
  
• Incorpora un panel de estadísticas que permite obtener de manera rápida una visión del comportamiento de los FVG en el activo y temporalidad de trabajo.
  

Funcionamiento básico del indicador:

• Este indicador dibuja un recuadro para cada FVG que identifica. Para cada FVG tendremos el nivel de entrada, o 'IN Boundary', y el nivel de salida u 'OUT Boundary'. El recuadro que corresponde al FVG queda limitado por los niveles 'IN Boundary' y 'OUT Boundary'.
  
• Asimismo, a cada FVG se le asignará un 'Entry Price' y un 'Exit Price'.
  
• El precio de entrada o 'Entry Price' se determina como el nivel de entrada del FVG ('IN Boundary') incrementado según el 'Entry Percentage'.
  
• El precio de salida o 'Exit Price' se determina como el nivel de salida del FVG ('OUT Boundary') decrementado según el 'Exit Percentage'.
  
• El 'Entry Percentage' y 'Exit Percentage' pueden variar de 0 a 50:
  
• >>> Cuando el 'Entry Percentage' se establece a 0 significa que el 'Entry Price' coincide con el 'IN Boundary' y cuando se establece a 50 significa que se establece al nivel central del FVG.
  
• >>> Cuando el 'Exit Percentage' se establece a 0 significa que el 'Exit Price' coincide con el 'OUT Boundary' y cuando se establece a 50 significa que se establece al nivel central del FVG.
  
• Se considerará que un FVG puede tener 3 estados:
  
• >>> 'Clean': cuando el precio aun no ha alcanzado nunca el 'Entry Price'.
  
• >>> 'Touched': cuando el precio ha alcanzado el 'Entry Price' pero no el 'Exit Price'.
  
• >>> 'Sunk': cuando el precio ha alcanzado el 'Exit Price'.
  

• Dentro de cada FVG se muestra la siguiente información:
  Icono que representa el estado del FVG.
  
• Porcentaje de variación del precio entre el 'Entry Price' y el 'Exit Price'.
  
• Fecha y hora en que se crea el FVG.
  
• Fecha y hora en que se el FVG pasa a estado 'Sunk'.
  
• Número de veces en que un FVG ha sido 'tocado'.
  
• >>> Se considera que un FVG ha sido 'tocado' cuando una vela perfora el 'Entry Price', es decir, cuando el 'high' de una vela está por encima del 'Entry Price' y el 'low' por debajo, o viceversa.
  
• >>> La primera vez que un FVG es 'tocado' su estado pasa de 'Clean' a 'Sunk'.
  

El panel de estadísticas muestra las siguientes informaciones tanto para los FVG alcistas (segunda columna), los FVG bajistas (tercera columna) o el conjunto del total de FVG (cuarta columna) sin importar si es alcista o bajista:

• Número de FVG que están en estado 'Clean', es decir, que nunca han sido 'tocados'.
  
• Número de FVG que están en estado 'Touched', es decir, que alguna vez han sido 'tocados' pero aún no han sido perforados hasta el 'Exit Price', es decir, aún no han evolucionado al estado 'Sunk'.
  
• Número de FVG que están en estado 'Sunk'.
  
• Número de FVG que la primera vez que en la misma vea en que han sido 'tocados' por primera vez también han sido 'perforados'. Se corresponde, por lo tanto, el número de FVG en que el primer 'toque' el precio consigue alcanzar el 'Exit Price' y, por lo tanto, el estado pasa en esa misma vela de 'Clean' a 'Sunk' directamente.
  
• Media del número de veces que un FVG es 'tocado' antes de evolucionar hasta el estado 'Sunk'. Esta media solo se calcula solamente sobre los FVG en estado 'Sunk'.
  
• Porcentaje de FVG en estado 'Sunk' respecto el total de FVG.
  
• Porcentaje de FVG cuyo 'Exit Price' ha sido perforado en la misma vela en que ha sigo 'tocado' por primera vez. Es decir, representa el porcentaje de FVG que han pasado del estado 'Clean' a 'Sunk' en una única vela respecto el total de FVG en estado 'Sunk'.
  

A nivel de comportamiento las opciones de configuración destacan por:

• Posibilidad de establecer el porcentaje para el 'Entry Price' y para el el 'Exit Price' del FVG.
  
• Posibilidad de establecer el porcentaje mínimo de recorrido del precio entre el 'Entry Price' y el 'Exit Price' del FVG. Esto permite ocultar los FVG que presenten variaciones muy pequeñas del precio.
  
• Posibilidad de filtrar entre qué fecha inicio y qué fecha fin se desea calcular los FVG.
  

A nivel estético las opciones de configuración destacan por:

• Posibilidad de poder configurar el color de los FVG alcistas y bajistas en función de su estado ('Clean', 'Touched' o 'Sunk').
  
• Posibilidad de configurar el color y tipo de las líneas de entrada y salida del precio de los FVG alcistas y bajistas en función de su estado ('Clean', 'Touched' o 'Sunk').
  
• Posibilidad de configurar el color de las velas que han 'tocado' un FVG (han perforado el 'Entry Price') y del de las que han perforado el 'Exit Price' (lo han hecho evolucionar al estado 'Sunk').
  
• Posibilidad de utilizar un icono personalizado dentro del texto del FVG dependiendo del estado de éste.
  
• Posibilidad de mostrar, o no, los FVG en estado 'Sunk'. Esto permite tener una visión únicamente del 'pasado de los FVG' o bien únicamente del 'futuro de los FVG' (los que aún no han sido hundidos).
  
• Posibilidad de mostrar, o no, los FVG en estado NO 'Sunk'. Esto permite tener una visión únicamente del 'pasado de los FVG' o bien únicamente del 'futuro de los FVG' (los que aún no han sido hundidos).
  
• Posibilidad de mostrar, o no, el número de veces que un FVG ha sido 'tocado'.
  
• Posibilidad de mostrar, o no, cuándo se crea el FVG y cuándo pasa a estado 'Sunk'.
  
• Posibilidad de mostrar, o no, el panel de estadísticas así como de elegir la ubicación de éste, los colores de las celdas y el tamaño de la fuente.
  

ADVERTENCIA:
1) Debido a las limitaciones de TradingView respecto el número de cajas y líneas que se pueden añadir a un gráfico, es aconsejable aplicar siempre un valor no inferior a '0.1' para el parámetro de configuración 'Minimum FVG price travel'.
2) Debido a los cálculos internos que requiere este indicador el tiempo de carga puede ser elevado. En el caso de que el indicador no se cargue y se obtenga un error de 'time out' debe incrementarse el valor del parámetro de configuración 'Minimum FVG price travel' reduciéndose así la cantidad de FVG que se identificarán.

Versionshinweise:

Just removed the minimum value for "FVG Entry / Exit Percentatge" fields. Now can be set to zero.