Gestión de Activos

En resumen
La Gestión de Activos te permite configurar qué stablecoins están habilitadas en tu billetera principal. Agrega un nuevo token para empezar a aceptarlo, elimina uno para detenerlo, o actualiza su configuración. Tu billetera solo monitorea e indexa los activos que están explícitamente habilitados.

Requisitos Previos

Clave API

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

Billetera Creada

Necesitarás un walletId para gestionar activos. Crea uno en el dashboard (consulta Crear una billetera principal).

IDs de Activos

Obtén el assetId del token que quieres agregar desde Activos en el dashboard o mediante la API de Obtener Activos.

Cómo Funciona

Cuando creas una billetera principal, no rastrea automáticamente todos los stablecoins soportados — solo los que has habilitado explícitamente. Esto te da un control preciso sobre lo que tu billetera acepta e indexa. Agregar un activo le dice a Blockradar que comience a monitorear transacciones entrantes para ese token, incluirlo en consultas de saldo y disparar webhooks cuando lleguen depósitos. Eliminar un activo detiene todo eso.

Agregar un Activo

Habilita un nuevo stablecoin en tu billetera para empezar a aceptar depósitos y ejecutar retiros en ese token.

Eliminar un Activo

Deshabilita un token para dejar de monitorearlo. Los saldos existentes no se ven afectados — puedes volver a habilitarlo en cualquier momento.

Actualizar Configuración

Ajusta la configuración a nivel de activo como umbrales de barrido automático y transacciones sin gas.

Ver Activos Activos

Obtén todos los activos habilitados en tu billetera junto con sus IDs, símbolos y configuración.

Agregar un Activo

POST /v1/wallets/{walletId}/assets

const asset = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/assets`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': apiKey
    },
    body: JSON.stringify({
      assetId: 'asset_usdc_base_mainnet'
    })
  }
).then(r => r.json());

console.log('Asset added:', asset.data);

Una vez agregado, Blockradar comenzará de inmediato a monitorear este token en tu billetera.

Ver Activos Activos

Obtén la lista de todos los activos habilitados actualmente en tu billetera, útil para recuperar los IDs de activos específicos de la billetera que se usan en intercambios, retiros y otras operaciones.

GET /v1/wallets/{walletId}/assets

Usa siempre los IDs de activos devueltos por este endpoint al llamar a otras APIs. Estos son IDs de activos específicos de la billetera, no globales, y son necesarios para intercambios, retiros y consultas de saldo.

Eliminar un Activo

Deshabilitar un activo hace que Blockradar deje de monitorear nuevos depósitos de ese token. No afecta los saldos existentes ni el historial de transacciones.

DELETE /v1/wallets/{walletId}/assets/{assetId}

Eliminar un activo significa que los depósitos entrantes de ese token ya no serán detectados ni indexados. Asegúrate de haber migrado cualquier saldo existente antes de eliminar un activo que planeas dejar de usar.

Actualizar la Configuración de un Activo

Puedes actualizar la configuración a nivel de activo, como los umbrales de barrido y la configuración sin gas.

PATCH /v1/wallets/{walletId}/assets/{assetId}

Mejores Prácticas

Habilita solo lo que necesitas — una lista de activos enfocada mantiene tu billetera limpia, reduce el ruido en los webhooks y hace que las consultas de saldo sean más rápidas.
Obtén siempre los IDs de activos de tu billetera — usa GET /v1/wallets/{walletId}/assets para obtener los IDs de activos correctos, específicos de la billetera, antes de ejecutar intercambios o retiros.
Prueba en testnet primero — habilita y configura activos en testnet antes de replicar la configuración en mainnet.

Referencia de API

Endpoint	Descripción
Obtener Activos	Listar todos los activos activos en una billetera
Agregar Activo	Habilitar un nuevo token en tu billetera
Eliminar Activo	Deshabilitar un token
Actualizar Activo	Actualizar configuración a nivel de activo

Comenzar

Billeteras

Recibir Pagos

Enviar Pagos

Convertir y Gestionar

Cumplimiento y Recuperación

Integraciones

Requisitos Previos

Cómo Funciona

Agregar un Activo

Eliminar un Activo

Actualizar Configuración

Ver Activos Activos

Agregar un Activo

Ver Activos Activos

Eliminar un Activo

Actualizar la Configuración de un Activo

Mejores Prácticas

Referencia de API

​Requisitos Previos

​Cómo Funciona

Agregar un Activo

Eliminar un Activo

Actualizar Configuración

Ver Activos Activos

​Agregar un Activo

​Ver Activos Activos

​Eliminar un Activo

​Actualizar la Configuración de un Activo

​Mejores Prácticas

​Referencia de API

Requisitos Previos

Cómo Funciona

Agregar un Activo

Ver Activos Activos

Eliminar un Activo

Actualizar la Configuración de un Activo

Mejores Prácticas

Referencia de API