Esta página fue traducida automáticamente. El original en inglés es la versión canónica. Leer en inglés →
Saltar al contenido principal

Runbooks

Lista de verificación completa de preparación del desk y pruebas de certificación de integración.

Lista de Verificación de Preparación del Desk​

Antes de operar en vivo, verifique:

Conectividad de la API​

  • Endpoints de staging probados
  • Endpoints de producción configurados (cuando estén disponibles)
  • Endpoint de health check respondiendo
  • Conexión WebSocket estable

Autenticación​

  • Firma EIP-712 funcionando
  • Autorización de agente configurada (si aplica)
  • Gestión de nonces implementada
  • Verificación de firmas probada

Sistema de Cotización​

  • Colocación de órdenes en bloque probada
  • Reconciliación del ciclo de vida de órdenes verificada
  • Seguimiento de ejecuciones implementado
  • Funcionalidad de cancelación probada

Controles de Riesgo​

  • MMP configurado y probado
  • Modelo de margen comprendido
  • Restricciones de tier verificadas
  • Monitoreo de portafolio implementado

Monitoreo​

  • Suscripción a feeds de WebSocket
  • Reconciliación de órdenes/ejecuciones automatizada
  • Health checks configurados
  • Alertas configuradas

Kill Switch​

  • Capacidad de cancelar todas las órdenes
  • Capacidad de desconectarse inmediatamente
  • Procedimientos de emergencia documentados

Cobertura​

  • Integración con perpetuos de Hyperliquid verificada
  • Estrategia de cobertura delta implementada
  • Cálculo de margen de perpetuos comprendido

Settlement​

  • Manejo de vencimientos probado
  • Liquidación al vencimiento de posiciones verificada
  • Fuente del precio de referencia comprendida

Pruebas de Certificación de Integración​

Prueba 1: Colocación de Órdenes​

Pasos:

  1. Coloque una orden individual vía POST /order
  2. Verifique el estado de la orden: ACKED → OPEN
  3. Compruebe que la orden aparece en GET /orders?wallet=...
  4. Verifique que se recibe order_updates por WebSocket

Esperado: Orden colocada exitosamente, actualizaciones de estado recibidas

Prueba 2: Colocación de Órdenes en Bloque​

Pasos:

  1. Coloque 10 órdenes vía POST /bulk_order
  2. Verifique que todas las órdenes fueron aceptadas
  3. Compruebe los estados de las órdenes vía REST y WS
  4. Verifique que no hay errores de firma/autenticación

Esperado: Todas las órdenes colocadas exitosamente

Prueba 3: Seguimiento de Ejecuciones​

Pasos:

  1. Coloque una orden que se ejecutará
  2. Monitoree el canal fills del WebSocket
  3. Verifique que la ejecución se recibe con el order_id correcto
  4. Compruebe que la ejecución aparece en GET /fills?wallet=...
  5. Verifique que el estado de la orden se actualiza a FILLED

Esperado: Ejecuciones rastreadas correctamente, estado de la orden actualizado

Prueba 4: Seguimiento de Ejecuciones Parciales​

Pasos:

  1. Coloque una orden que se ejecutará parcialmente
  2. Monitoree el canal fills del WebSocket (no order_updates)
  3. Verifique que se recibe la ejecución parcial
  4. Agregue las ejecuciones por order_id para calcular el tamaño ejecutado
  5. Verifique que el estado de la orden permanece OPEN (no PARTIALLY_FILLED en WS)

Esperado: Ejecuciones parciales rastreadas vía el canal fills, estado de la orden correcto

Prueba 5: Cancelación de Órdenes​

Pasos:

  1. Coloque una orden vía POST /order
  2. Cancele la orden vía DELETE /order
  3. Verifique el estado de la orden: CANCELED
  4. Compruebe que se recibe order_updates por WebSocket

Esperado: Orden cancelada exitosamente, actualizaciones de estado recibidas

Prueba 6: Activación de MMP​

Pasos:

  1. Configure MMP vía POST /mmp-config
  2. Coloque órdenes con MMP habilitado
  3. Active el MMP excediendo los límites
  4. Verifique que las órdenes se cancelan con motivo MMP
  5. Compruebe que las otras órdenes con MMP habilitado también se cancelan

Esperado: MMP se activa correctamente, órdenes canceladas

Prueba 7: Rechazo por Margen​

Pasos:

  1. Coloque una orden que exceda el margen
  2. Verifique que la orden es rechazada con el motivo "Insufficient margin"
  3. Compruebe que el motivo de rechazo incluye los valores de margen requerido, disponible y déficit
  4. Verifique el estado de la orden: REJECTED

Esperado: Orden rechazada con motivo claro

Prueba 8: Restricción de Tier​

Pasos:

  1. Use una wallet configurada para acceso solo long
  2. Intente colocar una orden de venta sin posición larga
  3. Verifique que la orden es rechazada con motivo de tier
  4. Coloque una orden de compra (debería tener éxito)
  5. Coloque una orden de venta para cerrar (debería tener éxito)

Esperado: Restricciones de tier aplicadas correctamente

Prueba 9: Reconexión de WebSocket​

Pasos:

  1. Conéctese al WebSocket
  2. Suscríbase a los canales
  3. Desconecte el WebSocket
  4. Reconéctese con backoff exponencial
  5. Vuelva a suscribirse a los canales
  6. Consulte la API REST para recuperar las actualizaciones perdidas

Esperado: La reconexión funciona, estado recuperado

Prueba 10: Reconciliación de Portafolio​

Pasos:

  1. Coloque y ejecute órdenes
  2. Compruebe el portafolio vía GET /portfolio?wallet=...
  3. Verifique que las posiciones coinciden con las ejecuciones
  4. Compruebe que el uso de margen es correcto
  5. Reconcilie con las actualizaciones de portfolio del WebSocket

Esperado: Estado del portafolio preciso, reconciliación exitosa

Preparación para Producción​

Lista de Verificación Pre-Producción​

  • Todas las pruebas de integración aprobadas
  • Monitoreo y alertas configurados
  • Kill switch probado
  • Procedimientos de emergencia documentados
  • Equipo capacitado en respuesta a incidentes
  • Contactos de soporte identificados

Lista de Verificación de Salida a Producción​

  • Entorno de staging completamente probado
  • Endpoints de producción verificados
  • Dashboards de monitoreo listos
  • Alertas configuradas
  • Calendario de guardias del equipo establecido
  • Documentación revisada

Referencias​

Última actualización el