Parámetros de riesgo

Esta página documenta todos los parámetros de riesgo de Aegis, con tipo, rango válido, valor por defecto y efecto conductual. La sección Semántica de buffer por bot es de lectura obligatoria antes de configurar triggerBufferPct.

---

Referencia de parámetros

capitalBufferPct

Campo	Valor
Tipo	Flotante
Rango válido	0.0 – 1.0
Por defecto	0.1 (10%)

Un multiplicador aplicado al valor del pool para calcular el capital efectivo operado antes de dimensionar una posición de cobertura:

effectiveCapitalUsd = poolValueUsd × (1 + capitalBufferPct)
marginPerLeg       = effectiveCapitalUsd / leverage

El bot abre una posición dimensionada contra effectiveCapitalUsd, no solo contra poolValueUsd. Configurar capitalBufferPct = 0.1 significa que el bot intenta abrir un nocional 10% más grande que el valor del pool, lo que a su vez incrementa el margen requerido en la misma proporción.

Precaución

capitalBufferPct aumenta el tamaño nocional que el bot intenta abrir — no es una reserva pasiva ociosa. Un valor mayor incrementa la exposición, el margen requerido y el saldo mínimo en el exchange necesario. Asegúrate de que tu saldo en el exchange cubra el margen con buffer completo antes de habilitar posiciones.

Ejemplo numérico: Valor del pool = $1,000, capitalBufferPct = 0.1, apalancamiento = 5×

Paso	Cálculo	Resultado
Capital efectivo	$1,000 × (1 + 0.1)	$1,100
Margen por leg	$1,100 / 5	$220
Saldo mínimo (grupo en peor caso)	Ver Reserva de capital	≥ $220

Comparación con capitalBufferPct = 0 (sin buffer): effectiveCapitalUsd = $1,000, marginPerLeg = $200.

---

triggerBufferPct

Campo	Valor
Tipo	Flotante (escala fraccional 0..1)
Rango válido	Ver valores por bot abajo
Por defecto	Bastion/Vanguard: 0.005 (0.5%) · Orbit: 0.001 (0.1%)

Un desplazamiento fraccional aplicado al límite del rango LP para determinar el precio de disparo de entrada. La fórmula y la semántica varían según el bot — consulta Semántica de buffer por bot abajo.

Precaución

Orbit usa un valor por defecto más ajustado (0.001) y un rango permitido más amplio (0..0.10) que Bastion y Vanguard (por defecto 0.005, rango 0..0.05). No apliques los valores de Bastion a una estrategia Orbit.

Bot	Por defecto	Rango válido
Bastion	0.005 (0.5%)	0 – 0.05
Vanguard	0.005 (0.5%)	0 – 0.05
Orbit	0.001 (0.1%)	0 – 0.10

---

stopLossPct

Campo	Valor
Tipo	Flotante
Rango válido	0.001 – 0.5
Por defecto	0.03 (3%)

La pérdida máxima permitida en una posición de futuros antes de que se cierre automáticamente. Se mide como una fracción del precio de entrada.

Ejemplo: Entrada a $3,000, stopLossPct = 0.03 → stop-loss en $3,000 × (1 − 0.03) = $2,910 para una posición long.

---

trailingStopMultiplier (solo Vanguard)

Campo	Valor
Tipo	Flotante
Rango válido	0.5 – 5.0
Por defecto	1.5
Aplica a	Vanguard

Multiplicador aplicado a stopLossPct para calcular la distancia del trailing stop después de que se alcanza el primer objetivo de ganancia. Un multiplicador mayor le da más recorrido a la posición después de un TP inicial. Este campo es exclusivo de Vanguard — la API de estrategias lo rechaza para estrategias Bastion y Orbit.

Ejemplo: stopLossPct = 0.02, trailingStopMultiplier = 1.5 → distancia del trailing stop = 0.02 × 1.5 = 0.03 (3%).

---

takeProfitPct (solo Vanguard)

Campo	Valor
Tipo	Flotante
Rango válido	0.001 – 1.0
Por defecto	0.02 (2%)
Aplica a	Vanguard

