Saltar al contenido principal

​
Depósitos y Webhooks

Esto suele ser un retraso temporal en la indexación. Usa el Buscador de Depósitos para activar la indexación manualmente:
  • Panel de control: Ve a tu Master Wallet → Resumen → Haz clic en “Deposit Finder”
  • API: POST /v1/wallets/{walletId}/rescan/blocks con el transactionHash
Documentación del Buscador de Depósitos →
Los retrasos en webhooks pueden ocurrir por congestión en la red blockchain, retrasos temporales en la indexación de nodos o porque tu endpoint de webhook está devolviendo errores.Para revisar los registros de webhooks:
  • Panel de control: Master Wallet → Developers → Webhook Logs
  • API: GET /v1/wallets/{walletId}/webhooks
Blockradar solo indexa stablecoins por diseño. Los depósitos de tokens nativos (ETH, TRX, SOL, etc.) no aparecerán en el historial de transacciones del panel de control. Sin embargo, los fondos siguen en tu wallet y pueden verse en el explorador de blockchain o retirarse vía API o panel de control.

​
Auto-Sweep

Por defecto, disableAutoSweep está configurado en false, lo que significa que el auto-sweep está habilitado. Cuando un depósito llega a una dirección secundaria, se transfiere automáticamente a tu master wallet.Para mantener los fondos en las direcciones secundarias:
  • Configura disableAutoSweep: true al crear la dirección vía API
  • O activa Disable Auto Sweep en la configuración de la dirección en el panel de control
Verifica ambos niveles de configuración:
  • Nivel de master wallet — establece el valor por defecto para todas las direcciones
  • Nivel de dirección — anula la configuración de la master wallet
La configuración a nivel de dirección siempre tiene prioridad. Verifica que la dirección específica tenga disableAutoSweep: true.
Sí. Puedes configurar umbrales de barrido para que los fondos solo se transfieran automáticamente una vez que se alcance un cierto saldo.Configuración de Wallet →

​
Comisiones de Gas y Costos de Red

Las comisiones de gas se pagan directamente a la blockchain en el token nativo:
CadenaToken Nativo
Ethereum / Base / Polygon / etc.ETH
TronTRX
SolanaSOL
Blockradar no cobra comisiones adicionales sobre los costos de red.
Las comisiones de la red Tron son típicamente de $1–6 por transacción debido a cómo Tron maneja el ancho de banda y la energía. Este es un costo a nivel de blockchain, no un cargo de Blockradar.Alternativas de menor costo:
  • Solana: ~$0.01–0.30 por transacción
  • Base: ~$0.01–0.10 por transacción
  • Polygon: ~$0.01–0.10 por transacción
El endpoint /withdraw/network-fee devuelve una estimación conservadora para asegurar que las transacciones tengan éxito incluso durante alta congestión de red. Solo se te cobra la comisión de red real, que típicamente es menor que la estimación.
No, las comisiones de gas de blockchain deben pagarse en el token nativo de la cadena. Sin embargo, puedes habilitar retiros gasless para que tu master wallet patrocine el gas de las transacciones de direcciones secundarias.

​
Transacciones Gasless

Cuando gasless está habilitado, la master wallet paga las comisiones de gas en nombre de los retiros de las direcciones secundarias.Para habilitarlo:
  • Nivel de master wallet: Panel de control → Configuración de Master Wallet → Habilitar Transacciones Gasless
  • Nivel de dirección: Configura enableGaslessWithdraw: true al crear o actualizar una dirección
También puedes establecer umbrales para que solo se cubran los retiros por encima o por debajo de ciertos montos.Transacciones Gasless → · Parámetros de Dirección →
Depende de la configuración enableGaslessWithdraw:
  • Habilitado (true): La master wallet paga el gas
  • Deshabilitado (false, por defecto): La dirección secundaria necesita su propio gas

​
Swaps y Puentes

