Documentación

Motor de Riesgo y Referencia de Webhook

Cómo AlgoVesta verifica cada señal antes de ejecutarla, y el payload JSON exacto a enviar desde TradingView o cualquier fuente webhook. Los nombres de campo son literales — cópialos tal cual.

AlgoVesta ejecuta operaciones desde tres canales de activación: un servidor MCP para asistentes de IA, señales de Telegram y webhooks de TradingView. Sea cual sea el canal que se active, el mismo motor de riesgo del lado del servidor verifica la orden antes de que llegue a tu exchange o cuenta de MetaTrader 5. Esta página es el centro de referencia técnica para los tres.

Tres formas de activar una operación

Cada canal termina en la misma ruta de ejecución: verificación, dimensionamiento, orden, y luego stop-loss y take-profit colocados directamente en el mercado. Elige el canal que se ajuste a cómo ya trabajas.

Servidor MCP para asistentes de IA

Conecta Claude, ChatGPT, Cursor o cualquier cliente compatible con MCP a veinte herramientas de trading nativas mediante un único enlace autenticado. Cada conexión comienza con un saldo de papel de $5,000, y las claves en vivo se crean por separado con un segundo factor. La autenticación es mediante OAuth 2.1 con PKCE (S256) o un enlace secreto por usuario.

Canales de señales de Telegram

Apunta AlgoVesta a los canales de señales que ya sigues. Los mensajes se analizan para extraer símbolo, dirección, entrada, stop-loss y objetivos, y luego se ejecutan en tu exchange o se reenvían a MetaTrader 5. Las señales que no se pueden interpretar sin ambigüedad se rechazan en lugar de adivinarse.

Webhooks de TradingView

Envía una alerta desde cualquier indicador, dibujo o estrategia Pine a tu URL de webhook privada. El cuerpo de la alerta debe ser un JSON válido en el formato documentado más abajo, y la fuente de cada señal auto-operada se verifica antes de abrir una orden.

Motor de Riesgo: cómo se verifica una señal

Una señal nunca se ejecuta a ciegas. Antes de colocar una orden, pasa por una capa de verificación multimódulo que la contrasta con las condiciones de mercado en vivo y los límites que defines. Si falla una regla estricta, la señal se rechaza — no se reduce.

Puntuación neuronaluna puntuación de confianza de 0–100 de un modelo.
Volumen y flujo de órdenespicos de volumen y desequilibrio de operaciones agresivas (VPIN).
Régimen de mercadoclasificación tendencia vs rango vs reversión a la media.
Funding y liquidacióndinámica de la tasa de funding y clústeres de liquidación.
Mapeo de stop-lossevita colocar stops dentro de clústeres de liquidez conocidos.
Tus reglas estrictasdirección, horas de sesión, límites de posición y drawdown.

El conjunto exacto de módulos y umbrales evoluciona a medida que se ajusta la plataforma. El principio es constante: tus reglas y límites de riesgo siempre se aplican antes de que una orden llegue a tu exchange.

Pérdida diaria y protección de drawdown

Más allá de las comprobaciones por señal, dos salvaguardas a nivel de cuenta funcionan continuamente.

Límite de pérdida diariaCuando tu pérdida realizada del día alcanza el límite configurado — un porcentaje del saldo o una cantidad fija — AlgoVesta entra en Modo Seguro y deja de abrir nuevas operaciones hasta el día siguiente.
Dimensionamiento por drawdownA medida que crece el drawdown de la cuenta, el tamaño de posición se reduce automáticamente por etapas (cauteloso → defensivo → supervivencia), para que una racha perdedora reduzca tu exposición en lugar de agravarla.

Referencia del payload webhook

Envía un HTTP POST con cuerpo JSON a tu URL de webhook de AlgoVesta. En TradingView, pégalo en el cuadro de mensaje de la alerta. Los nombres de campo deben coincidir exactamente.

# POST https://api.algovesta.com/webhook/<your-token> { "symbol": "BTCUSDT", "side": "buy", "price": 64250.0, "stop_loss": 63800.0, "take_profit": 65100.0 }
CampoObligatorioDescripción
symbolPar de trading del exchange, p. ej. BTCUSDT.
side / actionDirección de la orden: buy o sell.
priceOpcionalPrecio de referencia de entrada; omítelo para entrada a mercado.
stop_lossOpcionalPrecio de stop-loss. Recomendado en cada señal.
take_profitOpcionalPrecio de take-profit. Múltiples objetivos configurables en la app.
marketOpcionalMercado objetivo: crypto (predeterminado) o forex. Se envía a MetaTrader 5 cuando se establece en forex. Nunca se infiere del símbolo.
lotsOpcionalSolo forex — tamaño de la posición en lotes. Déjalo vacío para usar tu modo de lote/riesgo configurado.
leverageOpcionalSolo crypto — se aplica el límite de tu exchange para ese símbolo.
amount_usdOpcionalSolo crypto — margen, no el valor nocional. Nocional = margen × apalancamiento.
risk_percentOpcionalSolo crypto — % del saldo a arriesgar (0,1–50).
quantityOpcionalSolo crypto — cantidad exacta de contratos. qty, size y contracts se aceptan como alias.
take_profitsOpcionalMúltiples objetivos: [{"price":…, "close_pct":…}]. tp1tp5 con tpN_close también funciona.
trailingOpcional{"trigger_pct":…, "distance_pct":…} — stop dinámico (trailing stop).
breakevenOpcionaltrue o {"trigger_pct":…} — mueve el stop a la entrada una vez en beneficio.

