Liquidaciones Automáticas

Introducción

Las Liquidaciones Automáticas te permiten convertir automáticamente los depósitos entrantes a cualquier activo de destino en cualquier red blockchain basándose en tus reglas configuradas. Esto elimina la necesidad de intercambiar o hacer puentes de activos manualmente, asegurando que tu tesorería pueda convertirse automáticamente a tus activos preferidos a través de múltiples cadenas.

Gestión de Reglas

Crea y gestiona reglas de liquidación automática para automatizar las conversiones de activos.

Conversión de Activos

Convierte automáticamente cualquier stablecoin a cualquier otro activo basándose en tus reglas.

Entre Cadenas

Liquida activos a cualquier red blockchain sin problemas.

Gestión de Riesgos

Aplica tolerancia al deslizamiento y reglas para protegerte contra ejecuciones deficientes.

Cómo Funcionan las Liquidaciones Automáticas

1. Creación de Reglas

Define reglas de liquidación que especifiquen cuándo y cómo deben convertirse automáticamente los depósitos.

2. Detección de Depósitos

Cuando los fondos llegan a tus direcciones, Blockradar detecta automáticamente los depósitos que coinciden con tus reglas.

3. Conversión de Activos

Los depósitos se intercambian automáticamente a tu activo de destino (típicamente USDC) en tu cadena elegida.

4. Unificación de Saldo

Todos los activos convertidos se consolidan en un único saldo unificado en tu cadena de destino.

Reglas de Liquidación Automática

Componentes de la Regla

Cada regla de liquidación automática define los siguientes parámetros:

Componente	Descripción	Ejemplo
Nombre de la Regla	Nombre descriptivo para tu regla de liquidación	”Swap de USDC a USDC de Optimism”
Orden	Preferencia de prioridad de ejecución	FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE
Tolerancia al Deslizamiento	Desviación máxima aceptable del precio (%)	5
Activos de Origen	Array de activos para liquidar automáticamente	[“USDC”, “USDT”]
Monto Mín/Máx de Origen	Controlar el tamaño del depósito que activa la liquidación	Mín: $1, Máx:$ 1,000
Blockchain de Destino	Red blockchain objetivo	optimism, base, ethereum
Activo de Destino	Activo objetivo para conversión	USDC, USDT, cNGN, DAI
Dirección de Destino	Dirección específica para recibir los activos convertidos	0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22
Es Gateway	Habilitar funcionalidad de gateway para la regla	false

Opciones de Configuración de Regla

Umbrales de Monto

Monto Mínimo: Solo liquida depósitos por encima de este umbral
Monto Máximo: Limita el tamaño de las liquidaciones individuales
Procesamiento por Lotes: Agrupa múltiples depósitos pequeños para eficiencia

Protección contra Deslizamiento

Conservador: 0.1% - 0.5% (impacto mínimo en el precio)
Moderado: 0.5% - 1.0% (enfoque equilibrado)
Agresivo: 1.0% - 2.0% (ejecución más rápida)

Preferencias de Ejecución

Fastest: Prioriza velocidad sobre costo
Cheapest: Optimiza para las tarifas más bajas
Recommended: Equilibra velocidad y costo con confiabilidad
No Slippage: Ejecuta solo cuando no ocurre desviación de precio

Jerarquía y Precedencia de Reglas

Orden de Aplicación de Reglas

Reglas de Dirección Hija: Se aplican primero si existen
Reglas de Billetera Principal: Se aplican como respaldo si no hay reglas de dirección hija
Comportamiento Predeterminado: Sin liquidación automática si no hay reglas configuradas

Comportamiento de Anulación

Anulación de Dirección Hija: Las reglas específicas de la dirección anulan completamente las reglas de la billetera principal
Sin Herencia: Las direcciones hijas no heredan las reglas de la billetera principal cuando tienen las suyas propias
Configuración Independiente: Cada nivel puede tener estrategias de liquidación completamente diferentes

Casos de Uso para Cada Nivel

Reglas de Billetera Principal

Estrategia Consistente: Mismo comportamiento de liquidación en todas las direcciones
Gestión Simplificada: Un único lugar para configurar el comportamiento predeterminado
Operaciones en Masa: Aplicar reglas a múltiples direcciones a la vez
Estandarización: Garantizar cumplimiento y consistencia

Reglas de Dirección Hija

