
En resumen
La API de Swap de Blockradar te permite intercambiar activos en la misma cadena (swap) o mover activos entre diferentes cadenas (bridge) usando un solo endpoint unificado.
La API de Swap de Blockradar te permite intercambiar activos en la misma cadena (swap) o mover activos entre diferentes cadenas (bridge) usando un solo endpoint unificado.
Prerrequisitos
Antes de usar la API de Swap, asegúrate de tener:1
Clave API
Obtén tu clave API desde el Panel de Blockradar. Navega a Configuración → Claves API para generar una.
2
Wallet Creado
Crea un wallet a través de la API Crear Wallet o el panel. Necesitarás el
walletId para las operaciones de swap.3
IDs de Activos
Obtén el
assetId para tus activos de origen y destino desde Activos en el panel o a través de la API Obtener Activos.4
Saldo Suficiente
Asegúrate de que tu wallet tenga suficiente saldo del activo de origen para cubrir el monto del swap más las comisiones de red.
Cómo Funciona
Blockradar determina automáticamente si tu transacción es un swap o un bridge basándose en tu selección de activos:Swap
Intercambia diferentes activos en la misma blockchain.Ejemplo: USDC → USDT en Base
Bridge
Mueve activos entre diferentes blockchains.Ejemplo: USDC en BSC → USDC en Optimism
Activos y Cadenas Soportados
La API de Swap soporta las principales stablecoins en las cadenas soportadas por Blockradar:| Stablecoin | Descripción |
|---|---|
| USDT | Tether USD |
| USDC | USD Coin |
| DAI | Dai Stablecoin |
| BUSD | Binance USD |
| cNGN | Stablecoin Naira |
| EURC | Euro Coin |
| IDRX | Stablecoin Indonesio |
Consulta Integraciones para la lista completa de redes y stablecoins soportadas.
Master Wallet vs Dirección Hija
La API de Swap está disponible en dos niveles:Master Wallet
Ejecuta swaps directamente desde tu master wallet. Ideal para operaciones de tesorería.
Dirección Hija
Ejecuta swaps desde direcciones hijas individuales. Perfecto para operaciones específicas de usuario.
Endpoints
| Operación | Master Wallet | Dirección Hija |
|---|---|---|
| Obtener Cotización | POST /v1/wallets/{walletId}/swaps/quote | POST /v1/wallets/{walletId}/addresses/{addressId}/swaps/quote |
| Ejecutar | POST /v1/wallets/{walletId}/swaps/execute | POST /v1/wallets/{walletId}/addresses/{addressId}/swaps/execute |
Paso 1: Obtener una Cotización
Siempre obtén una cotización antes de ejecutar un swap para mostrar a los usuarios el resultado esperado.Parámetros de Solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
fromAssetId | string | Sí | El ID del activo desde el cual intercambiar |
toAssetId | string | Sí | El ID del activo al cual intercambiar |
amount | string | Sí | El monto a intercambiar |
order | string | No | Preferencia de cotización: FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE |
recipientAddress | string | No | Dirección de wallet externa (para enviar a wallets que no son de Blockradar) |
Ejemplo de Cotización
Respuesta de Cotización
Entendiendo los Campos de Cotización
| Campo | Descripción |
|---|---|
amount | Monto estimado que recibirás después del swap |
minAmount | Monto mínimo garantizado (considerando el deslizamiento) |
rate | Tasa de cambio efectiva (montoDestino / montoOrigen) |
impact | Porcentaje de impacto en el precio |
slippage | Porcentaje máximo permitido de movimiento de precio |
networkFee | Comisión de gas en unidades del token nativo |
networkFeeInUSD | Comisión de gas convertida a USD |
estimatedArrivalTime | Tiempo estimado de finalización en segundos |
Paso 2: Ejecutar el Swap
Una vez que el usuario confirma la cotización, ejecuta el swap.Parámetros de Solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
fromAssetId | string | Sí | El ID del activo desde el cual intercambiar |
toAssetId | string | Sí | El ID del activo al cual intercambiar |
amount | string | Sí | El monto a intercambiar |
order | string | No | Preferencia de cotización: FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE |
recipientAddress | string | No | Dirección de wallet externa (para enviar a wallets que no son de Blockradar) |
reference | string | No | Tu ID de seguimiento interno |
metadata | object | No | Datos personalizados pasados a través de webhooks |
Ejemplo de Ejecución
Respuesta de Ejecución
Tipos de Orden
Elige el tipo de orden correcto según tu caso de uso:| Tipo de Orden | Descripción | Mejor Para |
|---|---|---|
FASTEST | Prioriza velocidad sobre costo | Transacciones sensibles al tiempo |
CHEAPEST | Minimiza comisiones | Operaciones sensibles al costo |
RECOMMENDED | Enfoque equilibrado (por defecto) | La mayoría de casos de uso |
NO_SLIPPAGE | Monto exacto o falla | Requisitos de monto preciso |
Eventos de Webhook
Monitorea la finalización del swap a través de webhooks:| Evento | Descripción |
|---|---|
swap.success | Swap completado exitosamente |
swap.failed | Swap fallido |
Payload del Webhook
Ejemplo de Flujo Completo
Aquí hay una implementación completa mostrando el flujo cotización → confirmar → ejecutar:Respuestas de Error
Saldo Insuficiente
Saldo Insuficiente
ID de Activo Inválido
ID de Activo Inválido
Ruta de Swap No Disponible
Ruta de Swap No Disponible
Monto Muy Bajo
Monto Muy Bajo
Deslizamiento Excedido
Deslizamiento Excedido
Mejores Prácticas
Experiencia de Usuario
- Siempre muestra cotizaciones: Muestra monto, comisiones y tiempo estimado antes de ejecutar
- Maneja el deslizamiento: Informa a los usuarios sobre posibles variaciones de precio
- Muestra el progreso: Usa webhooks para actualizar a los usuarios sobre el estado del swap
Seguridad
- Valida montos: Asegúrate de que los montos de swap estén dentro de rangos aceptables
- Usa referencias: Rastrea swaps con IDs de referencia únicos
- Monitorea webhooks: Siempre verifica la finalización del swap a través de webhooks
Rendimiento
- Cachea IDs de activos: Almacena IDs de activos localmente para evitar búsquedas repetidas
- Usa tipos de orden apropiados: Elige
FASTESTpara tiempo sensible,CHEAPESTpara costo sensible - Implementa reintentos: Maneja fallas transitorias con retroceso exponencial
Referencia de API
| Endpoint | Descripción |
|---|---|
| Master Wallet Obtener Cotización | Obtener cotización de swap desde master wallet |
| Master Wallet Ejecutar | Ejecutar swap desde master wallet |
| Dirección Hija Obtener Cotización | Obtener cotización de swap desde dirección hija |
| Dirección Hija Ejecutar | Ejecutar swap desde dirección hija |
Soporte
- Email: [email protected]
- Documentación: Referencia de API
- Blog: Cómo Intercambiar o Puentear Activos con Blockradar
La API de Swap proporciona una interfaz unificada tanto para swaps en la misma cadena como para bridges entre cadenas. Comienza con pequeñas cantidades de prueba en testnets antes de pasar a producción.