Un objetivo de ganancia fraccional único para la posición de breakout de Vanguard, expresado como porcentaje del margen. Este campo es exclusivo de Vanguard — la API de estrategias rechaza takeProfitPct para estrategias Bastion y Orbit.

• Bastion no usa takeProfitPct. Las tomas de ganancias de Bastion son los take-profits del buffer (bufferTpConfig) y el take-profit escalonado (escalatedTpConfig); consulta Bots — Bastion.
• Orbit no usa takeProfitPct. Orbit usa tieredTakeProfit en su lugar (ver abajo).

Nota

Para Vanguard, el precio de toma de ganancias se ajusta por el apalancamiento: la distancia efectiva de TP desde la entrada es takeProfitPct / leverage. Consulta Fórmulas de toma de ganancias para el cálculo exacto.

---

tieredTakeProfit (solo Orbit)

Campo	Valor
Tipo	Arreglo de objetos { rangePct, closePct }
Máximo de niveles	3 niveles intermedios
Escala	Entero en porcentaje 0..100 (no fraccional 0..1)
Por defecto	[(25,25),(50,25),(75,25)]
Aplica a	Orbit

El sistema de toma de ganancias de Orbit cierra porciones de la posición a medida que el precio avanza por el rango LP. Cada nivel especifica:

• rangePct — qué tan lejos a través del rango LP (0..100, extremos excluidos) antes de que se ejecute el cierre parcial
• closePct — qué porcentaje de la posición abierta restante cerrar en ese nivel (0..100)

La suma de todos los valores closePct no debe superar 100. Después de que se activan todos los niveles definidos, la posición restante se cierra en el borde opuesto del rango (TP100 por el resolvedor de salida).

Perfil por defecto: [(25,25),(50,25),(75,25)] — tres cierres parciales del 25% cada uno en las marcas del 25%, 50% y 75% del interior del rango. El 25% restante se cierra en el borde opuesto del rango.

Ejemplo (perfil personalizado de 2 niveles):

tieredTakeProfit = [
  { rangePct: 33, closePct: 50 },
  { rangePct: 66, closePct: 50 }
]

TP1: cerrar el 50% de la posición cuando el precio esté al 33% del rango. TP2: cerrar el 50% restante cuando el precio esté al 66% del rango.

Arreglo vacío ([]): deshabilita los cierres parciales — toda la posición se cierra únicamente en el borde opuesto del rango (modo solo TP100).

---

autoRearm

Campo	Valor
Tipo	Booleano
Por defecto	true

Cuando es true, después de que una posición se cierra (por TP, SL o cierre manual), el leg se reactiva automáticamente y monitorea para el próximo evento de disparo. Cuando es false, el leg permanece inactivo después de cerrarse hasta que se reactive manualmente.

---

Semántica de buffer por bot

triggerBufferPct no tiene una fórmula universal única. El desplazamiento se aplica de manera diferente según qué bot está configurado.

Precaución

No asumas que todos los bots usan disparos interiores al rango LP. Bastion y Vanguard disparan exterior al rango. Orbit dispara interior al rango.

Bastion

Bastion usa disparos exteriores — el disparo se activa después de que el precio ya ha salido del rango LP con un margen de buffer.

Leg	Fórmula	Tipo
lower_short	P_lower × (1 − triggerBufferPct)	Por debajo del límite inferior
upper_short (reingreso)	P_upper	En el reingreso al límite superior

Ejemplo numérico: P_lower = $2,000, triggerBufferPct = 0.005 → lower_short se dispara cuando el precio cae por debajo de $2,000 × (1 − 0.005) = $1,990.

Para el contexto completo de parámetros de Bastion, consulta Bots — Bastion.

Vanguard

Vanguard usa un disparo exterior de ruptura — el disparo se activa después de que el precio ha superado el límite superior del rango LP con un margen de buffer.

Leg	Fórmula	Tipo
upper_long	P_upper × (1 + triggerBufferPct)	Por encima del límite superior

Ejemplo numérico: P_upper = $3,000, triggerBufferPct = 0.005 → upper_long se dispara cuando el precio sube por encima de $3,000 × (1 + 0.005) = $3,015.

