Copy-trading

El copy-trading replica las operaciones de un líder sobre las cuentas de sus seguidores. Es un perk voluntario de la sala, no gestión de dinero: tu cuenta, tus keys, tu control.

Postura de producto (innegociable)

Los invariantes

1. Self-custody — los fondos viven en TU cuenta Weex con TUS keys. La plataforma no custodia nada.
2. Opt-in explícito y revocable — seguís porque querés; pausás/dejás de seguir cuando querés.
3. El motor nunca pelea tus acciones manuales — si abrís, aumentás, reducís, cerrás, invertís o movés TP/SL en cualquier superficie (Weex web/mobile, el bot, el panel), la copia lo respeta, no lo revierte.
4. Vos definís el sobre de riesgo — sizing, leverage, símbolos, lado, tope por trade, cuántas posiciones simultáneas.
5. Pausa instantánea — /copy pause corta nuevas copias; las posiciones vivas siguen siendo tuyas.
6. Disclaimer al activar — quien activa auto acepta el riesgo.
7. Auditoría por seguidor — cada copia queda registrada.

Esto es lo que separa "herramienta que el usuario controla" de "gestión discrecional". Diseño completo en docs/COPY-TRADING-V2.md.

Tipos de líder

• house — la cuenta de la casa. Hoy designada con /leader house account:@StopLoss. Sólo esa cuenta lidera; las demás cuentas de la casa quedan auto-suscritas.
• user — un trader calificado: se postula con /leader apply, un admin lo aprueba con /leader approve. Puede ser de pago (gated por entitlement).
• system — un modelo curado con nombre propio, marca desacoplada de la persona (futuro).

Cómo seguir

/copy follow                      → seguís a la casa, modo auto, espejo
/copy follow mode:manual          → te avisa y copiás a 1 clic
/copy follow sizing:fixed value:5 → cada copia usa 5% de tu balance
/copy follow lev_mode:capped lev_value:10   → tope de leverage 10x
/copy follow symbols:BTCUSDT,ETHUSDT side:LONG   → filtros
/copy follow trader:@Fulano       → seguir a un trader calificado en vez de la casa
/copy list | pause | resume | unfollow

Modos

• auto — la copia se ejecuta sola en tu cuenta (vía API).
• manual — recibís el aviso con un botón Copiar; vos decidís.

Sizing

Modo	Qué hace
mirror (mirrorPct)	espejo del % de balance que usó el líder
fixed	un % fijo de TU balance por trade
multiplier	un múltiplo del % del líder

Siempre acotado por tu max_pct y por los caps de tier.

Cómo funciona por dentro

1. El monitor (cron, cada ~20s) consulta posiciones y fills de cada cuenta y diffea contra el snapshot anterior.
2. Cuando detecta un evento del líder (OPEN / INCREASE / CLOSE / REDUCE), agenda el motor de auto-copia fuera de banda.
3. El planner (lib/copyEngine.ts, puro y testeado) calcula las acciones por seguidor según su suscripción (sizing, leverage, filtros, topes).
4. Se ejecutan sobre las cuentas del seguidor (excluyendo la del líder), con idempotencia vía la tabla copyEvents (un evento del líder no se copia dos veces).
5. Cada copia se marca surface:'copy' para que nunca sea re-detectada y re-copiada (sin bucles).

Doble gate de seguridad (dinero real)

El motor de auto-ejecución está doblemente gateado:

Env	Efecto
COPY_AUTO_ENABLED	=1 enciende el motor. Sin setear → apagado.
COPY_DRY_RUN	distinto de 0 (incl. sin setear) → dry-run: calcula y audita planes, no manda órdenes. =0 → ejecuta de verdad.

Piloto recomendado: COPY_AUTO_ENABLED=1 con dry-run ON primero, verificar los planes en el audit (action: copy-auto, {events, plans}), y recién después COPY_DRY_RUN=0. Ver el runbook en Runbooks.