Recuperación de Activos

En resumen
La API de Asset Recovery de Blockradar te permite recuperar activos que se enviaron por error a la dirección correcta en la blockchain equivocada. Admite la moneda nativa y activos personalizados (ERC-20 y estándares compatibles) en todas las redes soportadas.

¿Qué es la Recuperación de Activos?

La recuperación de activos te permite recuperar fondos que se enviaron a la dirección de billetera correcta pero en la red blockchain equivocada. Esto suele ocurrir cuando:

Los usuarios envían activos en Ethereum cuando querían enviarlos en Polygon
Los activos se envían en BNB Smart Chain en lugar de Arbitrum
Se produce cualquier confusión entre cadenas en la que la misma dirección existe en varias redes compatibles con EVM

Como las blockchains compatibles con EVM comparten el mismo formato de dirección, una misma dirección puede recibir activos en varias redes. La recuperación de activos te permite acceder a estos fondos de forma programática.

Para una guía detallada sobre los conceptos de recuperación de activos y el uso del panel, lee nuestro artículo del blog: How to Recover Assets Sent to the Wrong Blockchain

Requisitos previos

Antes de usar la API de Asset Recovery, asegúrate de tener:

Clave de API

Obtén tu clave de API en el Blockradar Dashboard. Ve a Developers para generar una.

Billetera creada

Crea una billetera en el panel (consulta Crear una Billetera Principal). Necesitarás el walletId para las operaciones de recuperación.

ID de blockchain

Obtén el blockchainId de la red donde están atascados los activos. Puedes encontrarlo en el panel o mediante la Get Blockchains API.

Saldo de moneda nativa

Asegúrate de que la dirección de origen tenga suficiente moneda nativa (ETH, BNB, MATIC, etc.) en la blockchain de recuperación para cubrir las comisiones de gas.

Cómo funciona

La API de Asset Recovery transfiere activos desde una dirección de origen (donde están atascados los activos) a una dirección de destino en la misma blockchain:

Recuperación de moneda nativa

Recupera moneda nativa como ETH, BNB, MATIC o AVAX enviada a la red equivocada.

Recuperación de activos personalizados

Recupera activos ERC-20 y compatibles indicando la dirección del contrato.

Estimación de comisiones

Calcula las comisiones de red antes de la ejecución para garantizar un saldo suficiente.

Soporte de RPC personalizado

Recupera activos en blockchains no soportadas indicando tu propio endpoint RPC.

Blockchains soportadas

La recuperación de activos está disponible en todas las blockchains soportadas por Blockradar, incluidas las redes compatibles con EVM, Tron y Solana. Consulta Blockchains Soportadas para ver la lista completa de redes soportadas y los enlaces a faucets.

Para las redes EVM sin soporte directo, puedes indicar una URL de RPC personalizada y, opcionalmente, activar el modo de capa 2 para redes basadas en rollups.

Empieza con testnets durante el desarrollo para no gastar fondos reales.

Recuperar activos

Inicia una operación de recuperación de activos para transferir los activos atascados a una dirección de destino.

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción
`senderAddress`	string	Sí	La dirección de Blockradar donde están atascados los activos actualmente.
`recipientAddress`	string	Sí	La dirección de destino a la que se enviarán los activos recuperados.
`amount`	string	Sí	El importe a recuperar. Usa el importe completo o una parte.
`blockchainId`	string (UUID)	Sí	El UUID de la blockchain donde se realizará la recuperación. Obtenlo con la Get Blockchains API.
`tokenAddress`	string	No	Dirección del contrato para recuperar un activo personalizado. Omítelo para la moneda nativa.
`crossNetwork`	boolean	No	Establécelo en `true` para recuperar activos enviados al entorno de red equivocado (por ejemplo, activos de mainnet en una dirección derivada en testnet). El valor predeterminado es `false`.
`rpcUrl`	string	No	Endpoint RPC personalizado para blockchains no soportadas. No se puede usar con `crossNetwork`.
`isL2`	boolean	No	Establécelo en `true` si la URL de RPC apunta a una red de capa 2.

Recuperación de moneda nativa

Recupera moneda nativa (ETH, BNB, MATIC, etc.) desde la red equivocada:

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/salvage \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "amount": "0.5",
    "blockchainId": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa"
  }'

const response = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      senderAddress: '0x1234567890abcdef1234567890abcdef12345678',
      recipientAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
      amount: '0.5',
      blockchainId: 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa'
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '0.5',
        'blockchainId': 'polygon-mainnet'
    }
)

print(response.json())

Recuperación de activos personalizados

Recupera activos ERC-20 o compatibles indicando la dirección del contrato:

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/salvage \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "amount": "100",
    "blockchainId": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
    "tokenAddress": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"
  }'

const response = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      senderAddress: '0x1234567890abcdef1234567890abcdef12345678',
      recipientAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
      amount: '100',
      blockchainId: 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa',
      tokenAddress: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '100',
        'blockchainId': 'polygon-mainnet',
        'tokenAddress': '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
    }
)

