IDE: indicadores y datos

Cómo registrar y leer indicadores en tu código, y cómo acceder a precios e históricos.

Código en el IDE registrando indicadores y leyendo sus valores
Registras los indicadores una vez en on_init() y luego lees su valor (.value) en on_bar().

En el IDE registras indicadores una sola vez en `on_init()` y después lees su valor en cada vela dentro de `on_bar()`. Este artículo es tu guía de referencia: aquí está el catálogo completo de los 28 indicadores disponibles, cómo leer sus salidas y cómo acceder a los datos de precio del activo.

Registrar un indicador

Usa `self.indicator("NOMBRE", **parametros)` dentro de `on_init()` y guarda el resultado en una variable de instancia. El motor crea el buffer del indicador una vez y lo actualiza automáticamente en cada vela.

python
def on_init(self):
    self.rsi = self.indicator("RSI", period=14)
    self.ema = self.indicator("EMA", period=200)
    self.macd = self.indicator("MACD", fast=12, slow=26, signal=9)

Usa exactamente los nombres y parámetros del catálogo (respeta mayúsculas: `RSI`, no `rsi`). Un nombre que no existe o un parámetro que el indicador no admite da error al hacer backtest, con la lista de lo que sí existe; en una sesión en vivo o paper ya en marcha queda un aviso en los registros. Todos los indicadores se calculan con las velas del símbolo y el timeframe del bot (sobre el cierre): no existen `symbol=`, `timeframe=` ni `source=`, así que no se pueden leer velas de otro símbolo.

Leer el valor de un indicador

AccesoDevuelve
.valueValor del indicador en la vela actual
.prevValor del indicador en la vela anterior
.values(n)Lista con los últimos n valores (el índice 0 es el más reciente)
python
def on_bar(self):
    if self.rsi.value < 30:                              # RSI actual por debajo de 30
        ...
    if self.rsi.prev > 70 and self.rsi.value < 70:       # acaba de cruzar 70 a la baja
        ...

Indicadores con varias salidas

Algunos indicadores devuelven más de una línea (banda superior/inferior, línea de señal, etc.). Accedes a cada salida por su atributo específico en lugar de usar `.value`.

python
self.bb = self.indicator("Bollinger", period=20, stdDev=2.0)
# self.bb.upper, self.bb.middle, self.bb.lower

self.macd = self.indicator("MACD", fast=12, slow=26, signal=9)
# self.macd.value (línea MACD), self.macd.signal, self.macd.histogram

self.ichi = self.indicator("Ichimoku", tenkan=9, kijun=26, senkou=52)
# self.ichi.tenkanSen, self.ichi.kijunSen, self.ichi.senkouA, self.ichi.senkouB

Catálogo de indicadores (28)