Blockradar soporta solo swaps de stablecoin a stablecoin: USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, JPYC.Los swaps de tokens nativos y el bridging están disponibles en todas las cadenas soportadas excepto Tron.
Esto generalmente significa que el par de swap no está soportado (ej. intercambiar a un token nativo), o el monto es demasiado pequeño o demasiado grande para la liquidez disponible.
Este error generalmente significa que estás usando el asset ID incorrecto. Necesitas usar el asset ID específico de la wallet, no un asset ID general.Para encontrar el ID correcto:
  • Panel de control: Ve a tu wallet → Assets → Copia el asset ID desde ahí
  • API: Usa los asset IDs devueltos por el endpoint de detalles de tu wallet
Sí. Puedes intercambiar y puentear activos entre diferentes blockchains a través del panel de control o la API. Para swaps cross-chain vía API, pasa el asset ID de la master wallet de destino como el toAssetId.Documentación de Swap →

​
Configuración de Wallet

Blockradar permite solo una Master Wallet por red blockchain por cuenta. Para soportar una blockchain adicional, debes crear una Master Wallet separada para ella. Dentro de una sola Master Wallet, puedes crear tantas direcciones secundarias como necesites para segmentar fondos por usuario, aplicación o propósito. No se soporta la creación de múltiples Master Wallets para la misma blockchain.
No, las direcciones no pueden eliminarse debido a limitaciones de blockchain. Solo puedes desactivarlas en el panel de control. Las direcciones desactivadas no recibirán nuevos depósitos ni serán monitoreadas.
Usa el parámetro showPrivateKey: true al consultar los detalles de wallet o dirección vía API.
Solo usa esto en entornos seguros y de confianza.

​
Retiros y Transferencias

Usa el endpoint de retiro de la API: POST /v1/wallets/{walletId}/addresses/{addressId}/withdrawDocumentación de Retiros →
Causas comunes:
  • Gas insuficiente en la master wallet (si usas gasless) o dirección secundaria
  • Procesamiento de cola — las transacciones se procesan secuencialmente debido a los nonces de blockchain
  • Problemas de nodo — retrasos temporales
Si está atascada por más de 30 minutos, contacta a soporte con el ID de la transacción.
Todos los movimientos de fondos on-chain usan el endpoint de retiro. No hay un endpoint separado de “transferencia”.
  • Master a secundaria: POST /v1/wallets/{walletId}/withdraw con la dirección secundaria como destino
  • Secundaria a master: POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw con la dirección de la master wallet como destino
  • Secundaria a externa: Mismo endpoint, dirección externa como destino
Documentación de Retiros →
Usa el endpoint de transacciones con el parámetro de consulta de dirección:
    GET /v1/wallets/{walletId}/transactions?address={addressId}
Documentación de Transacciones →

​
Recuperación de Activos

Usa la Recuperación de Activos en el panel de control.Recuperación de Activos →

​
Testnet vs. Mainnet

No, tus fondos no se perdieron. Mainnet y testnet son redes separadas, pero las direcciones están vinculadas criptográficamente. Puedes recuperar fondos usando la Recuperación de Activos.Recuperación de Activos →
Siempre verifica el indicador de entorno en el panel de control (muestra “Test Mode” o “Live Mode”) antes de realizar transacciones.
  1. Usa el selector de entorno en tu panel de control (generalmente arriba a la derecha o en la configuración de wallet)
  2. Cambia de Testnet a Live
  3. Crea una nueva master wallet para mainnet
  4. Actualiza tus claves API — las claves de testnet no funcionan en mainnet
Las direcciones de testnet no pueden recibir fondos de mainnet y viceversa.
CadenaFaucet
Ethereum (Sepolia)Sepolia Faucet o Alchemy
BNB ChainBNB Testnet Faucet
Polygon (Amoy)Polygon Faucet
BaseAlchemy Faucet
Tron (Nile)Nile Testnet
SolanaSolana Faucet
Circle USDCCircle Faucet

​
Errores de API y Solución de Problemas

Causas comunes:
  • Wallet ID incorrecto
  • Clave API incorrecta (no coincide con la wallet)
  • Usar un asset ID general en lugar de un asset ID específico de la wallet
