Lenguaje de indicadores personalizados
Requiere SuperDisponible en: Web
En esta página
- Escribe tu primer indicador personalizado
- La forma de un script
- Números y condiciones
- Entradas
- Longitudes, desplazamientos y ventanas de más de 200 barras
- Calentamiento y valores ausentes
- Límites
- Sin bucles, sin autorreferencias, sin barras futuras
- Los scripts oficiales
- RELVOL (volumen relativo)
- VWAP Distance
- RSI (índice de fuerza relativa de Wilder)
- MACD
- Squeeze
- Configuraciones listas para usar
- Lo que el lenguaje todavía no puede expresar
- Hábitos de Pine Script y thinkScript
- Usar un indicador personalizado en un escaneo
- Usar un indicador personalizado en un gráfico
- Cómo se dibuja un script en un gráfico
- Versiones y actualización de un escaneo
- Compartir un escaneo que usa un indicador personalizado
- Preguntar al terminal de IA sobre un script
- Qué planes incluyen indicadores personalizados
- Relacionado
Un indicador personalizado es un indicador que escribes tú mismo, como un script breve, cuando ningún estudio integrado calcula lo que necesitas. Una vez guardado, puedes filtrar con él en un escaneo, dibujarlo en un gráfico y pedir al terminal de IA que te lo explique. Los scripts se ejecutan sobre el mismo historial de precios que cualquier estudio integrado, así que un indicador personalizado se escanea en todo el universo como cualquier otro filtro.
El lenguaje está inspirado en thinkScript: unas pocas sentencias, las series de precios habituales y una biblioteca estándar de funciones como Average, ExpAverage, StDev, Highest y ATR. Este artículo explica cómo escribir un script, recorre los scripts oficiales y enumera los límites y lo que el lenguaje todavía no puede expresar.
Referencia: El panel Referencia del editor es siempre la lista actualizada de todas las funciones, con sus argumentos y las longitudes que aceptan, además de una Guía con más ejemplos. Todos los ejemplos de este artículo compilan, salvo los dos que, según el texto justo encima, no compilan.
Escribe tu primer indicador personalizado
- En Indicadores personalizados, en la barra lateral, abre Mis scripts. Es tu biblioteca de scripts.
- Haz clic en Nuevo script para empezar en blanco, o abre la pestaña Oficiales y elige Usar como plantilla en uno de los scripts oficiales. Una plantilla guarda una copia que puedes editar.
- Escribe el script. El editor lo revisa mientras escribes: la esquina inferior derecha del editor muestra el primer problema con su línea y columna, y el panel Presupuesto muestra qué parte de los límites de coste y de historial usa cada gráfico.
- Prueba valores en el panel Entradas. Ese panel muestra exactamente lo que pedirá un escaneo o un gráfico. Los valores que pruebes ahí no se guardan.
- Haz clic en Guardar. El primer guardado es la versión 1, y cada guardado posterior es una versión nueva.
Este es un script completo. Mide a qué distancia está el cierre de su media de 50 barras, en porcentaje:
Para escribir y guardar scripts necesitas una pantalla más grande. En un teléfono, el editor muestra el script guardado en modo de solo lectura.
La forma de un script
Un script es una lista de sentencias, y cada sentencia termina en ;. Hay cuatro tipos, más las instrucciones de dibujo:
inputdeclara un parámetro que un escaneo o un gráfico puede cambiar.defda nombre a una serie intermedia. Undefnunca se devuelve por sí solo.plotes una salida, que la app llama gráfico (plot). Un script tiene de 1 a 8 gráficos, y cada uno es lo que un escaneo compara o lo que se dibuja sobre el gráfico de precios.declare upper;odeclare lower;(opcional, como mucho una vez) indica dónde se dibujan todos los gráficos: sobre las velas o en su propio panel.
Una sentencia siempre tiene la forma palabra_clave nombre = expresión;. No hay expresiones sueltas, ni definiciones de funciones, ni return, ni reasignación de un nombre que ya existe. Los saltos de línea y los espacios son libres, así que una sentencia puede ocupar varias líneas.
Los comentarios empiezan con # y llegan hasta el final de la línea.
Los nombres no distinguen mayúsculas de minúsculas: ni las palabras clave, ni las funciones, ni los nombres que declaras. Signal, signal y SIGNAL son un mismo nombre, y un nombre se declara una sola vez entre todas las entradas, def y gráficos. El error más común es calcular un valor en un def y luego dibujarlo con el mismo nombre. Esto no compila:
Dale al def su propio nombre, o dibuja la expresión directamente:
Un nombre debe declararse antes de la línea que lo usa. Las series integradas son open, high, low, close y volume.
Los desplazamientos leen hacia atrás en el tiempo: close[1] es el cierre de la barra anterior, y x[k] es el valor de cualquier expresión k barras atrás, condiciones incluidas.
if … then … else es una expresión que elige un valor en cada barra. El else es obligatorio, las dos ramas deben ser del mismo tipo, y se pueden encadenar con else if:
Números y condiciones
Cada valor es una serie de uno de dos tipos:
- un número: precio, volumen, aritmética y cualquier función que calcule un valor;
- una condición (verdadero/falso): una comparación (
==,!=,<,<=,>,>=),and,or,not,CrossesAbove,CrossesBeloweIsNaN.
Compara con ==, nunca con =, que solo aparece en input, def y plot. Una condición no es un número: para contar cuántas veces fue verdadera, usa CountTrue.
Un gráfico puede ser una condición. Un gráfico verdadero/falso se lee como «es verdadero» o «es falso» en un escaneo, y en el gráfico de precios pone un punto sobre las barras en las que es verdadero.
Entradas
Hay dos tipos de entrada:
- Una entrada numérica siempre tiene un rango:
input length = 14 (2..200);. El rango es obligatorio. Limita lo que un escaneo o un gráfico puede fijar, y los límites de más abajo se miden en su extremo superior. Una entrada es un número entero cuando su valor por defecto y sus dos extremos son enteros; si no, es decimal (2.0 (0.5..4.0)). - Una entrada de serie nombra una serie de datos:
input src = volume;. Un escaneo o un gráfico puede cambiarla por cualquier otra serie de la referencia de entradas de estudios, como el volumen en dólares, y el mismo script se ejecuta entonces sobre esa serie.
Un valor fuera del rango de una entrada se rechaza; nunca se recorta. Una entrada no se puede restringir en función de otra, así que nada impide que un escaneo fije una longitud rápida mayor que una lenta: da a cada entrada un rango razonable por sí sola.
No existen hl2 ni ohlc4: escribe (high + low) / 2.
Longitudes, desplazamientos y ventanas de más de 200 barras
La longitud de una función de ventana, y la k de x[k], deben ser una constante entera o una entrada entera. No se pueden calcular: length * 2 no es una longitud, así que declara una segunda entrada. Las longitudes y los desplazamientos llegan hasta 200 barras, y una entrada usada como longitud debe mantener todo su rango declarado dentro del rango de longitudes de la función.
Una ventana más larga se compone con tramos de 200 barras como máximo unidos por desplazamientos. Un máximo de 252 barras (52 semanas) es el máximo de las últimas 200 barras y el máximo de las 52 barras anteriores a esas:
Lowest, Sum, Average (una suma compuesta dividida por la ventana) y CountTrue se combinan del mismo modo. StDev, Variance, ZScore y PercentRank, no.
Calentamiento y valores ausentes
El valor de una ventana está ausente (NaN) hasta que la ventana se llena: Average(close, 50) no tiene valor en las primeras 49 barras de una acción. BarsSince y ValueWhen están ausentes cuando la condición no fue verdadera dentro de su ventana.
Un valor ausente no cumple ninguna comparación. En un escaneo, la acción simplemente no aparece en los resultados. Normalmente es lo que quieres: BarsSince(released, 50) <= 3 significa «en las últimas 3 barras», y excluye discretamente todas las acciones en las que el evento no ocurrió. Cuando prefieras un número, Nz(x) sustituye un valor ausente por 0, y Nz(x, r) por r.
Protege toda división cuyo denominador pueda ser 0, como en if d > 0 then n / d else 0. En una acción sin movimiento o suspendida, los rangos, las sumas de volumen y las desviaciones estándar valen 0.
Límites
Cada script se revisa antes de guardarse, y otra vez cuando un escaneo lo ejecuta. El medidor Presupuesto del editor muestra cómo está cada gráfico, así que rara vez tendrás que calcularlo a mano.
- 800 barras de historial con calentamiento por gráfico. Cada gráfico puede necesitar como mucho 800 barras de historial antes de su primer valor. Una ventana de longitud
nnecesitan − 1barras, un desplazamiento[k]sumak, y las ventanas anidadas se suman. Las medias recursivas (ExpAverage,WildersAverage,AdaptiveAverage,RSI,ATR) arrastran su estado de una barra a otra, así que cuentan 4 veces su longitud:ExpAverage(close, 200)por sí sola necesita las 800 barras. - Medido en el extremo superior de cada rango. El historial y el coste se miden con cada entrada entera en el máximo que declaraste, así que el rango importa tanto como el valor por defecto. Cuando un script supera un límite, reduce el rango, no el valor por defecto.
- Un presupuesto de coste por gráfico. La mayoría de las funciones cuestan lo mismo sea cual sea su longitud. Seis cuestan en proporción a ella:
Variance,VarianceSample,StDev,StDevSample,ZScorey, a la mitad de ritmo,PercentRank. Un soloStDevde longitud 200 consume la mayor parte del presupuesto de un gráfico, así que un segundo solo cabe con un rango menor (dos de longitud 100 cuestan más o menos lo mismo que uno de 200). - Por script: como mucho 8 gráficos, 16 entradas numéricas y 16 KB de código.
- Por escaneo: un escaneo puede usar hasta 5 indicadores personalizados, según tu plan (5 es el máximo que permite cualquier plan), y todos juntos comparten un mismo presupuesto de coste. Cuenta cada fila de filtro, aunque dos usen un mismo script, y también el orden. El creador de escaneos suma su coste mientras lo construyes y avisa cuando un escaneo podría ser rechazado.
Tu plan determina cuántos scripts puedes conservar y cuántos indicadores personalizados puede usar un escaneo o un gráfico, y esas cifras se muestran en la app: la biblioteca muestra cuántos scripts tienes, y el creador de escaneos y los ajustes del gráfico avisan cuando llegas al límite de tu plan. El límite de historial de tu plan se aplica a un indicador personalizado igual que a un estudio integrado.
Una media exponencial de una media exponencial con el rango completo supera el límite de historial. Con slowLength hasta 200, este gráfico necesitaría 999 barras, así que no compila:
Limitar slowLength a 150 lo deja en 799 barras:
Sin bucles, sin autorreferencias, sin barras futuras
Un script es una expresión por nombre, evaluada sobre todas las barras a la vez. No hay bucles, ni variables que cambien, y un nombre no puede referirse a sí mismo, ni siquiera con desplazamiento. Los patrones para los que se suele recurrir a la recursión ya vienen integrados:
El precio de entrada del último cruce y cuánto hace que ocurrió:
Las barras futuras nunca están disponibles: un desplazamiento cuenta hacia atrás, así que close[-1] no compila.
Los scripts oficiales
scanr.ai incluye 15 scripts oficiales. Cualquiera con acceso puede usarlos tal cual en un escaneo o en un gráfico, y Usar como plantilla, en la pestaña Oficiales de la biblioteca, guarda una copia que puedes modificar.
Cinco de ellos enseñan el lenguaje, desde un script de principiante de una línea hasta uno avanzado de tres gráficos: RELVOL, VWAP Distance, RSI, MACD y Squeeze. Léelos en orden para aprenderlo. Los otros diez son configuraciones listas para usar.
RELVOL (volumen relativo)
El volumen relativo hace una pregunta a cada barra: ¿es normal este volumen? Responde con un z-score, el número de desviaciones estándar que el volumen de la barra está por encima o por debajo de su media de las últimas length barras. 0 es un día normal, 2 es inusualmente fuerte y una lectura negativa es más tranquila de lo habitual.
Todo el indicador es una línea. input src = volume; convierte la serie en una entrada, así que un escaneo puede aplicar la misma estadística al volumen en dólares o a cualquier otra serie. Pruébalo en un escaneo: ZVol mayor que 2 encuentra las acciones cuyo volumen diario está más de dos desviaciones estándar por encima de su media de 60 días.
VWAP Distance
VWAP Distance mide cuánto se ha alejado el cierre de un VWAP móvil (el precio medio ponderado por volumen), en porcentaje. Por encima de 0, el cierre está por encima del precio medio que pagaron los operadores en las últimas length barras.
El script construye la respuesta por pasos, cada uno un def. La última línea protege la división: una ventana sin volumen (una acción suspendida o recién salida a bolsa) da 0 en vez de dividir entre nada. Pruébalo en un escaneo: VwapDist menor que −5 encuentra las acciones que cierran más de un 5% por debajo de su VWAP de 20 días.
RSI (índice de fuerza relativa de Wilder)
El RSI compara el tamaño de las subidas recientes con el de las bajadas recientes, de 0 a 100. Este script escribe la definición original de Welles Wilder a partir de sus partes, para que cada paso sea visible.
price[1] es un desplazamiento: el cierre de la barra anterior. WildersAverage es recursiva, así que cuenta cuatro veces length para el calentamiento: con la length máxima de 200 este script necesita 800 barras, justo el límite. Pruébalo en un escaneo: RSI menor que 30 encuentra acciones en sobreventa.
MACD
El MACD sigue la tendencia a través de la diferencia entre una media exponencial rápida y otra lenta. La línea MACD es la media rápida menos la lenta, la línea de señal es una media exponencial de la línea MACD, y el histograma es la distancia entre ambas.
Este script tiene tres gráficos, y un escaneo elige el que compara. Las medias exponenciales encadenadas se suman para el calentamiento de 800 barras, y por eso slowLength se detiene en 150: con 200, Signal necesitaría 999 barras. Los nombres no distinguen mayúsculas de minúsculas, así que una entrada llamada signal chocaría con el gráfico Signal; la entrada se llama signalLength. Pruébalo en un escaneo: Histogram cruzando por encima de 0 encuentra el clásico cruce alcista.
Squeeze
Una compresión de volatilidad (squeeze) es un mercado tranquilo que acumula tensión: las Bollinger Bands se contraen dentro de los Keltner Channels, y el momento en que vuelven a salir es cuando el squeeze «se dispara», a menudo el inicio de un movimiento mayor.
InSqueeze es un gráfico verdadero/falso. released aplica un desplazamiento a una condición: es verdadera en la única barra en la que la anterior estaba comprimida y esta ya no. BarsSince(released, lookback) está ausente cuando no hay ninguna liberación dentro de la ventana, así que BarsSinceRelease como mucho 3 excluye discretamente todas las acciones cuyo squeeze no se ha disparado últimamente. Pruébalo en un escaneo: combina dos gráficos del mismo script, BarsSinceRelease como mucho 3 y Momentum por encima de 0, para el lado alcista de una liberación reciente.
Configuraciones listas para usar
Estos diez buscan una configuración concreta. Abre uno en la pestaña Oficiales para leer su script, sus entradas y lo que significa cada gráfico. Sus nombres y textos solo están en inglés.
Lo que el lenguaje todavía no puede expresar
Cuando un indicador necesita algo de esta lista, la respuesta honesta es que esta versión no puede expresarlo, seguida de lo más parecido que sí puede.
- Otra temporalidad, como un RSI semanal en un gráfico diario. Un script ve las barras de la temporalidad en la que se escanea o se dibuja.
- Otro símbolo, como una relación con SPY o la fuerza relativa frente a un ETF sectorial.
- Valores acumulados desde la primera barra o desde un ancla: un OBV o una línea A/D auténticos, máximos históricos, un VWAP anclado, un VWAP de sesión que se reinicia cada día. Una versión por ventana sí se puede expresar cuando una ventana es aceptable.
- Autorreferencias más allá de las funciones integradas: SuperTrend, Parabolic SAR, un stop dinámico que solo sube. Cada uno se define a partir de su propio valor anterior con una regla que ninguna función integrada calcula.
- Barras futuras: medias centradas, ZigZag, cualquier cosa que necesite
x[-1]. - Horas, sesiones y calendarios: la hora del día, el día de la semana, el rango de apertura, las fechas de resultados.
- Cualquier cosa fuera de la serie de precios: sector, fundamentales, eventos. Combínalos con un indicador personalizado en el mismo escaneo.
- Funciones que no están en la biblioteca estándar, como las medias ponderadas o de Hull, la regresión lineal o la correlación. El panel Referencia del editor enumera los nombres que la gente prueba en No disponible en esta versión, con qué usar en su lugar.
- Texto, colores literales, herramientas de dibujo y alertas. Un gráfico es un número o una condición, nada más. Un script puede pedir que un gráfico de precios dibuje un gráfico de cierta manera, con los colores del tema.
Un OBV por ventana, que sí se puede expresar:
Hábitos de Pine Script y thinkScript
El lenguaje está inspirado en thinkScript, pero es un lenguaje propio, y estos hábitos no compilan:
Nombres de otros lenguajes, en el panel Referencia, encuentra la función que corresponde a un nombre de Pine Script o thinkScript.
Usar un indicador personalizado en un escaneo
- En el creador de escaneos, haz clic en + en un grupo de filtros y elige Indicador personalizado.
- Elige uno de tus scripts o uno oficial. Si el script tiene varios gráficos, te pedirá cuál comparar.
- Fija sus entradas y después la condición: mayor que, menor que, cruza por encima de, etc. Un gráfico verdadero/falso se lee «es verdadero» o «es falso» en lugar de un número.
Cada filtro de indicador personalizado muestra el coste combinado del escaneo, y avisa cuando el escaneo podría superar su presupuesto y qué entradas conviene bajar. Si aun así el escaneo se rechaza, el error indica qué indicador y por qué.
Un escaneo guardado conserva la versión exacta del script con la que se guardó, así que editar un script nunca cambia lo que encuentra un escaneo existente. Consulta Versiones y actualización de un escaneo más abajo.
Usar un indicador personalizado en un gráfico
Abre los ajustes del gráfico y, en Indicadores personalizados, haz clic en Añadir un indicador personalizado. Un gráfico que es un nivel de precio, como una media o una banda, se dibuja sobre las velas. Los demás gráficos de un script comparten un panel. Un gráfico verdadero/falso pone un punto sobre cada barra en la que es verdadero. declare upper; o declare lower; en el script fija la posición de todos los gráficos.
Cómo se dibuja un script en un gráfico
Cinco instrucciones cambian ese comportamiento. Un escaneo las ignora, así que cambiar el estilo de un script nunca cambia lo que encuentra. Escríbelas en cualquier parte del script. Un script admite hasta 16 niveles y 8 sombreados.
style Name histogram;fija cómo se dibuja un gráfico:line,step(mantiene cada valor hasta la barra siguiente),area,dots,columns,histogram,markersohidden(no se dibuja, pero unfill, unbarcoloro un escaneo pueden usarlo). Añadeby signpara colorear cada barra al alza desde cero y a la baja por debajo, y despuésfadingpara atenuar una barra que volvió hacia cero. Un gráficomarkersadmite una forma (arrow_up,arrow_down,triangle_up,triangle_down,dot) y una posición (above,below,value).pane A, B;dibuja esos gráficos juntos en un panel propio. Un nivel de precio no puede ir en unpane.level 70;dibuja una línea horizontal, ylevel 30 to 70;una banda sombreada. Un valor puede ser una entrada numérica, y la línea se mueve con ella. Un script con más de un panel, o cuyos gráficos se dibujan todos sobre las velas, indica cuál:level 0 in Name;.fill A, B;sombrea entre dos gráficos de un panel, o entre un gráfico y un número:fill Hist, 0;. El sombreado usa el color al alza donde A está por encima de B y el color a la baja donde está por debajo.barcolor Cond;colorea las velas donde un gráfico verdadero/falso es verdadero: al alza por defecto, obarcolor Cond down;oneutral. Si dos son verdaderos en una barra, gana la instrucción posterior.
Un MACD que las usa, con un histograma coloreado según el signo, una flecha bajo cada cruce, una línea en 0 y sombreado entre sus dos líneas:
Un script no nombra colores: los elige el tema del gráfico. Los colores y la posición que fijes en tu gráfico ganan a los del script. Un fill o un pane solo ven los gráficos que tienes añadidos, así que añade juntos los gráficos de un script para verlos juntos. Cada uno cuenta para el límite por gráfico de tu plan, así que un script de cuatro necesita Super Pro para mostrarlos todos.
Versiones y actualización de un escaneo
Cada guardado crea una versión nueva, y las anteriores se conservan. Un escaneo, guardado o no, usa la versión con la que se creó hasta que lo cambies.
Cuando existe una versión más reciente de uno de tus scripts, el creador de escaneos muestra un aviso encima de los filtros (Existe una versión más reciente (v3) de «Mi RSI») y el filtro lleva una insignia. No cambia nada hasta que haces clic en Actualizar a v3. La actualización comprueba primero si la nueva versión cambiaría lo que encuentra el escaneo: un gráfico renombrado o eliminado, una entrada que desapareció o un valor guardado fuera de un rango nuevo. Si lo cambiaría, el aviso enumera los problemas y no guarda nada. Si no, un escaneo guardado sin cambios pendientes se guarda con un clic; en otro caso, los filtros en pantalla pasan a la nueva versión y guardas el escaneo como siempre.
Para mover varios escaneos a la vez, abre el script en el editor. Debajo de su nombre, la página muestra cuántos escaneos guardados lo usan y cuántos de ellos tienen alertas activas, por ejemplo Usado por 5 escaneos (2 con alertas). Cuando algunos están en una versión anterior, haz clic en Actualizar escaneos a v3. El diálogo los separa en dos grupos:
- Los escaneos cuyos filtros se conservan, con el recordatorio de que al guardar un escaneo sus alertas empiezan de nuevo con la nueva versión. Los tickers que ya están en sus resultados no generarán alertas. Haz clic en Actualizar 3 escaneos para guardarlos de uno en uno.
- Los escaneos que necesitan revisión, con sus problemas y un enlace para abrir cada uno en el creador de escaneos. La acción no los guarda.
Al terminar, el diálogo informa de cada escaneo. Si las alertas de un escaneo no pueden pasar a la nueva versión, aparece como sin actualizar y sigue en su versión anterior. Si paras la ejecución o sales de la página, los escaneos a los que no llegó también siguen en su versión. Vuelve a ejecutarla y continúa con el resto.
Eliminar un script se puede deshacer: los scripts eliminados quedan en Eliminados en la biblioteca y se pueden restaurar. Antes de eliminar, la confirmación enumera los escaneos guardados que lo usan. Esos filtros quedan detenidos hasta que el script se restaure.
Compartir un escaneo que usa un indicador personalizado
Tus scripts son privados. Cuando compartes un escaneo que usa uno de ellos, el diálogo de compartir avisa de que quienes reciban el enlace no podrán usarlo. Quien abra el enlace verá los demás filtros y tus resultados. Cuando alguien abre el escaneo en su editor, cualquier indicador personalizado que no pueda usar se desactiva, no se elimina, para que vea lo que hacía el escaneo y ponga el suyo. Si el orden usa un script que no puede usar, se quita. Los scripts oficiales no son de nadie, así que nunca se desactivan, pero, como cualquier indicador personalizado, solo funcionan en Super y Super Pro: en un plan sin indicadores personalizados, un escaneo que use uno se rechaza.
Preguntar al terminal de IA sobre un script
En el editor, Preguntar a la IA sobre este script abre el chat bajo el editor, que ve tu script y los problemas en pantalla. En un teléfono, abre el terminal de IA con ellos. Lee la misma referencia del lenguaje y la misma guía que el editor, así que puede explicar un script entrada por entrada, explicar por qué una línea no compila y proponer una corrección, que comprueba con el compilador real antes de darla por buena. El terminal de IA también puede redactar un script nuevo para que lo abras en el editor, y guardar un borrador cuando confirmas su tarjeta. Consulta Preguntar a la IA. El terminal de IA forma parte de Super y Super Pro.
Qué planes incluyen indicadores personalizados
Escribir, guardar, escanear y dibujar indicadores personalizados forma parte de Super y Super Pro. Los planes se diferencian en cuántos scripts puedes conservar y cuántos indicadores personalizados puede usar un escaneo o un gráfico, y la app muestra tus límites actuales. En cualquier plan puedes leer los scripts oficiales. Si tu plan vence, tus scripts guardados siguen pudiéndose leer y eliminar.

