Saltar a contenido

MATVARD Playbook Real - SOLUSDC#

Fecha: 2026-04-08 Estado: foco unico activo Scope lock: no abrir otro par hasta confirmar este playbook

1) Objetivo#

Confirmar un playbook operativo real para SOLUSDC y dejar un criterio binario:

  • CONFIRMADO: se puede pasar al siguiente par.
  • NO_CONFIRMADO: se mantiene foco exclusivo en SOLUSDC.

2) Unidad canónica#

  • symbol: SOLUSDC
  • runtime_symbol (Binance spot): SOLUSDT
  • timeframe principal: M30
  • timeframe secundario: M15
  • playbook_id: matvard_hybrid_SOLUSDC_M30
  • etapa inicial: shadow
  • owner: ops-strategy
  • baseline_strategy_primary: ma_crossover M30
  • baseline_strategy_secondary: solusdc_ob_long_only_no_sl_max3 M30
  • risk_limits: max_dd_7d_pct=8.0, max_daily_drawdown_pct=2.0 max_risk_per_trade_pct=0.5, max_trades_per_session=3
  • evidence_output_dir: storage/reports/matvard/solusdc

Racional de timeframe principal:

  • En comparativa reciente de 30 dias, M30 muestra mejor comportamiento agregado que M15 para SOLUSDC en estrategias ejecutables.
  • El playbook usa M15 solo como verificacion secundaria, no como driver de promotion.

Nota de ejecución:

  • En entorno Binance spot, ejecutar con SOLUSDT como símbolo runtime para evitar cobertura nula de feed.

3) Estrategia y baseline de control#

Estrategia objetivo de validacion MATVARD:

  • autopilot:matvard_hybrid_multi sobre SOLUSDC (operando en modo shadow).

Baselines obligatorios para contraste:

  • ma_crossover M30
  • solusdc_ob_long_only_no_sl_max3 M30

Nota:

  • Si MATVARD no supera baseline inmediatamente, no se descarta; se evalua estabilidad y riesgo primero.

4) Guardrails obligatorios (hard-stop)#

Mantener estos umbrales como condicion minima de salud:

  • provider_error_rate_24h < 1.0
  • fallback_rate_24h < 5.0
  • coverage_pct_24h >= 95.0
  • feed_fresh_ok = true

Si algun guardrail falla:

  • estado automatico shadow_hold
  • no se permite promotion a canary

5) Criterios de confirmacion del playbook SOLUSDC#

Se considera CONFIRMADO si se cumplen todos:

  1. Salud feed OK por al menos 7 dias corridos.
  2. Calidad de señal en shadow:
  3. context_pass_rate > 0
  4. setup_trigger_rate > 0
  5. Resultado operativo:
  6. profit_factor_7d >= 1.0
  7. sin degradacion persistente vs baseline M30
  8. Riesgo:
  9. sin violaciones de hard-stop estructural no mitigadas
  10. drawdown dentro del limite operativo acordado
  11. Trazabilidad:
  12. pre-market y post-market registrados para cada dia operativo

Si cualquier punto falla: NO_CONFIRMADO.

6) Checklist diario (SOLUSDC only)#

  1. Confirmar modo y simbolo activo (SOLUSDC).
  2. Revisar salud microestructura 24h.
  3. Revisar shadow report 24h y 7d.
  4. Registrar decision diaria:
  5. promote_candidate
  6. hold
  7. rollback
  8. Cargar evidencia en bitacora del dia.

Plantilla diaria oficial:

  • docs/matvard/templates/SOLUSDC_DAILY_LOG_TEMPLATE.md

7) Checklist semanal (gate de avance)#

  1. Comparar MATVARD vs baselines M30 para SOLUSDC.
  2. Revisar distribucion de razones de bloqueo/skip.
  3. Validar estabilidad de edge y riesgo.
  4. Emitir estado semanal:
  5. CONFIRMADO
  6. NO_CONFIRMADO

Plantilla semanal oficial:

  • docs/matvard/templates/SOLUSDC_WEEKLY_GATE_TEMPLATE.md

8) Comandos operativos mínimos#

Ciclo automático recomendado (genera snapshots y bitácora base):

SDP_AUTH_TOKEN="<token>" \
bash scripts/run_solusdc_playbook_daily.sh \
   --base-url=https://api.sdp.perlatec.net \
   --symbol=SOLUSDT

Alternativa recomendada para operación no interactiva (sin pegar token en terminal):

bash scripts/run_solusdc_playbook_daily.sh \
   --base-url=https://api.sdp.perlatec.net \
   --symbol=SOLUSDT \
   --auth-env-file=env/.env.binance

Alternativa con login por credenciales:

SDP_EMAIL="<email>" SDP_PASSWORD="<password>" \
bash scripts/run_solusdc_playbook_daily.sh \
   --base-url=https://api.sdp.perlatec.net \
   --symbol=SOLUSDT

Nota operativa:

- Si no se pasa `--symbol`, el script usa `SOLUSDT` por defecto
   (runtime real de Binance spot para el playbook SOLUSDC).

Salud microestructura SOLUSDC:

curl -s "http://<host>/ops/strategy/matvard/microstructure-health?symbol=SOLUSDC&lookback_hours=24"

Reporte shadow MATVARD:

curl -s "http://<host>/ops/strategy/matvard-shadow-report?hours=24&limit=2000"
curl -s "http://<host>/ops/strategy/matvard-shadow-report?hours=168&limit=4000"

Gate histórico:

curl -s "http://<host>/ops/strategy/matvard-phase2-gate?limit_per_window=4000&persist_report=true"

Resumen runtime multipar (verificar que SOLUSDC este incluido):

bash deploy/ops/matvard_runtime_summary.sh

Smoke autenticado mínimo de endpoints protegidos MATVARD:

bash scripts/check_matvard_auth_endpoints.sh \
   --base-url=https://api.sdp.perlatec.net \
   --auth-env-file=env/.env.binance

9) Regla de foco (scope lock)#

Hasta que SOLUSDC quede CONFIRMADO:

  • no se promueve ningun otro par a canary/core,
  • no se abre nuevo playbook activo para otro simbolo,
  • cualquier cambio de otros pares queda en backlog.

10) Definicion de Hecho (DoD)#

El playbook real de SOLUSDC queda cerrado cuando:

  • existe evidencia 7d continua con guardrails en verde,
  • hay decision semanal CONFIRMADO,
  • el estado queda publicado en docs/TODO.md y en el bloque vigente de docs/HANDOFF.md,
  • se habilita formalmente pasar al siguiente par.