Saltar al contenido principal

​
Depósitos y Webhooks

Esto suele ser un retraso temporal de indexación. Usa el Buscador de Depósitos para activar la indexación manualmente:
  • Panel: Ve a tu Billetera Principal → Resumen → Haz clic en “Buscador de Depósitos”
  • 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 de la red blockchain, retrasos temporales de indexación de nodos, o errores en tu endpoint de webhook.Para revisar los registros de webhooks:
  • Panel: Billetera Principal → Desarrolladores → Registros de Webhooks
  • API: GET /v1/wallets/{walletId}/webhooks

​
Barrido Automático

Por defecto, disableAutoSweep está en false, lo que significa que el barrido automático está activado. Cuando llega un depósito a una dirección secundaria, se barre automáticamente a tu billetera principal.Para mantener los fondos en direcciones secundarias:
  • Establece disableAutoSweep: true al crear la dirección mediante API
  • O activa Deshabilitar Barrido Automático en la configuración de la dirección en el panel
Verifica ambos niveles de configuración. La configuración a nivel de dirección siempre tiene prioridad.
  • Nivel de billetera principal — establece el valor predeterminado para todas las direcciones
  • Nivel de dirección — anula la configuración de la billetera principal
Verifica que la dirección específica tenga disableAutoSweep: true.
Sí. Puedes configurar umbrales de barrido para que los fondos solo se barran automáticamente una vez que se alcance cierto saldo.Configuración de Billetera →

​
Tarifas de Gas y Costos de Red

Las tarifas de gas se pagan directamente a la blockchain en el token nativo:
CadenaToken Nativo
Ethereum / Base / Polygon / etc.ETH
TronTRX
SolanaSOL
Blockradar no cobra tarifas adicionales sobre los costos de red.
Las tarifas de red de Tron son típicamente de $1–6 por transacción debido a cómo Tron gestiona 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 garantizar que las transacciones tengan éxito incluso durante alta congestión. Solo se te cobra la tarifa de red real, que suele ser menor que la estimación.
No, las tarifas de gas de blockchain deben pagarse en el token nativo de la cadena. Sin embargo, puedes habilitar retiros sin gas para que tu billetera principal patrocine el gas para las transacciones de direcciones secundarias.

​
Transacciones Sin Gas

Cuando el modo sin gas está habilitado, la billetera principal paga las tarifas de gas en nombre de los retiros de direcciones secundarias.Para habilitar:
  • Nivel de billetera principal: Panel → Configuración de Billetera Principal → Habilitar Transacciones Sin Gas
  • Nivel de dirección: Establece enableGaslessWithdraw: true al crear o actualizar una dirección
Transacciones Sin Gas → · Parámetros de Dirección →
Depende de la configuración enableGaslessWithdraw:
  • Habilitado (true): La billetera principal paga el gas
  • Deshabilitado (false, predeterminado): La dirección secundaria necesita su propio gas

​
Intercambios y Puentes

Blockradar admite únicamente intercambios de stablecoin a stablecoin: USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX.Los intercambios de tokens nativos (por ejemplo, USDT → TRX, USDC → ETH) no son compatibles.
Esto suele significar que el par de intercambio no es compatible, o que el monto es demasiado pequeño o grande para la liquidez disponible.
Este error generalmente significa que estás usando el ID de activo incorrecto. Debes usar el ID de activo específico de la billetera, no un ID de activo general.
  • Panel: Ve a tu billetera → Activos → Copia el ID del activo desde allí
  • API: Usa los IDs de activos devueltos por el endpoint de detalles de tu billetera
Sí. Puedes intercambiar y transferir activos entre diferentes blockchains mediante el panel o la API. Para intercambios entre cadenas vía API, pasa el ID de activo de la billetera principal de destino como toAssetId.Documentación de Intercambio →

​
Configuración de Billetera

  • Cadenas EVM (Ethereum, Base, Polygon, Arbitrum, Optimism, etc.): 1 billetera cubre todas
  • Tron (TRC20): Se requiere billetera separada
  • Solana: Se requiere billetera separada
No. Las direcciones no pueden eliminarse debido a las limitaciones de blockchain. Solo puedes desactivarlas en el panel. Las direcciones desactivadas no recibirán nuevos depósitos ni serán monitoreadas.
Usa el parámetro showPrivateKey: true al obtener los detalles de la billetera o dirección mediante API.
Usa esto únicamente en entornos seguros y de confianza.

​
Retiros y Transferencias

Usa el endpoint de retiro: POST /v1/wallets/{walletId}/addresses/{addressId}/withdrawDocumentación de Retiros →
Causas comunes:
  • Gas insuficiente en la billetera principal (si usas sin gas) o en la dirección secundaria
  • Cola de procesamiento — las transacciones se procesan secuencialmente debido a los nonces de blockchain
  • Problemas de nodo — retrasos temporales
