Documentación
Última actualización:
De cero a un bot funcionando: conectar un exchange, entender el preview y saber qué puedes tocar mientras opera.
Empieza en simulación y con poco capital. Un bot apalancado puede perder todo el margen asignado en un movimiento adverso. La secuencia recomendada es: simulación → testnet de Hyperliquid → real con 20 USDC y apalancamiento 1× → subir despacio.
1. Conectar un exchange
CRYPTON nunca pide tu frase semilla. Se guarda una clave de firma delegada: coloca y cancela órdenes en tu cuenta, pero no puede retirar. La generas en el propio exchange y la revocas allí cuando quieras, sin pasar por nosotros.
| Exchange | Qué se pide | A tener en cuenta |
|---|---|---|
| Hyperliquid | API wallet — no puede retirar | Tiene testnet pública: el mejor sitio para probar un bot sin arriesgar nada. |
| Lighter | Índice de cuenta + clave API | El apalancamiento se fija por mercado antes de crear el bot. |
| Aster | API wallet con firma EIP-712 — no puede retirar | Requiere fijar modo de posición y de margen por mercado. |
La conexión se verifica antes de guardarla, con una llamada de solo lectura. Si la credencial no funciona, no se almacena.
Cómo se guarda la clave
Con cifrado de sobre: cada credencial se cifra con una clave de datos única, y esa clave con la clave maestra del servidor. Un volcado de la base de datos sin la maestra no permite firmar ni una orden. El descifrado ocurre solo en memoria del proceso que ejecuta tu bot.
2. El preview
Antes de confirmar, la app calcula la escalera completa con el mismo código que ejecutará el motor. Para cada nivel muestra precio, cantidad, margen y notional acumulado; y al final, el peor caso.
- Notional del peor caso. La exposición total si se llena la escalera entera.
- Precio medio resultante. Dónde quedaría tu entrada media en ese escenario.
- Liquidación estimada y a qué distancia porcentual está del precio actual.
- Avisos por nivel. Si alguno cae bajo el notional mínimo o no encaja en la retícula de precios, se marca y el bot no se crea.
3. Ajustes con el bot en marcha
Cada parámetro lleva una etiqueta que dice qué ocurre al cambiarlo en caliente. No es una advertencia genérica: determina lo que hace el motor.
| Etiqueta | Qué hace el bot | Ejemplos |
|---|---|---|
| HOT | Lo aplica en el siguiente ciclo. Reajusta órdenes; no toca la posición. | Take profit, distancias en bps, topes, stop loss |
| WARM | Cancela y vuelve a tender la escalera. La posición sigue abierta. Pide confirmación. | Niveles, rango, separación, escalas, inversión, apalancamiento |
| COLD | Se rechaza. Cambiarlo sería otro bot distinto. | Par, exchange, dirección, estrategia, modo de margen |
El apalancamiento es WARM y no HOT por una razón concreta: muchos exchanges lo rechazan con posición abierta y, cuando lo aceptan, mueve tu precio de liquidación.
Controles de ejecución
| Acción | Efecto |
|---|---|
| Arrancar | Pone el bot en marcha y tiende la escalera. |
| Pausar | Cancela las órdenes. Mantiene la posición. |
| Reanudar | Vuelve a tender sin cerrar nada. |
| Parar conservando posición | Cancela órdenes y detiene el bot; la posición queda a tu nombre. |
| Parar y cerrar | Cancela órdenes y cierra a mercado. Irreversible: pide confirmación. |
| Cerrar ya | Cierra la posición a mercado sin parar el bot. |
| Tomar beneficio ya | Cierra a mercado sin esperar al objetivo. |
| Adelantar seguridad | Ejecuta a mercado la siguiente orden de seguridad pendiente. |
| Recentrar retícula | Vuelve a colgar la escalera del precio actual. |
| Cancelar órdenes | Retira todas las órdenes del bot; la posición no se toca. |
| Pánico | Cancela todo y cierra a mercado. También global, para todos tus bots. |
4. Panel de riesgo
Los límites se comprueban al crear el bot y en cada ciclo del motor. Un bot que era seguro al arrancar puede estar a un 3 % de la liquidación media hora después.
- Notional máximo por bot y agregado de todos tus bots.
- Apalancamiento máximo y número de bots simultáneos.
- Pérdida diaria máxima: al superarla no se arrancan bots nuevos.
- Caída que dispara la pausa automática sobre el capital asignado.
- Distancia de alerta a liquidación, con aviso escalonado.
Cuando una guarda salta, el bot se pausa. No se cierra: cerrar realizaría la pérdida al instante y en el peor momento. Pausar detiene el sangrado y deja la decisión final en tus manos.
5. Modo simulación
Un bot en simulación consume los precios reales del exchange pero no envía ni una orden: las ejecuta en memoria. Cobra comisiones y aplica deslizamiento, para que el resultado no salga optimista de forma artificial.
Lo que la simulación no reproduce:
- La profundidad del libro: una orden se llena entera al tocarse su precio.
- La cola de prioridad de las órdenes post-only.
- La liquidación por parte del exchange.
El modo se fija al crear el bot y no se puede cambiar: mezclar operaciones simuladas y reales en el mismo histórico haría que su PnL no significara nada.
6. Qué pasa si algo falla
El motor no ejecuta pasos memorizados: en cada ciclo calcula qué órdenes deberían existir y las compara con las que hay de verdad en el exchange. Solo ejecuta la diferencia. De ahí salen tres propiedades:
- Se recupera solo. Un reinicio, una caída del WebSocket o una orden que canceles a mano: en el siguiente ciclo el estado vuelve a converger.
- No duplica posiciones. Cada orden lleva un identificador determinista y las ejecuciones se deduplican. Un reintento tras un timeout no abre la posición dos veces.
- Respeta lo que no es suyo. Si operas a mano en la misma cuenta, esas órdenes no se tocan.
Soporte
Si escribes sobre un bot concreto, incluye su identificador: cada bot guarda una bitácora completa de lo que hizo y por qué, con la configuración vigente en cada momento.