> ## 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.

# Visión General

> Mantente actualizado con los últimos cambios en nuestras APIs.

### Próximos cambios

Estamos trabajando en nuevas funcionalidades emocionantes que mejorarán tu experiencia. Mientras continuamos desarrollando estas actualizaciones, ¡puedes seguir construyendo!

<Note>
  Recomendamos revisar regularmente este registro de cambios para las últimas actualizaciones y planificar tus ciclos de desarrollo en consecuencia. Tus comentarios son invaluables para nosotros, así que siéntete libre de compartir cualquier sugerencia o problema que encuentres.
</Note>

# Actualizaciones del producto

> Nuevos lanzamientos y mejoras

<Update label="31 de enero de 2026" tags={["Mejoras", "Actualizaciones de Activos"]} rss={{ title: "Actualizaciones de Direcciones de Contrato cNGN", description: "Nuevas direcciones de contrato cNGN actualizadas en 5 redes con nuevo despliegue v3" }}>
  ## Actualizaciones de Direcciones de Contrato cNGN

  El equipo de cNGN ha desplegado nuevas direcciones de contrato en 5 redes. Las direcciones anteriores ahora están etiquetadas como "Old v2" y serán eliminadas gradualmente.

  ### Qué Cambió

  * **Nuevo despliegue de cNGN**: Direcciones de contrato actualizadas para cNGN en Ethereum, BNB Chain, Base, Asset Chain y Arc
  * **Direcciones anteriores reetiquetadas**: Las direcciones existentes ahora están marcadas como "Old v2" en el panel de control
  * **Soporte de nueva red**: cNGN ahora está disponible en la red Arc

  ### Lo que necesitas hacer

  * Ve a tu panel de control y agrega los nuevos activos cNGN (busca los que no tienen la etiqueta "Old")
  * Actualiza tus integraciones para usar las nuevas direcciones de contrato
  * Las direcciones anteriores seguirán funcionando durante el período de transición

  ### Nuevas Direcciones de Contrato

  | Red         | Nueva Dirección de Contrato cNGN             |
  | ----------- | -------------------------------------------- |
  | Ethereum    | `0xF55E56423e6b50808fD07cB62b6A32B91903f50E` |
  | BNB Chain   | `0x8a078b182bA9649c03982c2a80CDcc81cdc99dA8` |
  | Base        | `0xEFdF04BAfE0ebabb5F5cD9e3f36564f51CFe1530` |
  | Asset Chain | `0x00F0a33d9AFaC108A4963D4Cb4Ef6A9C6B8D8859` |
  | Arc         | `0x1716Df6A18DcFF031BFD209aDB8035174AdC0D31` |

  ### Tokens cNGN de Prueba

  ¿Necesitas cNGN de prueba para tu integración en sandbox (testnet)? Usa el [cNGN Faucet](https://cngn.co/faucet) oficial para obtener tokens de prueba.

  Para más información sobre el proyecto de stablecoin cNGN, visita el [repositorio oficial](https://github.com/wrappedcbdc/stablecoin-cngn).
</Update>

<Update label="22 de enero de 2026" tags={["Cambio Importante", "Cuentas Virtuales"]} rss={{ title: "Cambios Importantes en la API de Cuentas Virtuales", description: "Los endpoints de cuentas virtuales ahora devuelven múltiples registros con soporte de paginación" }}>
  ## Cambios Importantes en la API de Cuentas Virtuales

  <Warning>
    **Cambio Importante**: Esta actualización ya está activa. Las integraciones existentes que usan la API de Cuentas Virtuales deben actualizar al nuevo formato de respuesta.
  </Warning>

  ### Por Qué Este Cambio

  Anteriormente, cada billetera o dirección solo podía tener una cuenta virtual. Hemos escuchado de empresas que necesitan múltiples cuentas virtuales por billetera—por ejemplo, para asignar cuentas separadas a diferentes clientes o casos de uso. Esta actualización habilita esa flexibilidad mientras mantiene compatibilidad hacia atrás para recuperar cuentas individuales.

  ### Qué Cambió

  | Endpoint                                                         | Comportamiento Anterior  | Nuevo Comportamiento       |
  | ---------------------------------------------------------------- | ------------------------ | -------------------------- |
  | `GET /wallets/{walletId}/virtual-accounts`                       | Devolvía un objeto único | Devuelve un array paginado |
  | `GET /wallets/{walletId}/addresses/{addressId}/virtual-accounts` | Devolvía un objeto único | Devuelve un array paginado |

  ### Nuevos Endpoints

  Para recuperar una cuenta virtual específica (equivalente a la respuesta de objeto único anterior), usa estos nuevos endpoints:

  | Endpoint                                                                                         | Descripción                                                     |
  | ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- |
  | `GET /wallets/{walletId}/virtual-accounts/{virtualAccountId}`                                    | Obtener una cuenta virtual específica                           |
  | `GET /wallets/{walletId}/virtual-accounts/{virtualAccountId}/transactions`                       | Obtener transacciones de una cuenta virtual                     |
  | `POST /wallets/{walletId}/virtual-accounts/{virtualAccountId}/regenerate`                        | Regenerar una cuenta virtual                                    |
  | `GET /wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}`              | Obtener una cuenta virtual específica de dirección secundaria   |
  | `GET /wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}/transactions` | Obtener transacciones de cuenta virtual de dirección secundaria |
  | `POST /wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}/regenerate`  | Regenerar una cuenta virtual de dirección secundaria            |

  ### Detalles de Paginación

  Todos los endpoints de lista ahora soportan paginación con estos parámetros:

  | Parámetro | Tipo    | Por Defecto | Máximo | Descripción                    |
  | --------- | ------- | ----------- | ------ | ------------------------------ |
  | `page`    | integer | `1`         | —      | Número de página a recuperar   |
  | `limit`   | integer | `10`        | `100`  | Número de registros por página |

  ### Nuevas Funcionalidades

  * **Etiquetas de cuentas virtuales**: Agrega etiquetas personalizadas para organizar cuentas (ej., "Cliente A", "Nómina")
  * **Regeneración de cuentas**: Genera nuevos números de cuenta con seguimiento de razón para auditoría
  * **Historial de transacciones**: Consulta transacciones vinculadas a cuentas virtuales específicas

  ### Guía de Migración

  **Antes** — Respuesta de objeto único:

  ```javascript theme={null}
  const response = await fetch(`/wallets/${walletId}/virtual-accounts`);
  const account = await response.json();

  console.log(account.accountNumber);
  console.log(account.bankName);
  ```

  **Después** — Respuesta de array paginado:

  ```javascript theme={null}
  const response = await fetch(`/wallets/${walletId}/virtual-accounts`);
  const { data, meta } = await response.json();

  // Manejar caso de array vacío
  if (data.length === 0) {
    console.log('No se encontraron cuentas virtuales');
    return;
  }

  // Obtener la primera cuenta (equivalente al comportamiento anterior)
  const account = data[0];
  console.log(account.accountNumber);
  console.log(account.bankName);

  // O iterar a través de todas las cuentas
  for (const account of data) {
    console.log(account.accountNumber);
  }

  // Información de paginación disponible en meta
  console.log(`Página ${meta.currentPage} de ${meta.totalPages}`);
  ```

  **Para obtener una cuenta específica por ID** (recomendado):

  ```javascript theme={null}
  const response = await fetch(`/wallets/${walletId}/virtual-accounts/${virtualAccountId}`);

  if (!response.ok) {
    console.log('Cuenta virtual no encontrada');
    return;
  }

  const { data } = await response.json();
  console.log(data.accountNumber);
  ```

  ### Ejemplo de Respuesta de API

  **Endpoint de lista** `GET /wallets/{walletId}/virtual-accounts`:

  ```json theme={null}
  {
    "message": "Virtual accounts retrieved successfully",
    "statusCode": 200,
    "data": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "accountNumber": "8012345678",
        "accountName": "Blockradar/John Doe",
        "bankName": "Wema Bank",
        "bankCode": "035",
        "isActive": true,
        "type": "AUTO_FUNDING",
        "label": "Customer Deposits",
        "createdAt": "2026-01-22T10:30:00.000Z",
        "updatedAt": "2026-01-22T10:30:00.000Z"
      }
    ],
    "meta": {
      "itemCount": 1,
      "totalItems": 1,
      "itemsPerPage": 10,
      "totalPages": 1,
      "currentPage": 1
    }
  }
  ```

  **Endpoint de cuenta única** `GET /wallets/{walletId}/virtual-accounts/{virtualAccountId}`:

  ```json theme={null}
  {
    "message": "Virtual account retrieved successfully",
    "statusCode": 200,
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "accountNumber": "8012345678",
      "accountName": "Blockradar/John Doe",
      "bankName": "Wema Bank",
      "bankCode": "035",
      "isActive": true,
      "type": "AUTO_FUNDING",
      "label": "Customer Deposits",
      "createdAt": "2026-01-22T10:30:00.000Z",
      "updatedAt": "2026-01-22T10:30:00.000Z"
    }
  }
  ```

  ### ¿Necesitas Ayuda?

  * **Documentación**: [Guía de Cuentas Virtuales](/es/essentials/virtual-accounts)
  * **Referencia de API**: [Endpoints de Cuentas Virtuales](/es/api-reference/virtual-accounts/master-wallet-get-all)
  * **Soporte por email**: [support@blockradar.co](mailto:support@blockradar.co)
</Update>

<Update label="7 de noviembre de 2025" tags={["Nueva Funcionalidad", "Cuentas Virtuales"]} rss={{ title: "API de Cuentas Virtuales", description: "Nueva API para administrar cuentas bancarias virtuales con conversión automática de fiat a stablecoin" }}>
  ## API de Cuentas Virtuales

  * **Nueva funcionalidad**: La API de Cuentas Virtuales permite a las empresas crear y administrar cuentas bancarias virtuales vinculadas a billeteras maestras o direcciones secundarias
  * **Conversión de fiat a stablecoin**: Los clientes pueden recibir pagos en NGN a través de transferencias bancarias tradicionales, convertidos automáticamente a stablecoins cNGN
  * **Soporte de financiamiento automático**: Las cuentas de tipo AUTO\_FUNDING automáticamente acuñan cNGN cuando se reciben pagos en fiat y se transfieren a billeteras vinculadas
  * **Integración de billetera maestra**: Crea cuentas virtuales directamente vinculadas a billeteras maestras
  * **Integración de dirección secundaria**: Crea cuentas virtuales vinculadas a direcciones secundarias específicas para un control granular
  * **Gestión de cuentas**: Activa o desactiva cuentas virtuales para controlar el comportamiento de financiamiento automático

  ### Lo que necesitas hacer

  * **Habilitar la funcionalidad**: Contacta a [support@blockradar.co](mailto:support@blockradar.co) para habilitar las cuentas virtuales para tu negocio
  * **Asegurar soporte de cNGN**: Asegúrate de que tu billetera maestra soporte el activo stablecoin cNGN
  * **Solo mainnet**: Ten en cuenta que las cuentas virtuales solo están disponibles en el entorno MAINNET
  * **Revisar los endpoints de la API**: Consulta la [documentación de la API de Cuentas Virtuales](/es/essentials/virtual-accounts) para detalles de implementación

  ## Endpoints de la API

  A continuación se muestran los endpoints principales de la API para operaciones de Cuentas Virtuales:

  ### **Endpoints de Billetera Maestra**

  * [POST /wallets/{walletId}/virtual-accounts](/es/api-reference/virtual-accounts/master-wallet-create) – Crear una cuenta virtual para una billetera maestra
  * [GET /wallets/{walletId}/virtual-accounts](/es/api-reference/virtual-accounts/master-wallet-get) – Recuperar detalles de cuenta virtual
  * [PATCH /wallets/{walletId}/virtual-accounts/{id}](/es/api-reference/virtual-accounts/master-wallet-update) – Actualizar estado de cuenta virtual

  ### **Endpoints de Dirección Secundaria**

  * [POST /wallets/{walletId}/addresses/{addressId}/virtual-accounts](/es/api-reference/virtual-accounts/child-address-create) – Crear una cuenta virtual para una dirección secundaria
  * [GET /wallets/{walletId}/addresses/{addressId}/virtual-accounts](/es/api-reference/virtual-accounts/child-address-get) – Recuperar detalles de cuenta virtual
  * [PATCH /wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}](/es/api-reference/virtual-accounts/child-address-update) – Actualizar estado de cuenta virtual

  ### Características Clave

  * **Moneda soportada**: NGN (Naira Nigeriana) para pagos en fiat, cNGN para conversión a stablecoin
  * **Flujo de financiamiento automático**: Acuñación y transferencia automática de cNGN cuando se reciben pagos (tipo AUTO\_FUNDING)
  * **Activación de cuenta**: Controla el comportamiento de financiamiento automático activando o desactivando cuentas
  * **Gestión de clientes**: Crea cuentas con información del cliente (nombre, apellido, correo electrónico, teléfono)

  Para más información, consulta la [documentación de Cuentas Virtuales](/es/essentials/virtual-accounts) y [Referencia de la API](/es/api-reference/virtual-accounts).
</Update>

<Update label="20 de octubre de 2025" tags={["Mejoras", "Actualizaciones de Activos"]} rss={{ title: "Actualizaciones de Direcciones cNGN", description: "Direcciones de testnet actualizadas y soporte de USDT de Tron" }}>
  ## Actualizaciones de Direcciones cNGN en Testnet

  * **Direcciones de testnet cNGN actualizadas**: El equipo de cNGN ha actualizado sus direcciones de testnet en múltiples redes
  * **Nuevo soporte de activos**: Se agregó soporte para el stablecoin cNGN actualizado en el panel de control
  * **Gestión de activos**: Las direcciones de testnet anteriores ahora están etiquetadas como "antiguas" y se eliminarán en 30 días
  * **Soporte de USDT de Tron**: Se agregó dirección actualizada de USDT de Tron soportada con la dirección anterior etiquetada como "antigua"

  ### Lo que necesitas hacer

  * Ve a tu panel de control y agrega los nuevos activos cNGN (busca los que no tienen la etiqueta "antiguo")
  * Actualiza tus integraciones para usar las nuevas direcciones de testnet
  * Las direcciones de testnet antiguas se eliminarán automáticamente después de 30 días
  * **Nota**: Estos cambios solo se aplican a entornos de testnet - las direcciones de mainnet permanecen sin cambios

  ### Direcciones de Testnet Actualizadas

  | Red        | Nueva Dirección de Contrato cNGN           |
  | ---------- | ------------------------------------------ |
  | ASSETCHAIN | 0x4c00E85cd0B0307D8ED0b5534Bc678776C4aa7D3 |
  | BASE       | 0x929A08903C22440182646Bb450a67178Be402f7f |
  | BNBCHAIN   | 0x20354A3Ad3B67836ab9c6D7D82cF5e5Ddfe104dD |
  | ETHEREUM   | 0xd076ceCB8af5D92F7f6F32bDf24Da708859593d3 |
  | POLYGON    | 0xf24B1Cee8cA70341FcefBCa10e7e4Db9A4896486 |
  | LISK       | 0x999E3A32eF3F9EAbF133186512b5F29fADB8a816 |

  ### Dirección de USDT de Tron Actualizada

  | Red  | Nueva Dirección de Contrato USDT de Tron |
  | ---- | ---------------------------------------- |
  | TRON | TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf       |

  Para más información sobre el proyecto de stablecoin cNGN, visita el [repositorio oficial](https://github.com/wrappedcbdc/stablecoin-cngn).
</Update>