Liquidaciones Automáticas

En resumen
Las Liquidaciones Automáticas convierten automáticamente los depósitos entrantes al activo de su preferencia en cualquier blockchain. Defina las reglas una sola vez y todos los depósitos coincidentes se intercambian y enrutan a su cadena de destino, sin intervención manual.

Requisitos previos

Antes de configurar reglas de liquidación automática, asegúrese de contar con:

Clave de API

Obtenga su clave de API desde el Panel de Blockradar. Diríjase a Developers para generar una.

Master Wallet creada

Cree una master wallet mediante la API Create Wallet o desde el panel. Las reglas se configuran por wallet.

Wallet de destino

Si liquida entre cadenas, asegúrese de tener una wallet en la blockchain de destino para recibir los activos convertidos.

Gas suficiente

Financie sus wallets con tokens nativos (ETH, BNB, MATIC, etc.) para cubrir las comisiones de swap y transferencia.

Webhook configurado

Configure webhooks para recibir notificaciones de liquidación. Según la acción, recibirá los eventos swap.success/swap.failed, gateway.success/gateway.failed o withdraw.success/withdraw.failed. Consulte Webhooks para más detalles.

Cómo funciona

Las Liquidaciones Automáticas le permiten convertir automáticamente los depósitos entrantes en cualquier activo de destino sobre cualquier red blockchain según las reglas que configure. Esto elimina la necesidad de intercambiar o enviar activos entre cadenas manualmente, garantizando que su tesorería pueda convertirse de forma automática a sus activos preferidos en múltiples cadenas.

Gestión de reglas

Cree y administre reglas de liquidación automática para automatizar las conversiones de activos.

Conversión de activos

Convierta automáticamente cualquier stablecoin a otro activo según sus reglas.

Multicadena

Liquide activos en cualquier red blockchain de forma fluida.

Gestión de riesgos

Aplique tolerancia de slippage y reglas para protegerse de ejecuciones desfavorables.

Cómo funcionan las Liquidaciones Automáticas

1. Creación de reglas

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

2. Detección de depósitos

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

3. Conversión de activos

Los depósitos se intercambian automáticamente al activo de destino (normalmente USDC) en la cadena que elija.

4. Unificación de saldos

Todos los activos convertidos se consolidan en un único saldo unificado en su 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 de su regla de liquidación	”Swap from USDC to Optimism USDC”
Order	Preferencia de prioridad de ejecución	FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE
Tolerancia de slippage	Desviación de precio máxima aceptable (%). Use `-1` para slippage ilimitado	5 o -1
Activos de origen	Lista de activos a liquidar automáticamente	[“USDC”, “USDT”]
Monto mín./máx. de origen	Controle 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 de la 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 la lógica de fallback inteligente	0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22
Is Gateway	Habilita la funcionalidad de gateway para la regla	false

Opciones de configuración de la regla

Umbrales de monto

Monto mínimo: Solo liquidar depósitos por encima de este umbral
Monto máximo: Limitar el tamaño de cada liquidación individual
Procesamiento por lotes: Agrupar varios depósitos pequeños para mayor eficiencia

Protección frente a slippage

Ilimitado: -1 (sin límite de slippage, comportamiento por defecto)
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 slippage ilimitada. Este es el comportamiento por defecto si no se especifica, lo que permite que las liquidaciones se ejecuten independientemente de la desviación de precio.

Dirección de destino (Opcional)

El campo destination.address ahora es opcional. Cuando no se proporciona, el sistema utiliza una lógica de fallback inteligente para determinar la dirección destinataria:

Escenario	Comportamiento de fallback
Dirección explícita proporcionada	Utiliza la dirección especificada
Liquidación en la misma cadena	Utiliza la dirección de depósito (dirección de origen)
Cross-chain entre EVM	Utiliza la misma dirección en la cadena de destino
Cross-chain (destino no EVM)	Utiliza la dirección de la master wallet en la cadena de destino

Para la mayoría de casos de uso, puede omitir la dirección de destino y dejar que el sistema enrute automáticamente los fondos a la dirección adecuada según el tipo de liquidación.

