> ## Documentation Index > Fetch the complete documentation index at: https://docs.yiksipay.com/llms.txt > Use this file to discover all available pages before exploring further. # Liquidaciones Automáticas > Automatiza las liquidaciones y conversiones de activos a través de redes blockchain 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. Auto Settlements ## Requisitos Previos Antes de configurar reglas de liquidación automática, asegúrate de tener: Obtén tu clave API desde el [Panel de Yiksi Pay](https://dashboard.yiksipay.com). Navega a **Developers** para generar una. Crea una billetera principal a través de la [API de Crear Billetera](/es/api-reference/wallets/create-wallet) o el panel. Las reglas se configuran por billetera. Si liquidas entre cadenas, asegúrate de tener una billetera en la blockchain de destino para recibir los activos convertidos. Financia tus billeteras con tokens nativos (ETH, BNB, MATIC, etc.) para cubrir las tarifas de intercambio y transferencia. Configura webhooks para recibir notificaciones de liquidación. Dependiendo de la acción, recibirás eventos `swap.success`/`swap.failed`, o `withdraw.success`/`withdraw.failed`. Consulta [Webhooks](/es/essentials/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. Crea y gestiona reglas de liquidación automática para automatizar las conversiones de activos. Convierte automáticamente cualquier stablecoin a cualquier otro activo basándose en tus reglas. Liquida activos a cualquier red blockchain sin problemas. 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, Yiksi Pay 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 | ### **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** 1. **Verificar Reglas de Dirección Hija**: Si la dirección receptora tiene sus propias reglas, usar esas exclusivamente 2. **Recurrir a Reglas de Billetera Principal**: Si no existen reglas de dirección hija, aplicar reglas de billetera principal 3. **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: 1. Regla para Ethereum USDC → Optimism USDC 2. 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** 1. Navega a la sección de Liquidaciones Automáticas de tu billetera 2. Haz clic en "Crear Nueva Regla" 3. Configura los parámetros de la regla 4. Establece umbrales de monto y tolerancia al deslizamiento 5. Elige activos/cadenas de origen y destino 6. 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: ```bash theme={null} curl --request POST \ --url https://api.yiksipay.com/v1/wallets/{walletId}/auto-settlements/rules \ --header 'Content-Type: application/json' \ --header 'x-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:** ```bash theme={null} curl --request POST \ --url https://api.yiksipay.com/v1/wallets/{walletId}/auto-settlements/rules \ --header 'Content-Type: application/json' \ --header 'x-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** ```json theme={null} { "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 | | `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` 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](/es/api-reference/auto-settlements/master-wallet-get-rules) | | `/v1/wallets/{walletId}/auto-settlements/rules` | POST | Crear nueva regla de liquidación para billetera principal | [Crear Regla](/es/api-reference/auto-settlements/master-wallet-create-rule) | | `/v1/wallets/{walletId}/auto-settlements/rules/{id}` | GET | Obtener detalles específicos de regla de billetera principal | [Obtener Regla](/es/api-reference/auto-settlements/master-wallet-get-rule) | | `/v1/wallets/{walletId}/auto-settlements/rules/{id}` | PATCH | Actualizar regla existente de billetera principal | [Actualizar Regla](/es/api-reference/auto-settlements/master-wallet-update-rule) | | `/v1/wallets/{walletId}/auto-settlements/rules/{id}` | DELETE | Eliminar regla de liquidación de billetera principal | [Eliminar Regla](/es/api-reference/auto-settlements/master-wallet-delete-rule) | | `/v1/wallets/{walletId}/auto-settlements` | GET | Obtener historial de liquidación de billetera principal | [Obtener Liquidación](/es/api-reference/auto-settlements/master-wallet) | | `/v1/wallets/{walletId}/auto-settlements` | PATCH | Actualizar configuraciones de liquidación de billetera principal | [Actualizar Liquidación](/es/api-reference/auto-settlements/master-wallet-update) | #### **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](/es/api-reference/auto-settlements/child-address-get-rules) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules` | POST | Crear nueva regla de liquidación para dirección específica | [Crear Regla](/es/api-reference/auto-settlements/child-address-create-rule) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}` | GET | Obtener detalles específicos de regla de dirección | [Obtener Regla](/es/api-reference/auto-settlements/child-address-get-rule) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}` | PATCH | Actualizar regla existente de dirección | [Actualizar Regla](/es/api-reference/auto-settlements/child-address-update-rule) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}` | DELETE | Eliminar regla de liquidación de dirección | [Eliminar Regla](/es/api-reference/auto-settlements/child-address-delete-rule) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements` | GET | Obtener historial de liquidación de dirección | [Obtener Liquidación](/es/api-reference/auto-settlements/child-address) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements` | PATCH | Actualizar configuraciones de liquidación de dirección | [Actualizar Liquidación](/es/api-reference/auto-settlements/child-address-update) | ### **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) | | `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**: [partner@yiksi.com](mailto:partner@yiksi.com) * **Referencia de API**: [Reglas de Liquidación Automática](/es/api-reference/auto-settlements/master-wallet) 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.