Descripción de los filtros del Watcher


APR guard – Umbral (%)
Define el APR mínimo permitido para una operación ya abierta o en seguimiento.
El watcher se activa cuando el APR LIVE cae por debajo de este umbral.

Sirve para proteger la estrategia cuando la rentabilidad empeora y deja de cumplir
las condiciones mínimas esperadas.

Cómo funciona:
Si APR LIVE < Umbral, el APR guard se activa.

Ejemplo sencillo:
– Umbral 100%
– APR LIVE baja a 95% → el watcher actúa.
– APR LIVE en 120% → no hace nada.


APR guard – Cooldown (min)
Tiempo mínimo que debe pasar entre dos activaciones consecutivas del APR guard.
Evita que el watcher actúe repetidamente si el APR oscila alrededor del umbral.

Durante el cooldown, aunque el APR vuelva a caer por debajo del umbral,
el watcher no vuelve a actuar.

Ejemplo sencillo:
– Cooldown 10
– El APR guard se activa a las 12:00
– No puede volver a activarse hasta las 12:10


Liq guard – Distancia mínima
Define la distancia mínima permitida al precio de liquidación,
tanto para la pata Long como para la pata Short.

Protege frente a posiciones con margen demasiado ajustado
en cualquiera de los dos lados de la operación.

El watcher evalúa cada pata de forma independiente.
Si una sola de ellas no cumple la distancia mínima,
el Liq guard se activa.

Fórmula conceptual (por pata):
Distancia = |Precio actual − Precio de liquidación| / Precio actual

Si la distancia calculada es menor que el valor definido,
el guard se activa.

Ejemplo sencillo:
– Precio actual: 100
– Liquidación Long: 85 → distancia = 0.15
– Liquidación Short: 130 → distancia = 0.30

– Distancia mínima configurada: 0.2
→ Long: 0.15 < 0.2 → el watcher actúa
→ Short: 0.30 ≥ 0.2 → correcta, pero una pata falla y el guard se activa

            

Descripción detallada de los parámetros de la estrategia


Base notional (USD)
Es el tamaño aproximado de cada operación.

Ejemplo sencillo:
– Si pones 50 USD, cada operación será pequeña.
– Si pones 500 USD, cada operación será diez veces mayor.
Más notional = más beneficio potencial, pero también más riesgo.


Leverage
Multiplicador que amplía el tamaño de la posición respecto al capital usado.

Ejemplo sencillo:
– Leverage 1x → sin apalancamiento.
– Leverage 3x → una posición de 100 USD controla 300 USD.
– Más leverage → más riesgo y menor margen de error.


Máximo de trades simultáneos
Cuántas operaciones pueden estar abiertas al mismo tiempo.
Sirve para no sobrecargar tu cuenta.

Ejemplo sencillo:
– Valor 1: solo una operación a la vez.
– Valor 3: hasta tres operaciones abiertas simultáneamente.
Aunque haya muchas oportunidades, nunca superará este número.


Exchanges permitidos
Dónde puede operar esta estrategia.
Si un exchange no está marcado, lo ignora por completo.

Ejemplo sencillo:
– Marcas solo Hyperliquid → nunca usará Paradex.
– Marcas ambos → puede combinar los dos en una misma operación.


APR mínimo (LIVE)
Rentabilidad mínima exigida para entrar en una operación.
Si la ganancia no alcanza este valor, la oportunidad se descarta.

Ejemplo sencillo:
– APR mínimo = 30%
– Oportunidad con 25% → ignorada.
– Oportunidad con 60% → válida (si pasa el resto de filtros).


APR por spread
Comprueba si la rentabilidad compensa el spread asumido.
Evita operaciones con APR alto pero spread excesivo.

Fórmula:
APR por spread = APR_LIVE / |spread|

Rango permitido:
– 0 → desactivado.
– > 0 → sin límite superior (cuanto mayor, más exigente).

Rango recomendado:
– 5 – 10 → muy permisivo.
– 15 – 30 → equilibrio entre cantidad y calidad.
– 40+ → solo operaciones muy eficientes.

Ejemplo sencillo:
– APR 100% con spread 2% → ratio = 50 → pasa filtros exigentes.
– APR 100% con spread 10% → ratio = 10 → solo pasa filtros permisivos.


Spread mínimo / máximo (%)
Define cuánto pueden diferir los precios entre exchanges.
Evita spreads demasiado pequeños que no cubren fees y spreads excesivos.

Cómo funciona:
La oportunidad debe cumplir ambos límites:
– spread ≥ mínimo
– spread ≤ máximo

Rango permitido:
– Mínimo: 0 → ∞
– Máximo: 0 → ∞

Rango recomendado:
– Spread mínimo
· 0 → desactivado.
· 0.05 – 0.2 → evita oportunidades sin margen real.

– Spread máximo
· 0 → desactivado.
· 2 – 5 → rango equilibrado.
· 8 – 10+ → muy permisivo, mayor riesgo.

Ejemplo sencillo:
– Mínimo 0.1% → filtra spreads inútiles.
– Máximo 5% → evita precios descontrolados.


OI mínimo (Long / Short Exchange)
Exige un Open Interest mínimo en ambos exchanges para operar.
Más OI implica mercados más líquidos y estables.