Preferencias de ejecución

Fastest: Prioriza la velocidad sobre el costo
Cheapest: Optimiza para las comisiones más bajas
Recommended: Equilibra velocidad y costo con confiabilidad
No Slippage: Ejecutar solo cuando no haya desviación de precio

Jerarquía y precedencia de reglas

Cómo se aplican las reglas

Concepto clave: Las reglas creadas en una master wallet se aplican automáticamente a todas las child addresses bajo esa wallet. Sin embargo, si crea reglas directamente en una child address, esas reglas anularán por completo las reglas de la master wallet para esa dirección específica.

Nivel de regla	Alcance	Comportamiento
Reglas de Master Wallet	Se aplican a la master wallet Y a todas las child addresses	Reglas por defecto para toda la jerarquía de la wallet
Reglas de Child Address	Se aplican únicamente a esa dirección específica	Anulan por completo las reglas de la master wallet cuando están presentes

Orden de aplicación de las reglas

Comprobar reglas de Child Address: Si la dirección receptora tiene sus propias reglas, se utilizan exclusivamente esas
Recurrir a las reglas de la Master Wallet: Si no existen reglas de child address, se aplican las reglas de la master wallet
Sin reglas: Si ninguno de los niveles tiene reglas configuradas, no se realiza ninguna liquidación automática

Cuando una child address tiene sus propias reglas, las reglas de la master wallet se ignoran por completo 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 una blockchain (por ejemplo, Ethereum) NO afectará a depósitos en otra blockchain (por ejemplo, Base u Optimism).

Esto significa que:

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

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

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

Casos de uso para cada nivel

Reglas de Master Wallet

Estrategia consistente: Mismo comportamiento de liquidación en todas las child addresses
Gestión simplificada: Un único lugar para configurar el comportamiento por defecto
Operaciones masivas: Aplicar reglas a varias direcciones a la vez
Estandarización: Garantizar el cumplimiento y la consistencia

Reglas de Child Address

Pruebas: Probar diferentes estrategias de liquidación en direcciones específicas
Requisitos personalizados: Necesidades de liquidación específicas por dirección
Anular valores por defecto: Modificar el comportamiento para casos de uso particulares
Control granular: Ajustar con precisión la liquidación para direcciones específicas

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

Mediante el panel

Diríjase a la sección Auto Settlements de su wallet
Haga clic en “Create New Rule”
Configure los parámetros de la regla
Establezca los umbrales de monto y la tolerancia de slippage
Elija los activos/cadenas de origen y destino
Guarde y active la regla

Mediante la API

Cree reglas de liquidación de forma programática usando la API de Auto Settlement Rules:

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 from USDC to Optimism USDC",
    "order": "FASTEST",
    "slippageTolerance": "-1",
    "source": {
        "assets": [
            "USDC",
            "USDT"
        ],
        "minAmount": "1",
        "maxAmount": "1000"
    },
    "destination": {
        "blockchain": "optimism",
        "asset": "USDC"
    }
}'

En este ejemplo, slippageTolerance se establece en -1 para slippage ilimitado, y se omite destination.address. El sistema utilizará automáticamente la lógica de fallback inteligente para determinar la dirección destinataria.

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 from USDC to Optimism USDC",
    "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 cross-chain: Mantener saldos en múltiples redes
Consolidación automatizada: Sin intervención manual
Estrategia multiactivo: Compatible con diversas preferencias y estrategias de activos

Operaciones empresariales

Procesamiento de pagos: Liquidar automáticamente los pagos entrantes a los activos preferidos
Gestión de ingresos: Convertir varias stablecoins al activo de destino elegido
Mitigación de riesgos: Aplicar protección frente a slippage automáticamente
Diversificación de activos: Mantener asignaciones de activos objetivo automáticamente

Integración con DeFi

Yield farming: Liquidar automáticamente las recompensas al activo preferido
Gestión de liquidez: Consolidar recompensas y comisiones de LP
Reequilibrio de cartera: Mantener asignaciones objetivo de activos

Mejores prácticas

Configuración de reglas

