C
Docs

Documentacion

Aprende a configurar y usar Cuanted para automatizar tu trading.

Inicio rápido

Conceptos básicos y flujo de señal a orden

Guía TradingView

Configura alertas y payloads JSON

Seguridad

HMAC, idempotencia y límites

Errores comunes

Soluciones a problemas frecuentes

Inicio rápido

Conceptos básicos

Cuanted actúa como middleware entre TradingView y tus exchanges. El flujo es:

  1. TradingView detecta una condición en tu estrategia y dispara una alerta
  2. La alerta envía un webhook con un payload JSON a tu URL única de Biconnect
  3. Biconnect recibe, valida y parsea el payload
  4. Se aplican reglas de riesgo y mapeo de señales
  5. La orden se envía al exchange configurado
  6. Biconnect registra todo el proceso en logs para auditoría

Primeros pasos

  1. Crea una cuenta en Cuanted
  2. Conecta tu exchange (Binance) con API keys
  3. Crea una estrategia y obtén tu webhook URL única
  4. Configura una alerta en TradingView con esa URL
  5. Monitorea las ejecuciones en el dashboard

Guía TradingView

Crear una alerta

  1. Abre un gráfico en TradingView
  2. Haz clic en el botón de campana (Alertas) en la barra superior
  3. Configura la condición que disparará la alerta
  4. En la sección "Notifications", marca "Webhook URL"
  5. Pega tu URL de webhook de Cuanted

Ejemplo de payload JSON

{
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "strategy_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

El payload solo incluye los identificadores necesarios. El backend de Biconnect usa estos IDs para buscar la configuración completa de la estrategia en la base de datos y ejecutar la orden según los parámetros configurados.

Campos del payload

user_id
ID único del usuario. Se obtiene automáticamente al crear la estrategia.
strategy_id
ID único de la estrategia. El backend usa este ID para cargar la configuración completa (par, gestión de riesgo, leverage, etc.) y ejecutar la orden.

Seguridad

HMAC (Plan Pro)

La validación HMAC garantiza que las señales provienen realmente de TradingView:

  1. Activa HMAC en la página de Integraciones
  2. Copia el secret generado
  3. Configúralo en TradingView al crear la alerta
  4. Cada webhook incluirá una firma que Cuanted verificará

Idempotencia

Biconnect usa el campo client_id para detectar señales duplicadas. Si TradingView envía la misma alerta múltiples veces, solo se ejecutará una vez.

TTL (Time To Live)

Las señales tienen un tiempo de expiración configurable. Si una señal llega después de su TTL, se rechaza automáticamente para evitar ejecutar órdenes con datos obsoletos.

Límites de rate

Para proteger contra errores de configuración:

  • Plan Gratuito: 10 ejecuciones por minuto
  • Plan Pro: 100 ejecuciones por minuto

Errores comunes

Insufficient balance

No hay suficiente balance en el exchange para ejecutar la orden.

Solución: Verifica el balance en tu exchange o reduce el tamaño de la orden.

Invalid symbol

El símbolo no existe en el exchange o no está en la lista blanca.

Solución: Verifica que el símbolo sea correcto (ej: BTCUSDT) y esté permitido en tu estrategia.

Rate limit exceeded

Se superó el límite de ejecuciones por minuto del exchange.

Solución: El sistema reintentará automáticamente. Considera espaciar más las señales.

Duplicate signal

La señal ya fue procesada anteriormente (mismo client_id).

Solución: Esto es normal y protege contra ejecuciones duplicadas. No requiere acción.