> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Preguntas Frecuentes

> Respuestas a las preguntas más comunes sobre Blockradar.

## Depósitos y Webhooks

<AccordionGroup>
  <Accordion title="Mi depósito no aparece en el panel de control">
    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 →](/es/essentials/wallets)
  </Accordion>

  <Accordion title="Los webhooks están retrasados o son inconsistentes">
    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`
  </Accordion>

  <Accordion title="Envié tokens nativos (ETH/TRX) — ¿por qué no aparecen?">
    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.
  </Accordion>
</AccordionGroup>

## Auto-Sweep

<AccordionGroup>
  <Accordion title="¿Por qué mis fondos se movieron automáticamente a la master wallet?">
    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
  </Accordion>

  <Accordion title="Desactivé el auto-sweep pero los fondos aún se movieron">
    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`.
  </Accordion>

  <Accordion title="¿Puedo establecer un umbral para el auto-sweep?">
    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 →](/es/essentials/wallets)
  </Accordion>
</AccordionGroup>

## Comisiones de Gas y Costos de Red

<AccordionGroup>
  <Accordion title="¿Cómo funcionan las comisiones de gas?">
    Las comisiones de gas se pagan directamente a la blockchain en el token nativo:

    | Cadena                           | Token Nativo |
    | -------------------------------- | ------------ |
    | Ethereum / Base / Polygon / etc. | ETH          |
    | Tron                             | TRX          |
    | Solana                           | SOL          |

    Blockradar no cobra comisiones adicionales sobre los costos de red.
  </Accordion>

  <Accordion title="¿Por qué las comisiones de Tron son más altas que las de otras cadenas?">
    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
  </Accordion>

  <Accordion title="La comisión de red estimada fue mayor que la comisión real cobrada">
    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.
  </Accordion>

  <Accordion title="¿Puedo pagar comisiones de gas en USDT/USDC en lugar de tokens nativos?">
    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.
  </Accordion>
</AccordionGroup>

## Transacciones Gasless

<AccordionGroup>
  <Accordion title="¿Cómo habilito los retiros 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 →](/es/essentials/withdrawals) · [Parámetros de Dirección →](/es/essentials/addresses)
  </Accordion>

  <Accordion title="¿Cuál wallet paga el gas — master o dirección secundaria?">
    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
  </Accordion>
</AccordionGroup>

## Swaps y Puentes

<AccordionGroup>
  <Accordion title="¿Qué swaps están soportados?">
    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.
  </Accordion>

  <Accordion title="Recibo el error 'No swap quotes available'">
    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.
  </Accordion>

  <Accordion title="Recibo el error 'Wallet not found or not active' en swap">
    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
  </Accordion>

  <Accordion title="¿Puedo hacer swaps cross-chain?">
    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 →](/es/essentials/swap)
  </Accordion>
</AccordionGroup>

## Configuración de Wallet

<AccordionGroup>
  <Accordion title="¿Puedo crear múltiples Master Wallets para una blockchain?">
    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.
  </Accordion>

  <Accordion title="¿Puedo eliminar direcciones?">
    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.
  </Accordion>

  <Accordion title="¿Cómo exporto las claves privadas?">
    Usa el parámetro `showPrivateKey: true` al consultar los detalles de wallet o dirección vía API.

    <Warning>Solo usa esto en entornos seguros y de confianza.</Warning>
  </Accordion>
</AccordionGroup>

## Retiros y Transferencias

<AccordionGroup>
  <Accordion title="¿Cómo retiro de una dirección secundaria a una wallet externa?">
    Usa el endpoint de retiro de la API: `POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw`

    [Documentación de Retiros →](/es/essentials/withdrawals)
  </Accordion>

  <Accordion title="Mi transacción está atascada en 'pending'">
    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.
  </Accordion>

  <Accordion title="¿Cómo muevo fondos entre la master wallet y las direcciones secundarias?">
    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 →](/es/essentials/withdrawals)
  </Accordion>

  <Accordion title="¿Cómo obtengo el historial de transacciones de una dirección secundaria específica?">
    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 →](/es/api-reference/transactions/get-transactions)
  </Accordion>
</AccordionGroup>

## Recuperación de Activos

<AccordionGroup>
  <Accordion title="Envié fondos a la cadena incorrecta o a un activo no soportado">
    Usa la Recuperación de Activos en el panel de control.

    [Recuperación de Activos →](/es/essentials/asset-recovery)
  </Accordion>
</AccordionGroup>

## Testnet vs. Mainnet

