Cómo se conecta con Sandmarket#

Sandmarket es un simulador de replays. VisionAlert se conecta a él como un flujo externo: entra con un token de API, escucha cuándo cierra una vela en tus sesiones, lee tus velas y tus dibujos, y publica sus avisos en la pestaña Flujos del terminal y una capa en el gráfico.

Sandmarket no sabe nada de la IA: VisionAlert usa la misma interfaz que cualquier otro flujo tuyo. La explica la guía de Integraciones de tu Sandmarket, en /docs/integraciones.

Qué hace y qué no#

• Analiza y sugiere: veredicto de la IA, capturas y el plan de cada entrada (entrada, SL, TP y R:R), en Sandmarket, en Telegram y en la Mini App.
• Con tu misma estrategia: el gatillo, el análisis, la decisión y el plan son los mismos que en MetaTrader. Lo que ajustas para uno vale para el otro.
• No opera ni simula, y no lleva estadísticas. Las operaciones las abres tú en Sandmarket, y sus resultados los ves allí.

Cómo funciona#

Sandmarket (tu replay)                         Servicio VisionAlert (VPS)
  evento "vela cerrada" ───── al instante ───►  vigilante del simulador
  dibujos etiquetados ◄──────────────────────   arma el mismo trabajo `bars` que VisionAlertEA
  velas hasta el cierre ◄────────────────────   gatillo: las reglas de tu estrategia
                                                    │ dispara
   Flujos: "⏸ VisionAlert pide esperar…" ◄── aviso ──► Telegram: "⏳ La IA está analizando…"
                                                    ▼
                      capturas → visión → Jev → decisión → plan por entrada
                                                    ▼
   Flujos: resultado + plan, y su capa      ◄── resultado ──► Telegram: el aviso se edita

Por dentro, cada cierre de vela entra por el mismo camino que un trabajo de MetaTrader: el vigilante arma el trabajo bars, el gatillo lo evalúa y, si una regla dispara, el análisis es idéntico.

Ponerlo en marcha#

1. Sandmarket desplegado donde el servicio pueda llegar a él.
2. Crea el token. En Sandmarket, Cuenta → Tokens de API → Crear token, con el nombre "VisionAlert" (es el nombre con el que verás sus avisos) y el alcance Lectura y avisos (flows). Cópialo: solo se muestra una vez.
3. Guárdalo en service\.env:

text SANDMARKET_TOKEN=pega-aquí-tu-token

1. Actívalo en config.yaml:

yaml sandmarket: enabled: true base_url: "https://api.tusandmarket.com" # la API de tu Sandmarket session_id: auto # cualquiera de tus sesiones, o el id de una concreta

No hace falta MetaTrader: el simulador funciona con mt4_files_dir vacío.

1. Reinicia el servicio. En el registro debe salir Simulador: escuchando Sandmarket (…).
2. Comprueba: escribe /simulador al bot. Debe responder con la sesión vigilada y su reloj. En la Mini App aparece la pestaña 🎮 Simulador.

Qué se vigila#

Siguiente paso#

Entrena con el replay: cómo etiquetar los dibujos, frenar el replay mientras la IA trabaja y leer el resultado.