print(response.json())

Recuperación con RPC personalizado

Recupera activos en blockchains no soportadas indicando tu propio endpoint RPC:

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/salvage \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "amount": "0.5",
    "blockchainId": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
    "rpcUrl": "https://rpc.custom-network.io",
    "isL2": true
  }'

const response = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      senderAddress: '0x1234567890abcdef1234567890abcdef12345678',
      recipientAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
      amount: '0.5',
      blockchainId: 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa',
      rpcUrl: 'https://rpc.custom-network.io',
      isL2: true
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '0.5',
        'blockchainId': 'custom',
        'rpcUrl': 'https://rpc.custom-network.io',
        'isL2': True
    }
)

print(response.json())

Recuperación entre redes

Recupera activos que se enviaron por error en mainnet a una dirección derivada en testnet, o viceversa. Esto funciona porque las direcciones de EVM, Tron y Solana se derivan de las mismas claves independientemente del entorno de red.

La recuperación entre redes requiere blockchainId y no se puede usar con rpcUrl. La blockchain debe coincidir con la blockchain de la billetera: no puedes cambiar de cadena y de entorno de red a la vez.

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/salvage \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "amount": "100",
    "blockchainId": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
    "tokenAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "crossNetwork": true
  }'

const response = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      senderAddress: '0x1234567890abcdef1234567890abcdef12345678',
      recipientAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
      amount: '100',
      blockchainId: 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa',
      tokenAddress: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
      crossNetwork: true
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '100',
        'blockchainId': 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa',
        'tokenAddress': '0xdAC17F958D2ee523a2206206994597C13D831ec7',
        'crossNetwork': True
    }
)

print(response.json())

Cuando crossNetwork está activado, los metadatos de la transacción incluyen los campos crossNetwork: true y keyDerivationNetwork con fines de auditoría.

Respuesta correcta

{
  "message": "Salvage asset initiated successfully",
  "statusCode": 200
}

Estimación de comisiones de red

Antes de ejecutar una recuperación, estima las comisiones de red para asegurarte de tener saldo suficiente.

Solicitud de estimación de comisiones

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/salvage/network-fee \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "amount": "0.5",
    "blockchainId": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa"
  }'

const response = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/salvage/network-fee',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      senderAddress: '0x1234567890abcdef1234567890abcdef12345678',
      recipientAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
      amount: '0.5',
      blockchainId: 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa'
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.blockradar.co/v1/wallets/{walletId}/salvage/network-fee',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '0.5',
        'blockchainId': 'polygon-mainnet'
    }
)

print(response.json())

Parámetros de la respuesta de comisiones

Parámetro	Descripción
`networkFee`	Comisión de gas estimada en unidades de la moneda nativa
`networkFeeInUSD`	Comisión de gas convertida a USD
`nativeBalance`	Saldo actual de moneda nativa de la dirección de origen
`nativeBalanceInUSD`	Saldo nativo convertido a USD

Estima siempre las comisiones antes de ejecutar operaciones de recuperación. La dirección de origen debe tener suficiente moneda nativa para cubrir las comisiones de gas en la blockchain de recuperación.

Webhooks

Suscríbete a los eventos de webhook para recibir notificaciones en tiempo real sobre las operaciones de recuperación.

Eventos de recuperación

Evento	Descripción
`salvage.success`	Se activa cuando una operación de recuperación se completa correctamente.
`salvage.failed`	Se activa cuando una operación de recuperación falla por fondos insuficientes, problemas de red u otros errores.
`salvage.cancelled`	Se activa cuando una operación de recuperación se cancela antes de completarse.

Payload del webhook

{
  "event": "salvage.success",
  "data": {
    "id": "txn_abc123",
    "type": "SALVAGE",
    "status": "SUCCESS",
    "amount": "0.5",
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "blockchain": "polygon-mainnet",
    "txHash": "0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba",
    "networkFee": "0.001",
    "createdAt": "2025-01-12T10:30:00Z"
  }
}

Configura los webhooks en el Blockradar Dashboard en Settings → Webhooks. Consulta la documentación de Webhooks para ver las instrucciones de configuración.

Casos de uso comunes

Un usuario envió USDC en la red equivocada

Un usuario quería enviar USDC en Ethereum pero por error lo envió en Polygon. Como la dirección es la misma, los fondos llegaron a Polygon. Usa la recuperación de activos con la dirección del contrato de USDC en Polygon para recuperar los fondos.

ETH enviado a Arbitrum en lugar de Ethereum

Un usuario transfirió ETH a Arbitrum mediante un puente, pero lo envió a una dirección de Blockradar. La misma dirección existe en Arbitrum gracias a la compatibilidad con EVM. Recupera el ETH desde Arbitrum con la recuperación de moneda nativa.

Activo personalizado en una capa 2

Un usuario envió un activo ERC-20 personalizado en una red L2 como Optimism. Indica la dirección del contrato del activo y usa la API de recuperación para recuperarlo.