Generalmente es un problema temporal. Si persiste, contacta a soporte con el endpoint que estás llamando, la blockchain/red, y la respuesta de error completa.
Tu clave API es inválida o no coincide con la wallet a la que intentas acceder. Verifica que:
  • La clave API sea correcta (sin espacios extra)
  • La clave API pertenezca a esta wallet
  • No estés usando una clave de testnet en mainnet (o viceversa)
  • La clave API no haya sido rotada o regenerada
El recurso (wallet, dirección o activo) no existe o estás usando el ID incorrecto. Las causas comunes incluyen un wallet ID o address ID incorrecto, usar un asset ID general en lugar de uno específico de la wallet, o un error tipográfico en la URL del endpoint.

​
Cuentas Virtuales y cNGN

Las Cuentas Virtuales permiten a tus usuarios depositar NGN (Naira nigeriano), que se convierte automáticamente en stablecoins on-chain.Requisitos:
  • Debes estar en modo mainnet/Live (no testnet)
  • Debes completar la verificación KYB
Documentación de Cuentas Virtuales →
Las Cuentas Virtuales solo aparecen si estás en modo Live, tu cuenta ha completado la verificación KYB y la función ha sido habilitada para tu cuenta.
cNGN es una stablecoin vinculada al Naira nigeriano. Blockradar soporta transacciones e intercambios de cNGN con otras stablecoins.

​
Rampas de Entrada/Salida Fiat

Usa Cuentas Virtuales para NGN:
  1. Genera una Cuenta Virtual para el usuario
  2. El usuario deposita NGN vía transferencia bancaria o dinero móvil
  3. Los fondos se convierten automáticamente en stablecoins y aparecen on-chain
Documentación de Cuentas Virtuales →
Actualmente, las Cuentas Virtuales solo soportan NGN. Para otras monedas, necesitarás integrarte con proveedores de off-ramp fiat de terceros, esto te permitirá hacer off-ramp a KES, NGN, TZS, UGX, BRL y MWK. Consulta Retirar Fiat.

​
Solicitudes de Funcionalidades

No. Blockradar se enfoca en stablecoins. Bitcoin no está soportado actualmente.
Blockradar es agnóstico de blockchain y stablecoin — redes y activos adicionales pueden integrarse bajo solicitud. Contáctanos para discutir tus requerimientos.

​
Facturación y Suscripciones

Sí. Puedes pagar a través del enlace de pago enviado a tu correo, o retirar de tu master wallet a la dirección del enlace de pago.
Actualmente, solo soportamos pagos con stablecoins para suscripciones.

​
Blockchains y Activos Soportados

Ethereum, BNB Chain, Polygon, Tron, Base, Arbitrum, Optimism, Solana, Celo, Lisk, Avalanche, Asset Chain, Plasma, y Tempo.Blockradar es agnóstico de blockchain y stablecoin — redes adicionales pueden integrarse bajo solicitud.
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, JPYC.Activos adicionales pueden integrarse bajo solicitud.

​
Consejos para Desarrolladores

  • Wallet ID: Identifica tu master wallet
  • Address ID: Identifica una dirección secundaria específica dentro de una wallet
  • Asset ID: Identifica un activo específico (USDT, USDC, etc.) dentro de tu wallet
Siempre usa el asset ID específico de la wallet de tu lista de activos de wallet, no un asset ID general.
  • Siempre usa el modo mainnet/Live para transacciones reales
  • Almacena los wallet IDs y address IDs en tu base de datos
  • Implementa manejadores de webhooks para actualizaciones de transacciones en tiempo real
  • Usa el Buscador de Depósitos como respaldo para transacciones no detectadas
  • Monitorea el saldo de la master wallet para gas (tokens nativos)
  • Habilita retiros gasless si tus usuarios no deberían necesitar tokens nativos

​
¿Necesitas Ayuda?

Documentación

docs.blockradar.co

Panel de Control

dashboard.blockradar.co

Agendar una Llamada de Soporte

Agenda aquí