Cómo funciona:
Se comprueba el OI del exchange Long y del exchange Short de forma independiente.
Ambos deben cumplir el mínimo.

Valores habituales:
– 0 → desactivado.
– 10k – 50k → mercados pequeños.
– 100k – 500k → liquidez media.
– 1M+ → mercados grandes y estables.

Ejemplo sencillo:
– OI bajo → mercado vacío, riesgo alto.
– OI alto → mercado activo, ejecución más segura.


Volumen mínimo (Long / Short Exchange, 24h)
Exige un volumen mínimo negociado en ambos exchanges durante las últimas 24h.
Evita operar tokens sin liquidez real.

Cómo funciona:
Se comprueba el volumen 24h del exchange Long y del exchange Short.
Ambos deben superar el mínimo.

Valores habituales:
– 0 → desactivado.
– 50k – 200k → liquidez baja.
– 500k – 2M → liquidez media.
– 5M+ → alta liquidez y buena ejecución.

Ejemplo sencillo:
– Volumen bajo → difícil entrar y salir.
– Volumen alto → órdenes rápidas y estables.


OI leg ratio
Exige un equilibrio mínimo entre el Open Interest del exchange Long y del exchange Short.
Evita operar cuando una de las dos patas es claramente más débil.

Cómo funciona:
Se comparan los valores de OI de ambos exchanges.
Si el desequilibrio supera el límite permitido, la oportunidad se descarta.

Rango permitido:
– 0 → 1

Rango recomendado:
– 0 → desactivado.
– 0.1 – 0.3 → muy permisivo.
– 0.4 – 0.6 → equilibrio razonable.
– 0.7 – 1.0 → solo patas muy equilibradas.

Ejemplo sencillo:
– Un exchange con mucho OI y el otro muy bajo → operación inestable.
– Ambos con OI similar → operación más segura.


Vol leg ratio
Exige un equilibrio mínimo entre el volumen del exchange Long y del exchange Short.
Evita operaciones donde una pata tiene poco volumen y puede quedar mal ejecutada.

Cómo funciona:
Se comparan los volúmenes de ambos exchanges.
Si el desequilibrio es excesivo, la oportunidad se descarta.

Rango permitido:
– 0 → 1

Rango recomendado:
– 0 → desactivado.
– 0.1 – 0.3 → muy permisivo.
– 0.4 – 0.6 → equilibrio respecto al histórico.
– 0.7 – 1.0 → volúmenes muy equilibrados.

Ejemplo sencillo:
– Un exchange con mucho volumen y otro casi vacío → riesgo de mala ejecución.
– Volúmenes similares → operación más estable.


Blacklist tokens
Lista de tokens que nunca se operarán, aunque cumplan todos los demás filtros.

Cómo funciona:
Si el token aparece en la blacklist, la oportunidad se descarta inmediatamente.

Formato:
– Lista separada por comas (ej. BTC,ETH,SOL).

Ejemplo sencillo:
– Tokens problemáticos.
– Tokens en mantenimiento.
– Tokens que no quieres operar.


Whitelist tokens
Lista de tokens que sí se pueden operar de forma exclusiva.
Si se rellena, solo se tendrán en cuenta estos tokens y se ignoran todos los demás.

Cómo funciona:
La whitelist tiene prioridad sobre la blacklist.
Cualquier token que no esté en la lista se descarta automáticamente.

Formato:
– Lista separada por comas (ej. BTC,ETH,SOL).

Ejemplo sencillo:
– ETH,SOL → solo se operan esos tokens.
– Lista vacía → se permiten todos (salvo blacklist).


Filtros históricos (1h / 8h / 24h / 3d / 7d / 15d / 1M)
Exigen un APR mínimo en distintas ventanas de tiempo pasadas.
Sirven para comprobar que la rentabilidad no es un pico puntual.

Cómo funciona:
Se compara el APR histórico de cada ventana con el mínimo definido.
Si no alcanza el umbral en alguna de ellas, la oportunidad se descarta.

Valores habituales:
– 0 → desactivado.
– Valores bajos → más operaciones, menos estabilidad.
– Valores altos → menos operaciones, mayor consistencia.

Ejemplo sencillo:
– APR LIVE alto pero histórico bajo → posible anomalía.
– APR estable en el tiempo → oportunidad más fiable.


Ratios LIVE / histórico
Comparan el APR actual con el APR histórico en cada ventana de tiempo.
Permiten exigir mejora respecto al pasado o aceptar valores inferiores.

Fórmula:
Ratio = APR_LIVE / APR_histórico

Rango permitido:
– 0 → ∞

Rango recomendado:
– 0 → desactivado.
– 0.3 – 0.7 → muy permisivo.
– 0.8 – 1.2 → equilibrio respecto al histórico.
– 1.5+ → exige mejora clara frente al pasado.

Ejemplo sencillo:
– Histórico 80%, LIVE 40% → ratio = 0.5 → pasa con ratios ≥ 0.5.
– Histórico 80%, LIVE 80% → ratio = 1.0 → pasa con ratios ≥ 1.0.
– Histórico 80%, LIVE 120% → ratio = 1.5 → pasa con ratios ≥ 1.5.