Activos en una red no soportada

Los activos están atascados en una blockchain que Blockradar no soporta directamente. Indica tu propio endpoint RPC y establece isL2: true si es un rollup para recuperar los fondos.

Activos de mainnet enviados a una dirección derivada en testnet

Un usuario envió USDT de mainnet a una dirección creada en testnet. Como la misma clave privada deriva la misma dirección en ambas redes, usa la recuperación entre redes con crossNetwork: true para recuperar los fondos de mainnet con las claves de la billetera de testnet.

Manejo de errores

Saldo nativo insuficiente

{
  "error": "Insufficient native balance for gas",
  "code": "INSUFFICIENT_GAS",
  "details": {
    "required": "0.01",
    "available": "0.001",
    "currency": "MATIC"
  }
}

Solución: Fondea la dirección de origen con suficiente moneda nativa para cubrir las comisiones de gas antes de volver a intentarlo.

Dirección de origen inválida

{
  "error": "Sender address not found in wallet",
  "code": "INVALID_SENDER"
}

Solución: Asegúrate de que la dirección de origen pertenezca a tu billetera de Blockradar y sea una dirección hija válida.

Activo no encontrado

{
  "error": "No balance found for specified asset",
  "code": "ASSET_NOT_FOUND",
  "details": {
    "tokenAddress": "0x...",
    "blockchain": "polygon-mainnet"
  }
}

Solución: Verifica la dirección del contrato y la blockchain. Usa un explorador de bloques para confirmar que el activo existe en la dirección de origen.

Fallo de conexión con el RPC

{
  "error": "Failed to connect to custom RPC",
  "code": "RPC_ERROR"
}

Solución: Verifica que tu URL de RPC sea correcta y accesible. Asegúrate de que admita los métodos JSON-RPC necesarios.

Mejores prácticas

Estima siempre las comisiones primero

Usa el endpoint de comisión de red antes de la recuperación para asegurar un saldo de gas suficiente y mostrar costos precisos.

Verifica las direcciones

Comprueba dos veces las direcciones de origen y de destino con un explorador de bloques antes de iniciar la recuperación.

Usa webhooks

Configura webhooks para recibir actualizaciones de estado en tiempo real en lugar de consultar la API periódicamente.

Prueba en testnet

Prueba tu integración de recuperación en testnet antes de usarla en producción.

Referencia de la API

Endpoint	Descripción
Salvage	Inicia una operación de recuperación de activos
Salvage Network Fee	Estima las comisiones de red de la recuperación

¡Feliz recuperación!

Comenzar

Billeteras

Recibir Pagos

Enviar Pagos

Convertir y Gestionar

Cumplimiento y Recuperación

Integraciones

Recuperación de Activos

¿Qué es la Recuperación de Activos?

Requisitos previos

Cómo funciona

Recuperación de moneda nativa

Recuperación de activos personalizados

Estimación de comisiones

Soporte de RPC personalizado

Blockchains soportadas

Recuperar activos

Parámetros de la solicitud

Recuperación de moneda nativa

Recuperación de activos personalizados

Recuperación con RPC personalizado

Recuperación entre redes

Respuesta correcta

Estimación de comisiones de red

Solicitud de estimación de comisiones

Parámetros de la respuesta de comisiones

Webhooks

Eventos de recuperación

Payload del webhook

Casos de uso comunes

Manejo de errores

Mejores prácticas

Estima siempre las comisiones primero

Verifica las direcciones

Usa webhooks

Prueba en testnet

Referencia de la API

​¿Qué es la Recuperación de Activos?

​Requisitos previos

​Cómo funciona

Recuperación de moneda nativa

Recuperación de activos personalizados

Estimación de comisiones

Soporte de RPC personalizado

​Blockchains soportadas

​Recuperar activos

​Parámetros de la solicitud

​Recuperación de moneda nativa

​Recuperación de activos personalizados

​Recuperación con RPC personalizado

​Recuperación entre redes

​Respuesta correcta

​Estimación de comisiones de red

​Solicitud de estimación de comisiones

​Parámetros de la respuesta de comisiones

​Webhooks

​Eventos de recuperación

​Payload del webhook

​Casos de uso comunes

​Manejo de errores

​Mejores prácticas

Estima siempre las comisiones primero

Verifica las direcciones

Usa webhooks

Prueba en testnet

​Referencia de la API

¿Qué es la Recuperación de Activos?

Requisitos previos

Cómo funciona

Blockchains soportadas

Recuperar activos

Parámetros de la solicitud

Recuperación de moneda nativa

Recuperación de activos personalizados

Recuperación con RPC personalizado

Recuperación entre redes

Respuesta correcta

Estimación de comisiones de red

Solicitud de estimación de comisiones

Parámetros de la respuesta de comisiones

Webhooks

Eventos de recuperación

Payload del webhook

Casos de uso comunes

Manejo de errores

Mejores prácticas

Referencia de la API