Pruebas: Probar diferentes estrategias de liquidación en direcciones específicas
Requisitos Personalizados: Necesidades de liquidación específicas de la dirección
Anular Predeterminados: Modificar el comportamiento para casos de uso particulares
Control Granular: Ajustar finamente la liquidación para direcciones específicas

Creación de Reglas de Liquidación Automática

A través del Panel de Control

Navega a la sección de Liquidaciones Automáticas de tu billetera
Haz clic en “Crear Nueva Regla”
Configura los parámetros de la regla
Establece umbrales de monto y tolerancia al deslizamiento
Elige activos/cadenas de origen y destino
Guarda y activa la regla

A través de la API

Crea reglas de liquidación programáticamente usando la API de Reglas de Liquidación Automática:

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/auto-settlements/rules \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "name": "Swap de USDC a USDC de Optimism",
    "order": "FASTEST",
    "slippageTolerance": "5",
    "source": {
        "assets": [
            "USDC",
            "USDT"
        ],
        "minAmount": "1",
        "maxAmount": "1000"
    },
    "destination": {
        "blockchain": "optimism",
        "asset": "USDC",
        "address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22"
    }
}'

Casos de Uso

Gestión de Tesorería

Conversión Flexible de Activos: Convertir a cualquier activo preferido (USDC, ETH, USDT, etc.)
Operaciones Entre Cadenas: Mantener saldos a través de múltiples redes
Consolidación Automatizada: Sin intervención manual requerida
Estrategia Multi-activo: Soportar varias preferencias y estrategias de activos

Operaciones Comerciales

Procesamiento de Pagos: Liquidar automáticamente pagos entrantes a activos preferidos
Gestión de Ingresos: Convertir varias stablecoins a tu activo de destino elegido
Mitigación de Riesgos: Aplicar protección contra deslizamiento automáticamente
Diversificación de Activos: Mantener asignaciones de activos objetivo automáticamente

Integración DeFi

Yield Farming: Liquidar automáticamente recompensas a activo preferido
Gestión de Liquidez: Consolidar recompensas y tarifas de LP
Rebalanceo de Cartera: Mantener asignaciones de activos objetivo

Mejores Prácticas

Configuración de Reglas

Comenzar Conservador: Empieza con baja tolerancia al deslizamiento
Monitorear el Rendimiento: Rastrear tasas de éxito de liquidación
Ajustar Gradualmente: Afinar reglas basándose en condiciones del mercado
Probar en Testnet: Validar reglas antes del despliegue en mainnet

Gestión de Riesgos

Límites de Deslizamiento: Establecer niveles de tolerancia apropiados
Límites de Monto: Limitar tamaños máximos de liquidación
Selección de Red: Elegir cadenas de destino confiables
Reglas de Respaldo: Crear opciones de liquidación alternativas

Eficiencia Operacional

Procesamiento por Lotes: Agrupar depósitos pequeños para eficiencia
Optimización de Tiempo: Considerar patrones de congestión de red
Análisis de Costos: Equilibrar velocidad vs. preferencias de costo
Monitoreo: Configurar alertas para liquidaciones fallidas

Monitoreo y Alertas

Monitoreo del Panel de Control

Estado de Reglas: Indicadores de reglas activas/inactivas
Historial de Liquidaciones: Rastrear liquidaciones exitosas y fallidas
Métricas de Rendimiento: Tasas de éxito y tiempos de ejecución
Saldos de Activos: Monitorear crecimiento de saldo unificado

Notificaciones Webhook

Las liquidaciones automáticas activan eventos webhook cuando se ejecutan las liquidaciones:

Evento	Descripción
`swap.success`	El swap de liquidación automática se ejecutó exitosamente
`swap.failed`	El swap de liquidación automática falló al ejecutarse

Ejemplo de Payload de Webhook