Empiece de forma conservadora: Comience con baja tolerancia de slippage
Supervise el rendimiento: Realice un seguimiento de las tasas de éxito de las liquidaciones
Ajuste gradualmente: Afine las reglas según las condiciones del mercado
Pruebe en testnet: Valide las reglas antes del despliegue en mainnet

Gestión de riesgos

Límites de slippage: Establezca niveles de tolerancia adecuados
Topes de monto: Limite el tamaño máximo de las liquidaciones
Selección de red: Elija cadenas de destino confiables
Reglas de respaldo: Cree opciones de liquidación alternativas

Eficiencia operativa

Procesamiento por lotes: Agrupe depósitos pequeños para mayor eficiencia
Optimización temporal: Considere los patrones de congestión de la red
Análisis de costos: Equilibre las preferencias de velocidad vs. costo
Monitoreo: Configure alertas para liquidaciones fallidas

Monitoreo y alertas

Monitoreo desde el panel

Estado de las reglas: Indicadores de regla activa/inactiva
Historial de liquidaciones: Seguimiento de liquidaciones exitosas y fallidas
Métricas de rendimiento: Tasas de éxito y tiempos de ejecución
Saldos de activos: Supervisar el crecimiento del saldo unificado

Notificaciones por webhook

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

Evento	Descripción
`swap.success`	El swap de la liquidación automática se ejecutó correctamente
`swap.failed`	El swap de la liquidación automática no pudo 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 to USDC on 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"
    }
  }
}

Identificación de transacciones de liquidación automática

La mejor manera de identificar las transacciones de liquidación automática es revisando el campo metadata. Según 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 metadata contiene:

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

Cuando alguna 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 los datos del webhook

Campo	Descripción
`toAmount`	Monto final recibido tras el swap (considerando comisiones y slippage)
`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`	Wallet de destino que recibió los activos convertidos
`assetSwept`	Si los activos originales fueron barridos tras la conversión

Referencia de la API

Endpoints

Liquidaciones Automáticas de Master Wallet

Endpoint	Método	Descripción	Referencia de la API
`/v1/wallets/{walletId}/auto-settlements/rules`	GET	Listar todas las reglas de liquidación de la master wallet	Get All Rules
`/v1/wallets/{walletId}/auto-settlements/rules`	POST	Crear nueva regla de liquidación para la master wallet	Create Rule
`/v1/wallets/{walletId}/auto-settlements/rules/{id}`	GET	Obtener detalles de una regla específica de la master wallet	Get Rule
`/v1/wallets/{walletId}/auto-settlements/rules/{id}`	PATCH	Actualizar una regla existente de la master wallet	Update Rule
`/v1/wallets/{walletId}/auto-settlements/rules/{id}`	DELETE	Eliminar una regla de liquidación de la master wallet	Delete Rule
`/v1/wallets/{walletId}/auto-settlements`	GET	Obtener el historial de liquidaciones de la master wallet	Get Settlement
`/v1/wallets/{walletId}/auto-settlements`	PATCH	Actualizar la configuración de liquidación de la master wallet	Update Settlement

Liquidaciones Automáticas de Child Address

Endpoint	Método	Descripción	Referencia de la API
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules`	GET	Listar todas las reglas de liquidación para una dirección específica	Get All Rules
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules`	POST	Crear nueva regla de liquidación para una dirección específica	Create Rule
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	GET	Obtener detalles de la regla de una dirección específica	Get Rule
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	PATCH	Actualizar una regla de dirección existente	Update Rule
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	DELETE	Eliminar la regla de liquidación de la dirección	Delete Rule
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements`	GET	Obtener el historial de liquidaciones de la dirección	Get Settlement
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements`	PATCH	Actualizar la configuración de liquidación de la dirección	Update Settlement

Parámetros de la regla