<AccordionGroup>
  <Accordion title="Envié fondos de mainnet a una dirección de testnet — ¿se perdieron mis fondos?">
    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 →](/es/essentials/asset-recovery)

    <Tip>Siempre verifica el indicador de entorno en el panel de control (muestra "Test Mode" o "Live Mode") antes de realizar transacciones.</Tip>
  </Accordion>

  <Accordion title="¿Cómo cambio de testnet a mainnet?">
    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

    <Warning>Las direcciones de testnet no pueden recibir fondos de mainnet y viceversa.</Warning>
  </Accordion>

  <Accordion title="¿Dónde puedo obtener tokens de testnet?">
    | Cadena             | Faucet                                                                             |
    | ------------------ | ---------------------------------------------------------------------------------- |
    | Ethereum (Sepolia) | [Sepolia Faucet](https://sepoliafaucet.com) o [Alchemy](https://sepoliafaucet.com) |
    | BNB Chain          | [BNB Testnet Faucet](https://testnet.bnbchain.org/faucet-smart)                    |
    | Polygon (Amoy)     | [Polygon Faucet](https://faucet.polygon.technology)                                |
    | Base               | [Alchemy Faucet](https://www.alchemy.com/faucets/base-sepolia)                     |
    | Tron (Nile)        | [Nile Testnet](https://nileex.io/join/getJoinPage)                                 |
    | Solana             | [Solana Faucet](https://faucet.solana.com)                                         |
    | Circle USDC        | [Circle Faucet](https://faucet.circle.com)                                         |
  </Accordion>
</AccordionGroup>

## Errores de API y Solución de Problemas

<AccordionGroup>
  <Accordion title="&#x22;Wallet not found or not active&#x22;">
    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
  </Accordion>

  <Accordion title="&#x22;Internal Server Error&#x22; / errores 500">
    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.
  </Accordion>

  <Accordion title="401 Unauthorized">
    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
  </Accordion>

  <Accordion title="404 Not Found">
    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.
  </Accordion>
</AccordionGroup>

## Cuentas Virtuales y cNGN

<AccordionGroup>
  <Accordion title="¿Cómo configuro Cuentas Virtuales para depósitos en NGN?">
    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 →](/es/essentials/virtual-accounts)
  </Accordion>

  <Accordion title="Las Cuentas Virtuales no aparecen en mi panel de control">
    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.
  </Accordion>

  <Accordion title="¿Qué es cNGN?">
    cNGN es una stablecoin vinculada al Naira nigeriano. Blockradar soporta transacciones e intercambios de cNGN con otras stablecoins.
  </Accordion>
</AccordionGroup>

## Rampas de Entrada/Salida Fiat

<AccordionGroup>
  <Accordion title="¿Cómo depositan fiat (NGN) los usuarios y reciben cripto?">
    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 →](/es/essentials/virtual-accounts)
  </Accordion>

  <Accordion title="¿Soportan otras monedas fiat además de NGN?">
    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](/es/use-cases/withdraw-fiat).
  </Accordion>
</AccordionGroup>

## Solicitudes de Funcionalidades

<AccordionGroup>
  <Accordion title="¿Soportan Bitcoin (BTC)?">
    No. Blockradar se enfoca en stablecoins. Bitcoin no está soportado actualmente.
  </Accordion>

  <Accordion title="¿Agregarán soporte para una nueva blockchain o token?">
    Blockradar es agnóstico de blockchain y stablecoin — redes y activos adicionales pueden integrarse bajo solicitud. [Contáctanos](mailto:info@blockradar.co) para discutir tus requerimientos.
  </Accordion>
</AccordionGroup>

## Facturación y Suscripciones

<AccordionGroup>
  <Accordion title="¿Puedo pagar mi suscripción con stablecoins?">
    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.
  </Accordion>

  <Accordion title="¿Puedo pagar con tarjeta de crédito?">
    Actualmente, solo soportamos pagos con stablecoins para suscripciones.
  </Accordion>
</AccordionGroup>

## Blockchains y Activos Soportados

<AccordionGroup>
  <Accordion title="¿Qué blockchains soporta Blockradar?">
    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.
  </Accordion>

  <Accordion title="¿Qué stablecoins soporta Blockradar?">
    USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, JPYC.

    Activos adicionales pueden integrarse bajo solicitud.
  </Accordion>
</AccordionGroup>

## Consejos para Desarrolladores

<AccordionGroup>
  <Accordion title="¿Cuál es la diferencia entre wallet ID, address ID y asset ID?">
    * **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

    <Warning>Siempre usa el asset ID específico de la wallet de tu lista de activos de wallet, no un asset ID general.</Warning>
  </Accordion>

  <Accordion title="Mejores prácticas para producción">
    * 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
  </Accordion>
</AccordionGroup>

## ¿Necesitas Ayuda?

<CardGroup cols={3}>
  <Card title="Documentación" icon="book" href="https://docs.blockradar.co">
    docs.blockradar.co
  </Card>

  <Card title="Panel de Control" icon="gauge" href="https://dashboard.blockradar.co">
    dashboard.blockradar.co
  </Card>

  <Card title="Agendar una Llamada de Soporte" icon="calendar" href="https://calendly.com/daniel-blockradar/blockradar-tech-support">
    Agenda aquí
  </Card>
</CardGroup>