{
  "event": "swap.success",
  "data": {
    "id": "99a2b490-0798-460b-9265-4d99f182fe52",
    "reference": "ZMxcorDGtf",
    "senderAddress": "0xAA2d5fd5e7bE97E214f8565DCf3a4862719960b5",
    "recipientAddress": "0xb55c054D8eE75224E1033e6eC775B4F62D942b43",
    "amount": "5",
    "status": "SUCCESS",
    "type": "SWAP",
    "network": "mainnet",
    "toAmount": "4.965398",
    "rate": "0.9930796000000001",
    "asset": {
      "name": "USD Coin",
      "symbol": "USDC",
      "network": "mainnet"
    },
    "toAsset": {
      "name": "Tether USD",
      "symbol": "USDT",
      "network": "mainnet"
    },
    "toBlockchain": {
      "name": "optimism",
      "slug": "optimism"
    },
    "toWallet": {
      "name": "Optimism Mainnet Wallet",
      "address": "0xb55c054D8eE75224E1033e6eC775B4F62D942b43"
    },
    "metadata": {
      "swapAutoSettlement": {
        "rule": {
          "id": "rule-id-123",
          "name": "USDT a USDC en Base",
          "order": "RECOMMENDED",
          "slippageTolerance": 5,
          "source": {
            "assets": ["USDC", "USDT"],
            "minAmount": "1",
            "maxAmount": "1000"
          },
          "destination": {
            "blockchain": "optimism",
            "asset": "USDC",
            "address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22"
          }
        },
        "settleAmount": "5"
      },
      "transactionId": "transaction-id"
    }
  }
}

Distinguir Liquidaciones Automáticas de Swaps Regulares

El payload del webhook incluye metadatos que ayudan a identificar las transacciones de liquidación automática:

Campo	Descripción
`metadata.swapAutoSettlement.rule`	Payload completo de la regla de liquidación automática que activó este swap
`metadata.swapAutoSettlement.settleAmount`	Monto que fue liquidado según la regla
`metadata.transactionId`	ID de transacción interno para seguimiento

Cuando metadata.swapAutoSettlement está presente, el swap fue activado por una regla de liquidación automática. El campo rule contiene la configuración completa de la regla, no solo un ID.

Campos Clave de Datos del Webhook

Campo	Descripción
`toAmount`	Monto final recibido después del swap (contabilizando tarifas y deslizamiento)
`rate`	Tasa de cambio utilizada para el swap
`toAsset`	Detalles del activo de destino (USDT en este ejemplo)
`toBlockchain`	Red blockchain de destino (Optimism en este ejemplo)
`toWallet`	Billetera de destino que recibió los activos convertidos
`assetSwept`	Si los activos originales fueron barridos después de la conversión

Referencia de API

Endpoints

Liquidaciones Automáticas de Billetera Principal

Endpoint	Método	Descripción	Referencia de API
`/v1/wallets/{walletId}/auto-settlements/rules`	GET	Listar todas las reglas de liquidación para billetera principal	Obtener Todas las Reglas
`/v1/wallets/{walletId}/auto-settlements/rules`	POST	Crear nueva regla de liquidación para billetera principal	Crear Regla
`/v1/wallets/{walletId}/auto-settlements/rules/{id}`	GET	Obtener detalles específicos de regla de billetera principal	Obtener Regla
`/v1/wallets/{walletId}/auto-settlements/rules/{id}`	PATCH	Actualizar regla existente de billetera principal	Actualizar Regla
`/v1/wallets/{walletId}/auto-settlements/rules/{id}`	DELETE	Eliminar regla de liquidación de billetera principal	Eliminar Regla
`/v1/wallets/{walletId}/auto-settlements`	GET	Obtener historial de liquidación de billetera principal	Obtener Liquidación
`/v1/wallets/{walletId}/auto-settlements`	PATCH	Actualizar configuraciones de liquidación de billetera principal	Actualizar Liquidación

Liquidaciones Automáticas de Dirección Hija

Endpoint	Método	Descripción	Referencia de API
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules`	GET	Listar todas las reglas de liquidación para dirección específica	Obtener Todas las Reglas
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules`	POST	Crear nueva regla de liquidación para dirección específica	Crear Regla
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	GET	Obtener detalles específicos de regla de dirección	Obtener Regla
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	PATCH	Actualizar regla existente de dirección	Actualizar Regla
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	DELETE	Eliminar regla de liquidación de dirección	Eliminar Regla
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements`	GET	Obtener historial de liquidación de dirección	Obtener Liquidación
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements`	PATCH	Actualizar configuraciones de liquidación de dirección	Actualizar Liquidación

Parámetros de Regla

Parámetro	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre de regla para identificación
`order`	string	Sí	Prioridad de ejecución (FASTEST/CHEAPEST/RECOMMENDED/NO_SLIPPAGE)
`slippageTolerance`	number	Sí	Deslizamiento máximo aceptable (%)
`isGateway`	boolean	false	Habilitar funcionalidad de gateway para la regla
`source.assets`	array	Sí	Array de activos de origen para liquidar automáticamente
`source.minAmount`	string	No	Monto mínimo para activar liquidación
`source.maxAmount`	string	No	Monto máximo por liquidación
`destination.blockchain`	string	Sí	Red blockchain objetivo
`destination.asset`	string	Sí	Activo objetivo para conversión
`destination.address`	string	Sí	Dirección de destino para recibir activos convertidos