Parámetro	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre de la regla para identificación
`order`	string	Sí	Prioridad de ejecución (FASTEST/CHEAPEST/RECOMMENDED/NO_SLIPPAGE)
`slippageTolerance`	string	No	Slippage máximo aceptable (%). Use `-1` para ilimitado (por defecto)
`isGateway`	boolean	No	Habilita la funcionalidad de gateway para la regla
`source.assets`	array	Sí	Lista de activos de origen a liquidar automáticamente
`source.minAmount`	string	No	Monto mínimo para activar la liquidación. Use `-1` para sin mínimo
`source.maxAmount`	string	No	Monto máximo por liquidación. Use `-1` para ilimitado
`destination.blockchain`	string	Sí	Red blockchain objetivo
`destination.asset`	string	Sí	Activo objetivo de la conversión
`destination.address`	string	No	Dirección de destino. Si se omite, se utiliza la lógica de fallback inteligente (ver arriba)

Primeros pasos

1. Active las Liquidaciones Automáticas

Diríjase a la configuración de su wallet
Habilite la funcionalidad de liquidación automática
Configure las preferencias por defecto

2. Cree su primera regla

Empiece con una regla sencilla de USDT a ETH (o cualquier activo que prefiera)
Establezca una tolerancia de slippage conservadora
Elija su cadena y activo de destino preferidos

3. Pruebe y monitoree

Despliegue primero en testnet
Supervise las tasas de éxito de las liquidaciones
Ajuste los parámetros según sea necesario

4. Escale gradualmente

Añada reglas para activos adicionales
Implemente procesamiento por lotes
Optimice para su caso de uso

Soporte y recursos

Cómo obtener ayuda

Correo electrónico: [email protected]
Referencia de la API: Auto Settlement Rules
Documentación: Configuración de Gateway

Las liquidaciones automáticas son una forma poderosa de automatizar la gestión de su tesorería. Comience con reglas sencillas y añada complejidad gradualmente a medida que se familiarice con el sistema.

​Requisitos previos

​Cómo funciona

Gestión de reglas

Conversión de activos

Multicadena

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 saldos

​Reglas de Liquidación Automática

​Componentes de la regla

​Opciones de configuración de la regla

​Umbrales de monto

​Protección frente a slippage

​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 las reglas

​Reglas específicas por blockchain

​Casos de uso para cada nivel

​Reglas de Master Wallet

​Reglas de Child Address

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

​Mediante el panel

​Mediante la API

​Casos de uso

​Gestión de tesorería

​Operaciones empresariales

​Integración con DeFi

​Mejores prácticas

​Configuración de reglas

​Gestión de riesgos

​Eficiencia operativa

​Monitoreo y alertas

​Monitoreo desde el panel

​Notificaciones por webhook

​Ejemplo de payload de webhook

​Identificación de transacciones de liquidación automática

​Campos clave de los datos del webhook

​Referencia de la API

​Endpoints

​Liquidaciones Automáticas de Master Wallet

​Liquidaciones Automáticas de Child Address

​Parámetros de la regla

​Primeros pasos

​1. Active las Liquidaciones Automáticas

​2. Cree su primera regla

​3. Pruebe y monitoree

​4. Escale gradualmente

​Soporte y recursos

​Cómo 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 saldos

Reglas de Liquidación Automática

Componentes de la regla

Opciones de configuración de la regla

Umbrales de monto

Protección frente a slippage

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 las reglas

Reglas específicas por blockchain

Casos de uso para cada nivel

Reglas de Master Wallet

Reglas de Child Address

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

Mediante el panel

Mediante la API

Casos de uso

Gestión de tesorería

Operaciones empresariales

Integración con DeFi

Mejores prácticas

Configuración de reglas

Gestión de riesgos

Eficiencia operativa

Monitoreo y alertas

Monitoreo desde el panel

Notificaciones por webhook

Ejemplo de payload de webhook

Identificación de transacciones de liquidación automática

Campos clave de los datos del webhook

Referencia de la API

Endpoints

Liquidaciones Automáticas de Master Wallet

Liquidaciones Automáticas de Child Address

Parámetros de la regla

Primeros pasos

1. Active las Liquidaciones Automáticas

2. Cree su primera regla

3. Pruebe y monitoree

4. Escale gradualmente

Soporte y recursos

Cómo obtener ayuda