Si está bloqueada por más de 30 minutos, contacta a soporte con el ID de transacción.
Todos los movimientos de fondos en cadena usan el endpoint de retiro. No existe un endpoint de “transferencia” separado.
  • Principal a secundaria: POST /v1/wallets/{walletId}/withdraw con la dirección secundaria como destino
  • Secundaria a principal: POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw con la dirección de la billetera principal 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 Recuperación de Activos en el panel. Actualmente disponible solo para billeteras principales.Recuperación de Activos →
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. Sin embargo, los fondos siguen en tu billetera y pueden verse en el explorador de blockchain o retirarse mediante API o panel.

​
Testnet vs. Mainnet

No, tus fondos no están perdidos. Las direcciones están vinculadas criptográficamente. Puedes recuperar fondos usando Recuperación de Activos.Recuperación de Activos →
Siempre verifica el indicador de entorno en el panel (muestra “Testnet” o “Live”) antes de realizar transacciones.
  1. Usa el selector de entorno en tu panel (generalmente arriba a la derecha o en la configuración de billetera)
  2. Cambia de Testnet a Live
  3. Crea una nueva billetera principal para mainnet
  4. Actualiza tus claves API — las claves de testnet no funcionarán en mainnet
Las direcciones de testnet no pueden recibir fondos de mainnet y viceversa.
CadenaFaucet
Ethereum (Sepolia)Sepolia Faucet
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:
  • ID de billetera incorrecto
  • Clave API incorrecta (no coincide con la billetera)
  • Uso de un ID de activo general en lugar de un ID específico de la billetera
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 billetera. Verifica que:
  • La clave API sea correcta (sin espacios adicionales)
  • La clave API pertenezca a esta billetera
  • No estés usando una clave de testnet en mainnet (o viceversa)
  • La clave API no haya sido rotada o regenerada
El recurso no existe o estás usando el ID incorrecto. Causas comunes: ID de billetera o dirección incorrecto, uso de ID de activo general en lugar de uno específico de la billetera, o error tipográfico en la URL del endpoint.

​
Cuentas Virtuales y cNGN

Las Cuentas Virtuales permiten a tus usuarios depositar NGN (Naira nigeriana), que se convierte automáticamente en stablecoins en cadena.Requisitos:
  • Debe estar en modo mainnet/Live (no testnet)
  • Debe 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 a la Naira nigeriana. Blockradar admite 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 mediante transferencia bancaria
  3. Los fondos se convierten automáticamente en stablecoins y aparecen en cadena
Documentación de Cuentas Virtuales →
Actualmente, las Cuentas Virtuales solo admiten NGN. Para otras monedas, necesitarías integrar proveedores externos de rampas fiat.

​
Solicitudes de Funciones

No. Blockradar se enfoca en stablecoins. Bitcoin no está actualmente disponible.
Blockradar es agnóstico en cuanto a blockchains y stablecoins — se pueden integrar redes y activos adicionales bajo solicitud. Contáctanos para discutir tus requisitos.

​
Facturación y Suscripciones

Sí. Puedes pagar mediante el enlace de pago enviado a tu correo, o retirando desde tu billetera principal a la dirección del enlace de pago.
Actualmente, solo admitimos pagos con stablecoins para suscripciones.

​
Blockchains y Activos Compatibles

Ethereum, BNB Chain, Polygon, Tron, Base, Arbitrum, Optimism, Solana, Celo, Lisk, Avalanche, Asset Chain, Plasma.Blockradar es agnóstico en cuanto a blockchains y stablecoins — se pueden integrar redes adicionales bajo solicitud.
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX. Se pueden integrar activos adicionales bajo solicitud.

​
Consejos para Desarrolladores

  • ID de billetera: Identifica tu billetera principal
  • ID de dirección: Identifica una dirección secundaria específica dentro de una billetera
  • ID de activo: Identifica un activo específico (USDT, USDC, etc.) dentro de tu billetera
Siempre usa el ID de activo específico de la billetera desde la lista de activos de tu billetera, no un ID de activo general.
  • Usa siempre el modo mainnet/Live para transacciones reales
  • Almacena los IDs de billetera y dirección 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 perdidas
  • Monitorea el saldo de la billetera principal para gas (tokens nativos)
  • Habilita retiros sin gas si tus usuarios no deben necesitar tokens nativos

​
¿Necesitas Ayuda?

Documentación

docs.blockradar.co

Panel

dashboard.blockradar.co

Reservar una Llamada de Soporte

Agenda aquí