Añadir intercambios a un producto EVM rara vez consiste solo en obtener una cotización para cambiar el token A por el token B.
Cuando una aplicación deja atrás la fase de simple prototipo, los desarrolladores también deben pensar en cómo se encuentran las rutas, cómo se preparan las transacciones, qué ocurre cuando aumenta el tráfico, qué redes se pueden admitir y qué costes acaban trasladándose a los usuarios.
Una API de agregador de DEX puede reducir parte de esa carga de infraestructura al conectar una aplicación con varias fuentes de liquidez mediante una sola integración. Pero, antes de elegir una, los desarrolladores suelen necesitar respuestas claras a tres preguntas:
¿Qué tan difícil es integrarla? ¿Cuánto cuesta? ¿Qué redes admite?
Esta guía analiza la API de KyberSwap Aggregator a partir de esas tres preguntas y luego aborda algunos factores adicionales que conviene tener en cuenta antes de usarla en producción.
¿Cómo funciona la integración con la API de KyberSwap Aggregator?
Para un desarrollador, la primera preocupación normalmente no es cuántas funciones tiene una API. Lo importante es cuánto trabajo de ingeniería hay entre la primera solicitud y tener un swap funcional dentro del producto.
La API de KyberSwap Aggregator está diseñada para gestionar la búsqueda de liquidez y el enrutamiento, y dejar que la aplicación controle su propia interfaz y flujo de ejecución.
En lugar de integrar DEX individuales y crear una lógica de enrutamiento independiente para cada plataforma, la aplicación puede enviar una solicitud de operación a KyberSwap. Aggregator busca la liquidez disponible y devuelve una ruta que luego puede usarse para construir la transacción de swap.
¿Cómo es el flujo básico de integración?
KyberSwap separa la búsqueda de rutas de la creación de transacciones.
Cuando un usuario selecciona un par de tokens y un importe para operar, la aplicación solicita primero una ruta. La respuesta incluye información como el importe de salida previsto, los detalles de la ruta, la estimación de gas y el contrato enrutador que se utilizará para la ejecución.
Cuando el usuario está listo para operar, la aplicación envía la ruta seleccionada al endpoint de creación junto con parámetros específicos de la transacción, como el emisor, el destinatario, la tolerancia al deslizamiento y la fecha límite.
KyberSwap devuelve entonces los datos de la transacción codificados que se necesitan para ejecutarla.
Para el desarrollador, el flujo es sencillo:
buscar la ruta → crear la transacción → permitir que el usuario la ejecute on-chain
Separar estas etapas permite que la aplicación controle mejor cuándo se busca una ruta y cuándo se prepara la transacción final. Esto es importante porque una ruta que se muestra al usuario puede quedar desactualizada mientras este revisa la operación o cambia el importe.
El resultado es un modelo de integración relativamente sencillo que no obliga a la aplicación a renunciar al control de su propia experiencia de trading.
¿Qué necesitan los desarrolladores para acceder a la API?
La configuración del acceso es importante porque determina la rapidez con la que un equipo puede empezar a hacer pruebas y la facilidad con la que la integración podrá ampliarse más adelante.
La documentación actual de KyberSwap indica a los integradores que usen el gateway de Swap API en:
https://api.kyberswap.com/swap/
Todas las solicitudes a este gateway deben incluir un encabezado X-Api-Key. Los desarrolladores deben obtener la clave de API del equipo de KyberSwap o del área de desarrollo de negocio (BD).
La URL base anterior sigue funcionando, pero tiene límites de frecuencia y la documentación recomienda migrar a la ruta del gateway. Por eso, en una nueva integración, el gateway debería considerarse la vía principal y no una mejora opcional.
Esto ofrece a los desarrolladores una vía de producción más clara desde el principio.
¿Qué ocurre cuando aumenta el volumen de solicitudes?
Una aplicación de trading en producción puede generar muchas más solicitudes de cotización que swaps completados.
Los usuarios cambian los importes de los tokens, comparan pares, actualizan las cotizaciones o se van antes de enviar una transacción. Por eso, una billetera o una plataforma de trading puede generar un volumen considerable de solicitudes a la API, aunque el número final de operaciones ejecutadas sea mucho menor.
Por eso, los desarrolladores deberían estimar el volumen previsto de solicitudes de cotización, no solo el volumen previsto de swaps.
Con KyberSwap, la pregunta práctica no es solo si la API puede devolver una ruta funcional para una operación de prueba. También hay que determinar si el patrón de tráfico de la aplicación se ajustará al uso previsto del gateway cuando el producto esté activo.
Como la documentación actual presenta el gateway de Swap API como la principal vía de integración, los equipos que prevean un volumen de producción considerable deberían planificar con antelación el acceso al gateway junto con KyberSwap. Confiar en la URL base anterior, que tiene límites de frecuencia, es más apropiado para usos heredados que para una nueva implementación en producción.
¿Deberías usar la API de Aggregator o el widget de KyberSwap?
No todos los equipos necesitan controlar directamente las solicitudes de rutas y la creación de transacciones.
Si el objetivo es añadir rápidamente una interfaz de swap funcional, el widget de KyberSwap ofrece una vía más rápida y requiere menos trabajo de frontend.
Si el producto ya tiene su propia interfaz de trading o necesita controlar la selección de tokens, las solicitudes de rutas, la creación de transacciones, la lógica de comisiones o el flujo de usuario circundante, la API de Aggregator ofrece más flexibilidad.
La decisión depende de cuánto de la experiencia de swap quiera gestionar el producto.
¿Cuánto cuesta la API de KyberSwap Aggregator?
Una API puede parecer económica durante el desarrollo, pero volverse costosa cuando los usuarios empiezan a operar a gran escala.
A los desarrolladores les conviene distinguir entre el costo de acceder a la API y el costo de ejecutar un swap.
Las API públicas de KyberSwap no requieren una suscripción de pago anticipada para el acceso público habitual. KyberSwap también tiene una comisión de swap del 0 %.
Eso no significa que todas las partes de la transacción sean gratuitas.
El gas de red proviene de la propia blockchain. Las comisiones de los proveedores de liquidez pueden provenir de los pools incluidos en la ruta seleccionada.
Estos costos son independientes de la comisión de Swap de KyberSwap.
¿Pueden los desarrolladores añadir su propia comisión de integrador?
Algunos productos quieren que los swaps sean simplemente una función para los usuarios. Otros quieren que la actividad de trading forme parte de su modelo de negocio.
La API de KyberSwap Aggregator permite que la aplicación que la integra configure una comisión de integrador.
Los desarrolladores pueden definir el importe de la comisión, la dirección receptora y la forma de cobrarla como parte del flujo del swap. Si la aplicación no configura una comisión de integrador, no se añade ninguna.
Esto permite que las billeteras, las aplicaciones de trading y otros productos Web3 moneticen la actividad de swaps mientras siguen usando KyberSwap para el enrutamiento y la creación de transacciones.
La comisión de integrador es independiente de la comisión de swap del 0 %.
¿Qué cadenas EVM se pueden admitir con la API de KyberSwap Aggregator?
Una aplicación que hoy se lanza en una red puede necesitar varias más adelante.
Un proyecto podría empezar en Base y luego expandirse a Ethereum y Robinhood Chain. Después, una billetera podría necesitar Arbitrum u Optimism. Si cada expansión requiere una arquitectura de swaps completamente nueva, la carga de mantenimiento crece junto con el producto.
KyberSwap Aggregator está diseñado para funcionar en las redes EVM compatibles mediante el mismo modelo general de integración.
Los desarrolladores especifican la red de destino en la solicitud a la API, mientras que Aggregator busca la liquidez disponible en esa cadena.
KyberSwap admite actualmente los principales ecosistemas EVM, como Ethereum, Base, BNB Chain, Arbitrum, Optimism, Robinhood Chain y otras redes compatibles.
El valor no reside simplemente en la cantidad de redes disponibles.
La mayor ventaja es que la aplicación puede reutilizar el mismo flujo general de búsqueda de rutas y creación de transacciones a medida que se expande a otras cadenas compatibles.
¿Se puede reutilizar una integración en varias cadenas EVM?
Sí, siempre que KyberSwap admita esas redes.
Supongamos que una dApp se lanza en Base y más adelante añade Ethereum. La aplicación no necesita sustituir toda la capa de agregación. Puede conservar la misma arquitectura general de API y cambiar la red, además de gestionar los tokens y la liquidez disponibles en ella.
Esto reduce la infraestructura de enrutamiento que el equipo debe volver a crear cada vez que el producto se expande.
Aun así, los desarrolladores deberían consultar la lista más reciente de redes compatibles antes del lanzamiento, ya que la cobertura puede cambiar a medida que se incorporan nuevos ecosistemas.
¿Qué más deberían evaluar los desarrolladores de EVM?
La integración, el costo y la compatibilidad con cadenas determinan si una API encaja en la arquitectura del producto.
La calidad del enrutamiento determina si esa integración realmente ofrece una buena experiencia de swap a los usuarios.
Una API gratuita no tiene mucho valor si los usuarios reciben sistemáticamente una ejecución deficiente.
La liquidez de DeFi está fragmentada entre DEX, pools y otras fuentes. La mejor ruta para un tamaño de operación puede no ser la mejor para otro.
KyberSwap Aggregator busca entre la liquidez disponible en lugar de obligar a la aplicación a elegir una plataforma de antemano. También puede dividir las operaciones entre varias fuentes si una ruta combinada ofrece un mejor resultado.
Para los usuarios, eso significa que no tienen que comparar manualmente varios DEX antes de operar.
Para los desarrolladores, lo importante es probar la API con los pares de tokens, las redes y los tamaños de operación que realmente se esperan en el producto. Contar con muchas fuentes de liquidez aporta contexto, pero probar rutas reales permite tomar decisiones mejor fundamentadas.
¿Es la API de KyberSwap Aggregator adecuada para tu aplicación EVM?
La API de KyberSwap Aggregator resulta especialmente pertinente cuando el problema va más allá de añadir un swap sencillo.
Un desarrollador quizá necesite evitar mantener varias integraciones con DEX, lanzar el producto sin pagar una suscripción anticipada a la API, expandirse a varias redes EVM, acceder a liquidez fragmentada o crear un modelo de ingresos basado en el volumen de swaps.
KyberSwap responde a esas necesidades con una arquitectura única de Aggregator, un flujo de integración de búsqueda de rutas y creación de transacciones, acceso a la API pública, una comisión de swap del 0 %, comisiones de integrador configurables y compatibilidad con varias redes EVM.
Aun así, la decisión final debe contrastarse con los requisitos reales de la aplicación.
Ten en cuenta las redes que necesita el producto, los pares con los que probablemente operarán los usuarios, el volumen previsto de solicitudes de cotización, los tamaños habituales de las operaciones y cuánto control necesita la aplicación sobre la experiencia de swap.
La pregunta útil no es simplemente si la API de KyberSwap Aggregator tiene suficientes funciones. La pregunta es si reduce suficiente trabajo de enrutamiento e integración para el producto y, al mismo tiempo, ofrece al desarrollador el control, las condiciones económicas y la cobertura de redes que necesita la aplicación.
Preguntas frecuentes
¿Es gratuita la integración de la API de KyberSwap Aggregator?
Sí. Los desarrolladores pueden acceder a la API de KyberSwap Aggregator sin pagar una suscripción anticipada. KyberSwap Swap también tiene una comisión de swap de KyberSwap del 0 %, aunque pueden aplicarse el gas de red y las comisiones de las fuentes de liquidez subyacentes.
¿La API de KyberSwap Aggregator requiere una clave de API?
Sí. La documentación actual indica a los integradores que usen el gateway de Swap API y que incluyan un encabezado X-Api-Key en las solicitudes. Los desarrolladores deben obtener esa clave del equipo de KyberSwap o del área de desarrollo de negocio (BD).
La URL base anterior sigue funcionando, pero tiene límites de frecuencia y la documentación recomienda migrar a la ruta del gateway.
¿Qué redes EVM admite la API de KyberSwap Aggregator?
KyberSwap admite varias redes EVM, incluidos ecosistemas importantes como Ethereum, Base, BNB Chain, Arbitrum, Optimism y Robinhood Chain. Los desarrolladores deberían consultar la lista más reciente de redes compatibles antes del lanzamiento, ya que la cobertura puede ampliarse con el tiempo.
¿Puedo usar una sola integración de la API de KyberSwap en varias cadenas EVM?
Sí. El mismo flujo general de búsqueda de rutas y creación de transacciones se puede reutilizar en las redes EVM compatibles, lo que reduce la necesidad de mantener una arquitectura de swaps independiente para cada cadena.