NombreFamiliaParámetros (con defaults)Salidas / Notas
EMATendenciaperiod=200.value
SMATendenciaperiod=50.value
DEMATendenciaperiod=21.value
TEMATendenciaperiod=21.value
HMATendenciaperiod=9.value — Hull Moving Average, menos lag que EMA
WMATendenciaperiod=20.value
KAMATendenciaperiod=10, fast=2, slow=30.value — se adapta a la volatilidad del mercado
SuperTrendTendenciaperiod=10, multiplier=3.value — precio del nivel; positivo = alcista, negativo = bajista
RSIMomentumperiod=14.value — rango 0-100
StochasticMomentumperiod=14, dPeriod=3.k y .d — rango 0-100
MACDMomentumfast=12, slow=26, signal=9.value (línea MACD), .signal, .histogram
CCIMomentumperiod=20.value — sobrecompra >100, sobreventa <-100
ROCMomentumperiod=12.value — tasa de cambio en %
WilliamsRMomentumperiod=14.value — rango -100 a 0; sobrecompra >-20, sobreventa <-80
BollingerVolatilidadperiod=20, stdDev=2.0.upper, .middle, .lower
ATRVolatilidadperiod=14.value — rango verdadero promedio
KeltnerVolatilidadperiod=20, multiplier=1.5.upper, .middle, .lower
DonchianVolatilidadperiod=20.upper (máximo del canal), .lower (mínimo del canal)
StdDevVolatilidadperiod=20.value — desviación estándar de los cierres
ADXFuerza de tendenciaperiod=14.value (ADX), .plusDI, .minusDI
OBVVolumensignal=20.value (OBV acumulado), .signal (EMA del OBV)
MFIVolumenperiod=14.value — Money Flow Index, rango 0-100
VWAPVolumensin parámetros.value — precio medio ponderado por volumen (se resetea cada sesión)
HighestPrecioperiod=20.value — máximo de las últimas N velas
LowestPrecioperiod=20.value — mínimo de las últimas N velas
PivotPointsPreciosin parámetros.pp (pivot), .r1/.r2 (resistencias), .s1/.s2 (soportes)
IchimokuAvanzadotenkan=9, kijun=26, senkou=52.tenkanSen, .kijunSen, .senkouA, .senkouB
ParabolicSARAvanzadoafStart=0.02, afStep=0.02, afMax=0.2.value — precio del stop; está por debajo del precio en tendencia alcista y por encima en bajista

El ATR rara vez se usa como señal directa; lo normal es usarlo para dimensionar el SL/TP dinámicamente (ej. `sl_atr=1.5`). Ve cómo hacerlo en el artículo «IDE: órdenes y salidas».

Indicador macro (FRED)

Las series macroeconómicas de FRED (VIX, tipos de interés, empleo…) todavía no se pueden usar como indicador en el IDE de código: `self.indicator("Macro", ...)` da error al hacer backtest. Sí puedes usarlas como regla en las exploraciones del Creador de Algoritmos, con el prefijo `macro_` (por ejemplo `macro_VIXCLS` o `macro_T10Y2Y`), donde respetan la fecha real de publicación para evitar lookahead bias.

Acceder a precios e históricos (self.data y self.bar)

`self.bar` contiene los datos de la vela actual de forma directa. `self.data` te da acceso a las series completas con índice relativo: `[0]` es la vela actual, `[-1]` la anterior, `[-5]` la de hace cinco velas.

python
self.bar.close          # cierre de la vela actual
self.bar.high, self.bar.low, self.bar.open, self.bar.volume

self.data.close[0]      # = self.bar.close
self.data.close[-1]     # cierre anterior
self.data.high[-3]      # máximo de hace 3 velas
self.data.bar_count     # cuántas velas hay disponibles
Método de serie (self.data.close, .high, .low…)Qué calcula
.values(n)Lista con los últimos n valores; índice 0 = más reciente
.highest(n)Valor máximo de las últimas n velas
.lowest(n)Valor mínimo de las últimas n velas
.avg(n)Promedio de las últimas n velas
.crossover(otro)True si la serie acaba de cruzar al alza el valor o serie dado
.crossunder(otro)True si la serie acaba de cruzar a la baja el valor o serie dado
python
resistencia = self.data.high.highest(20)
if self.data.close.crossover(self.ema.value):   # precio cruza la EMA al alza
    self.buy(sl_atr=1.5, tp_atr=3.0)
Ejemplo: breakout de la resistencia de 20 velas con cruce de EMA como confirmación

Registra los indicadores SIEMPRE en `on_init()`, nunca dentro de `on_bar()`. Si lo haces en `on_bar()`, el motor crearía un indicador nuevo en cada vela y nunca tendría histórico suficiente para calcular su valor.

Los nombres de indicador distinguen mayúsculas: "RSI", "EMA", "Bollinger"… úsalos tal cual aparecen en el catálogo. Un nombre incorrecto lanzará un error al iniciar el backtest.

Con los indicadores y los datos de precio bajo control, el siguiente paso es aprender a colocar órdenes, gestionar el SL/TP y cerrar posiciones. Continúa en «IDE: órdenes y salidas».