Liquidaciones Automáticas

En pocas palabras
Las Liquidaciones Automáticas convierten automáticamente los depósitos entrantes a tu activo preferido en cualquier blockchain. Define reglas una vez, y todos los depósitos coincidentes se intercambian y enrutan a tu cadena de destino—sin intervención manual requerida.

Requisitos Previos

Antes de configurar reglas de liquidación automática, asegúrate de tener:

Clave API

Obtén tu clave API desde el Panel de Blockradar. Navega a Developers para generar una.

Billetera Principal Creada

Crea una billetera principal a través de la API de Crear Billetera o el panel. Las reglas se configuran por billetera.

Billetera de Destino

Si liquidas entre cadenas, asegúrate de tener una billetera en la blockchain de destino para recibir los activos convertidos.

Gas Suficiente

Financia tus billeteras con tokens nativos (ETH, BNB, MATIC, etc.) para cubrir las tarifas de intercambio y transferencia.

Webhook Configurado

Configura webhooks para recibir notificaciones de liquidación. Dependiendo de la acción, recibirás eventos swap.success/swap.failed, gateway.success/gateway.failed, o withdraw.success/withdraw.failed. Consulta Webhooks para detalles.

Cómo Funciona

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 (%). Usa `-1` para deslizamiento ilimitado	5 o -1
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	(Opcional) Dirección específica para recibir los activos convertidos. Si no se proporciona, se aplica lógica de respaldo inteligente	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

Ilimitado: -1 (sin límite de deslizamiento - comportamiento predeterminado)
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)

Establecer slippageTolerance en -1 significa tolerancia de deslizamiento ilimitada. Este es el comportamiento predeterminado si no se especifica, permitiendo que las liquidaciones se ejecuten independientemente de la desviación del precio.

Dirección de Destino (Opcional)

El campo destination.address ahora es opcional. Cuando no se proporciona, el sistema usa lógica de respaldo inteligente para determinar la dirección del destinatario:

Escenario	Comportamiento de Respaldo
Dirección explícita proporcionada	Usa la dirección especificada
Liquidación en la misma cadena	Usa la dirección de depósito (dirección de origen)
Entre cadenas EVM-a-EVM	Usa la misma dirección en la cadena de destino
Entre cadenas (destino no-EVM)	Usa la dirección de billetera principal de la cadena de destino

Para la mayoría de los casos de uso, puedes omitir la dirección de destino y dejar que el sistema enrute automáticamente los fondos a la dirección apropiada basándose en el tipo de liquidación.

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

Cómo se Aplican las Reglas

Concepto Clave: Las reglas creadas en una billetera principal se aplican automáticamente a todas las direcciones hijas bajo esa billetera. Sin embargo, si creas reglas directamente en una dirección hija, esas reglas anularán completamente las reglas de la billetera principal para esa dirección específica.

Nivel de Regla	Alcance	Comportamiento
Reglas de Billetera Principal	Se aplican a la billetera principal Y todas las direcciones hijas	Reglas predeterminadas para toda la jerarquía de la billetera
Reglas de Dirección Hija	Se aplican solo a esa dirección específica	Anulan completamente las reglas de la billetera principal cuando están presentes

Orden de Aplicación de Reglas

Verificar Reglas de Dirección Hija: Si la dirección receptora tiene sus propias reglas, usar esas exclusivamente
Recurrir a Reglas de Billetera Principal: Si no existen reglas de dirección hija, aplicar reglas de billetera principal
Sin Reglas: Si ningún nivel tiene reglas configuradas, no ocurre liquidación automática

Cuando una dirección hija tiene sus propias reglas, las reglas de la billetera principal son completamente ignoradas para esa dirección—no hay fusión ni combinación de reglas.

Reglas Específicas por Blockchain

Importante: Las reglas están aisladas y vinculadas a cada blockchain. Una regla configurada para un blockchain (ej. Ethereum) NO afectará los depósitos en otro blockchain (ej. Base u Optimism).

Esto significa:

Debes crear reglas separadas para cada blockchain de origen que quieras liquidar automáticamente
Una regla para “USDC en Ethereum” no se activará para “USDC en Base”
Esto permite control granular sobre el comportamiento de liquidación por cadena

Ejemplo: Si quieres liquidar automáticamente depósitos de USDC tanto de Ethereum como de Base hacia Optimism, necesitas dos reglas separadas:

Regla para Ethereum USDC → Optimism USDC
Regla para Base USDC → Optimism USDC

Casos de Uso para Cada Nivel

Reglas de Billetera Principal

Estrategia Consistente: Mismo comportamiento de liquidación en todas las direcciones hijas
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": "-1",
    "source": {
        "assets": [
            "USDC",
            "USDT"
        ],
        "minAmount": "1",
        "maxAmount": "1000"
    },
    "destination": {
        "blockchain": "optimism",
        "asset": "USDC"
    }
}'

En este ejemplo, slippageTolerance está establecido en -1 para deslizamiento ilimitado, y destination.address está omitido. El sistema usará automáticamente la lógica de respaldo inteligente para determinar la dirección del destinatario.

Con dirección de destino explícita:

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"
    }
  }
}

Identificar Transacciones de Liquidación Automática

La mejor manera de identificar transacciones de liquidación automática es verificando el campo metadata. Dependiendo de la acción, el metadata contendrá una de estas claves:

Clave de Metadata	Descripción
`swapAutoSettlement`	Presente cuando la liquidación automática activó una operación de swap
`gatewayAutoSettlement`	Presente cuando la liquidación automática activó una operación de Gateway
`withdrawAutoSettlement`	Presente cuando la liquidación automática activó una operación de retiro

Cada objeto de metadata contiene:

Campo	Descripción
`rule`	Payload completo de la regla de liquidación automática que activó esta transacción
`settleAmount`	Monto que fue liquidado según la regla

Cuando cualquiera de estas claves de metadata (swapAutoSettlement, gatewayAutoSettlement o withdrawAutoSettlement) está presente, la transacción fue activada 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`	string	No	Deslizamiento máximo aceptable (%). Usa `-1` para ilimitado (predeterminado)
`isGateway`	boolean	No	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. Usa `-1` para sin mínimo
`source.maxAmount`	string	No	Monto máximo por liquidación. Usa `-1` para ilimitado
`destination.blockchain`	string	Sí	Red blockchain objetivo
`destination.asset`	string	Sí	Activo objetivo para conversión
`destination.address`	string	No	Dirección de destino. Si se omite, usa lógica de respaldo inteligente (ver arriba)

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

​Requisitos Previos

​Cómo Funciona

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

​Dirección de Destino (Opcional)

​Preferencias de Ejecución

​Jerarquía y Precedencia de Reglas

​Cómo se Aplican las Reglas

​Orden de Aplicación de Reglas

​Reglas Específicas por Blockchain

​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

​Identificar Transacciones de Liquidación Automática

​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

Requisitos Previos

Cómo Funciona

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

Dirección de Destino (Opcional)

Preferencias de Ejecución

Jerarquía y Precedencia de Reglas

Cómo se Aplican las Reglas

Orden de Aplicación de Reglas

Reglas Específicas por Blockchain

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

Identificar Transacciones de Liquidación Automática

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