API de Liquidaciones Automáticas - Blockradar

La API de Liquidaciones Automáticas te permite definir reglas que convierten automáticamente los activos entrantes y los enrutan a una billetera de destino. Úsala para eliminar operaciones de tesorería manuales y asegurar que los fondos siempre se mantengan en tu activo preferido.

Qué puedes hacer

Habilitar o deshabilitar la liquidación automática en una billetera o dirección
Crear, actualizar y eliminar reglas de liquidación
Definir objetivos de conversión, billeteras de destino y umbrales de activación por regla
Elegir un flujo de liquidación por regla: withdraw, swap, gateway o earn
Limitar una regla de la billetera maestra a direcciones secundarias concretas en lugar de a todas
Copiar un conjunto de reglas a otras billeteras maestras en una sola llamada

Tipos de liquidación

Cada regla se resuelve en uno de cuatro flujos. Defínelo explícitamente con type; las reglas guardadas antes de que existiera este campo conservan su comportamiento inferido.

Tipo	Qué hace la regla
`withdraw`	Transfiere el activo de origen tal cual a `destination.address` en la misma blockchain
`swap`	Convierte a un activo distinto o traslada a otra blockchain
`gateway`	Deposita USDC en el saldo unificado de Gateway de Circle (`isGateway: true`)
`earn`	Deposita en una posición de Earn con Fija o Aave (`isReward: true`, solo mainnet)

Endpoints

Method	Endpoint	Description
`GET`	`/wallets/{walletId}/auto-settlements`	Obtener configuración de liquidación automática (billetera maestra)
`PATCH`	`/wallets/{walletId}/auto-settlements`	Actualizar configuración de liquidación automática
`GET`	`/wallets/{walletId}/auto-settlements/rules`	Listar todas las reglas
`GET`	`/wallets/{walletId}/auto-settlements/rules/{ruleId}`	Obtener una regla individual
`POST`	`/wallets/{walletId}/auto-settlements/rules`	Crear una regla
`POST`	`/wallets/{walletId}/auto-settlements/rules/copy`	Copiar reglas a otras billeteras maestras
`PATCH`	`/wallets/{walletId}/auto-settlements/rules/{ruleId}`	Actualizar una regla
`DELETE`	`/wallets/{walletId}/auto-settlements/rules/{ruleId}`	Eliminar una regla
`GET`	`/wallets/{walletId}/addresses/{addressId}/auto-settlements`	Obtener configuración (dirección secundaria)
`PATCH`	`/wallets/{walletId}/addresses/{addressId}/auto-settlements`	Actualizar configuración (dirección secundaria)
`GET`	`/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules`	Listar reglas (dirección secundaria)
`POST`	`/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules`	Crear regla (dirección secundaria)
`PATCH`	`/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{ruleId}`	Actualizar regla (dirección secundaria)
`DELETE`	`/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{ruleId}`	Eliminar regla (dirección secundaria)

Referencia completa de la API

Consulta todos los endpoints de liquidaciones automáticas en la pestaña de Referencia de la API.