Para el contexto completo de parámetros de Vanguard, consulta Bots — Vanguard.

Orbit

Orbit usa disparos interiores derivados del ancho completo del rango — el disparo se activa mientras el precio aún está dentro del rango, aproximándose a un límite.

Dirección	Fórmula	Tipo
LONG	P_lower + triggerBufferPct × (P_upper − P_lower)	Desde adentro, cerca del límite inferior
SHORT	P_upper − triggerBufferPct × (P_upper − P_lower)	Desde adentro, cerca del límite superior

Ejemplo numérico: P_lower = $2,000, P_upper = $3,000 (ancho del rango = $1,000), triggerBufferPct = 0.05 (5%)

Dirección	Disparo
LONG	$2,000 + 0.05 × $1,000 = $2,050
SHORT	$3,000 − 0.05 × $1,000 = $2,950

Para el contexto completo de parámetros de Orbit, consulta Bots — Orbit.

---

Stop-loss y toma de ganancias

Stop-loss (stopLossPct)

El stop-loss limita la pérdida máxima en un leg de futuros. Se calcula desde el precio de entrada:

• SL en posición long: precio_entrada × (1 − stopLossPct)
• SL en posición short: precio_entrada × (1 + stopLossPct)

Escenario	Entrada	stopLossPct	Precio de stop-loss
Long, ETH	$2,050	0.03	$2,050 × 0.97 = $1,988.50
Short, ETH	$2,950	0.03	$2,950 × 1.03 = $3,038.50

Fórmulas de toma de ganancias

Cada bot usa un mecanismo de toma de ganancias distinto. takeProfitPct es exclusivo de Vanguard.

Vanguard (takeProfitPct)

Para Vanguard, el precio de toma de ganancias se basa en el precio de entrada y el apalancamiento:

• TP en long: precio_entrada × (1 + takeProfitPct / leverage)
• TP en short: precio_entrada × (1 − takeProfitPct / leverage)

Escenario	Entrada	takeProfitPct	Apalancamiento	Precio de toma de ganancias
Long, ETH (Vanguard)	$2,050	0.05	15x	$2,050 × (1 + 0.05/15) = $2,050 × 1.003333 = $2,056.83
Short, ETH (Vanguard)	$2,950	0.05	15x	$2,950 × (1 − 0.05/15) = $2,950 × 0.996667 = $2,940.17

Consulta Bots — Vanguard para el escenario completo de toma de ganancias.

Bastion (bufferTpConfig / escalatedTpConfig)

Bastion no usa takeProfitPct. Bastion tiene dos mecanismos de toma de ganancias, ambos exclusivos de Bastion:

• Take-profits del buffer (bufferTpConfig) — hasta 3 niveles de órdenes limit que realizan ganancia de la porción del buffer de capital del short inferior a medida que el precio cae por debajo de P_lower. Solo disponibles cuando el buffer de capital es mayor a 0%. La suma de los porcentajes de cierre del buffer no puede superar 100%.
• Take-profit escalonado (escalatedTpConfig) — cierres parciales del short superior a medida que el precio recorre el rango de arriba hacia abajo (hitos interiores como 25%, 50%, 75%, y el remanente en el borde opuesto).

Consulta Bots — Bastion para el detalle completo de toma de ganancias.

Orbit (tieredTakeProfit)

Orbit usa un sistema escalonado de cierres parciales en lugar de un único precio objetivo. Cada nivel en tieredTakeProfit se activa a medida que el precio avanza por el interior del rango LP. Consulta tieredTakeProfit arriba para el contrato completo.

Trailing stop (trailingStopMultiplier)

trailingStopMultiplier es exclusivo de Vanguard. Para Vanguard, después de que se alcanza el primer TP, el stop-loss se mueve al punto de equilibrio y se activa un trailing stop a una distancia de stopLossPct × trailingStopMultiplier del precio actual.

---

Referencias cruzadas

• Bots — Bastion
• Bots — Vanguard
• Bots — Orbit
• Parámetros de estrategia — Presets
• Parámetros de estrategia — Apalancamiento y margen
• Divulgaciones