Los prefijos de exchange se eliminan, así que BINANCE:BTCUSDT funciona igual que BTCUSDT. En el campo de dirección, direction y type se aceptan como alias de action, y close es un valor válido.

El tamaño de la posición, el apalancamiento y el riesgo por señal pueden provenir de tu panel o del payload — un valor en el payload tiene prioridad. Por eso la URL del webhook es un secreto: añade una lista blanca de IP para que AlgoVesta solo opere automáticamente señales cuya fuente pueda verificar.

Cerrar una posición

Envía "action": "close" junto con el símbolo. Se cierra toda la posición de ese símbolo — los cierres parciales no son compatibles; si solicitas uno, se cierra la posición completa y el panel lo indica.

{ "symbol": "BTCUSDT", "action": "close" }

Alertas de estrategia Pine — las salidas son automáticas

Si construyes la alerta a partir de una strategy() de Pine con “Order fills only”, no envíes action solo: {{strategy.order.action}} también devuelve sell en una salida, lo que abriría una posición corta en lugar de cerrarla. Incluye los campos de estado de la posición y AlgoVesta calculará la entrada, la salida y la reversión por ti.

{ "symbol": "{{ticker}}", "action": "{{strategy.order.action}}", "market_position": "{{strategy.market_position}}", "prev_market_position": "{{strategy.prev_market_position}}", "position_size": "{{strategy.position_size}}" }
Posición después de la ejecuciónQué hace AlgoVesta
flat (or position_size = 0)Cierra la posición. No se abre ninguna orden inversa.
Opuesto al estado anteriorReversión — primero cierra, luego abre la nueva dirección. Si el cierre falla, no se abre nada.
Misma dirección que antesSe trata como una entrada en esa dirección.

El mensaje debe ser JSON. TradingView envía el cuerpo de la alerta como texto plano cuando no es un JSON válido — su mensaje predeterminado (p. ej. “BTCUSDT Crossing 1.00”) no lleva dirección y se rechaza. Nunca adivinamos con texto ambiguo; rechazar una señal es más seguro que abrir una orden en la dirección equivocada. Ten en cuenta también que TradingView detiene las alertas automáticamente después de 15 activaciones en 3 minutos.

Sin código
No escribas JSON a mano — créalo visualmente

Configura dirección, take-profit / stop-loss (único o multinivel), apalancamiento, tamaño de posición, trailing y breakeven con simples interruptores. AlgoVesta genera el mensaje de alerta exacto de TradingView — cópialo y pégalo en tu alerta.

Mira cómo funciona el creador visual → Configuración de alertas paso a paso →

Preguntas frecuentes

¿Qué canales pueden activar una operación en AlgoVesta?

Tres: el servidor MCP usado por los asistentes de IA, los canales de señales de Telegram y los webhooks de TradingView. También puedes abrir una operación manualmente desde tu panel. Cada canal converge en la misma ruta de ejecución y las mismas verificaciones de riesgo.

¿Es obligatorio el formato JSON del webhook para TradingView?

Sí. TradingView envía el cuerpo de la alerta como texto plano cuando no es un JSON válido, y su mensaje de alerta predeterminado no lleva dirección, por lo que se rechaza. Usa el formato de payload documentado en la referencia del payload webhook anterior, o créalo visualmente y pega el resultado en tu alerta.

¿El motor de riesgo también se aplica a las órdenes de MCP y Telegram?

Sí — las mismas verificaciones del lado del servidor se ejecutan en cada canal. Tu política de riesgo, el requisito de stop-loss y tus límites de posición y drawdown se aplican antes de que una orden llegue a un mercado, ya sea que la orden provenga de un asistente de IA, una señal de Telegram o una alerta de TradingView. Ningún prompt ni mensaje puede relajarlos.

¿Dónde encuentro la referencia completa de herramientas MCP?

La referencia para desarrolladores de MCP documenta las 20 herramientas, los tres alcances, la autenticación con OAuth 2.1 y enlace secreto, los límites de velocidad, los códigos de error y los 16 exchanges compatibles además de MetaTrader 5.

¿Puedo probarlo sin dinero real?

Sí. Cada conexión MCP comienza con un saldo de papel virtual de $5,000 con precios de mercado reales, y tanto la automatización de TradingView como la de Telegram tienen un modo demo que simula el flujo completo de señal a orden. El trading en vivo siempre requiere una clave o conexión independiente, creada explícitamente.