Comenzando

1. Habilitar Liquidaciones Automáticas

Navega a la configuración de tu billetera
Habilita la funcionalidad de liquidación automática
Configura preferencias predeterminadas

2. Crea tu Primera Regla

Comienza con una regla simple de USDT a ETH (o cualquier activo que prefieras)
Establece tolerancia al deslizamiento conservadora
Elige tu cadena y activo de destino preferidos

3. Prueba y Monitorea

Despliega en testnet primero
Monitorea tasas de éxito de liquidación
Ajusta parámetros según sea necesario

4. Escala Gradualmente

Añade reglas para activos adicionales
Implementa procesamiento por lotes
Optimiza para tu caso de uso

Soporte y Recursos

Obtener Ayuda

Email: [email protected]
Referencia de API: Reglas de Liquidación Automática
Documentación: Configuración de Gateway

Las liquidaciones automáticas son una forma poderosa de automatizar la gestión de tu tesorería. Comienza con reglas simples y gradualmente añade complejidad a medida que te familiarices más con el sistema.

Comenzar

Esenciales

​Introducción

Gestión de Reglas

Conversión de Activos

Entre Cadenas

Gestión de Riesgos

​Cómo Funcionan las Liquidaciones Automáticas

​1. Creación de Reglas

​2. Detección de Depósitos

​3. Conversión de Activos

​4. Unificación de Saldo

​Reglas de Liquidación Automática

​Componentes de la Regla

​Opciones de Configuración de Regla

​Umbrales de Monto

​Protección contra Deslizamiento

​Preferencias de Ejecución

​Jerarquía y Precedencia de Reglas

​Orden de Aplicación de Reglas

​Comportamiento de Anulación

​Casos de Uso para Cada Nivel

​Reglas de Billetera Principal

​Reglas de Dirección Hija

​Creación de Reglas de Liquidación Automática

​A través del Panel de Control

​A través de la API

​Casos de Uso

​Gestión de Tesorería

​Operaciones Comerciales

​Integración DeFi

​Mejores Prácticas

​Configuración de Reglas

​Gestión de Riesgos

​Eficiencia Operacional

​Monitoreo y Alertas

​Monitoreo del Panel de Control

​Notificaciones Webhook

​Ejemplo de Payload de Webhook

​Distinguir Liquidaciones Automáticas de Swaps Regulares

​Campos Clave de Datos del Webhook

​Referencia de API

​Endpoints

​Liquidaciones Automáticas de Billetera Principal

​Liquidaciones Automáticas de Dirección Hija

​Parámetros de Regla

​Comenzando

​1. Habilitar Liquidaciones Automáticas

​2. Crea tu Primera Regla

​3. Prueba y Monitorea

​4. Escala Gradualmente

​Soporte y Recursos

​Obtener Ayuda

Introducción

Cómo Funcionan las Liquidaciones Automáticas

1. Creación de Reglas

2. Detección de Depósitos

3. Conversión de Activos

4. Unificación de Saldo

Reglas de Liquidación Automática

Componentes de la Regla

Opciones de Configuración de Regla

Umbrales de Monto

Protección contra Deslizamiento

Preferencias de Ejecución

Jerarquía y Precedencia de Reglas

Orden de Aplicación de Reglas

Comportamiento de Anulación

Casos de Uso para Cada Nivel

Reglas de Billetera Principal

Reglas de Dirección Hija

Creación de Reglas de Liquidación Automática

A través del Panel de Control

A través de la API

Casos de Uso

Gestión de Tesorería

Operaciones Comerciales

Integración DeFi

Mejores Prácticas

Configuración de Reglas

Gestión de Riesgos

Eficiencia Operacional

Monitoreo y Alertas

Monitoreo del Panel de Control

Notificaciones Webhook

Ejemplo de Payload de Webhook

Distinguir Liquidaciones Automáticas de Swaps Regulares

Campos Clave de Datos del Webhook

Referencia de API

Endpoints

Liquidaciones Automáticas de Billetera Principal

Liquidaciones Automáticas de Dirección Hija

Parámetros de Regla

Comenzando

1. Habilitar Liquidaciones Automáticas

2. Crea tu Primera Regla

3. Prueba y Monitorea

4. Escala Gradualmente

Soporte y Recursos

Obtener Ayuda