Skip to main content
La API L2Pass SwapKit permite a wallets, apps y agentes de IA añadir swaps cross-chain a su propio producto. Funciona igual que L2Pass RFQ by NEAR Intents: pides una cotización, obtienes una dirección de depósito de un solo uso y el usuario paga desde cualquier wallet o exchange. La API devuelve la comisión de la plataforma, tu comisión de partner y el importe neto de cada cotización, y te avisa de los cambios de estado con webhooks firmados. El acceso requiere una API key de partner, que se emite en el onboarding. La documentación de referencia está en api.l2pass.com/docs.

Qué puedes construir

Cualquier producto que reciba tokens en una red y los entregue en otra puede usar la API.
  • Wallets: swaps cross-chain de stablecoins dentro de tu wallet, incluidos Tron, Solana, Bitcoin y Zcash.
  • Apps de pago: acepta USDT en una red y liquida en otra.
  • Exchanges y comercios: flujos con dirección de depósito que funcionan desde cualquier wallet o exchange.
  • Agentes de IA: cotiza y ejecuta swaps mediante una API REST.

Endpoints

Siete endpoints REST cubren activos, estimaciones, cotizaciones, estado y tu cuenta de partner. URL base: https://api.l2pass.com. Envía tu clave en la cabecera X-API-Key. La especificación OpenAPI completa está en la referencia de la API.

Cómo funciona un swap a través de la API

Un swap por API sigue el mismo flujo que en la app: cotización, depósito, estado.
1

Obtén una estimación

Llama a POST /v1/swap/estimate con los activos de origen y destino y el importe, para mostrar al usuario lo que recibirá.
2

Pide una cotización

Llama a POST /v1/swap/quote con las direcciones de recepción y de reembolso. La respuesta incluye una dirección de depósito de un solo uso y el desglose de comisiones: platform_fee, partner_fee, total_fee y net_output.
3

Deja que el usuario pague

El usuario envía el importe cotizado a la dirección de depósito desde cualquier wallet o exchange.
4

Sigue el estado

Consulta GET /v1/swap/status/{quoteId} o recibe webhooks firmados con HMAC-SHA256 en la cabecera X-Webhook-Signature.

Comisiones, límites y reembolsos

Tú fijas tu propia comisión de partner, y tu clave tiene sus propios límites de peticiones.
  • Comisión de partner. Puedes añadir tu propia comisión, que se devuelve como partner_fee_bps y partner_fee en cada cotización.
  • Límites de peticiones. Los límites se fijan por partner para cotizaciones y consultas de estado. Si los superas, la API devuelve 429 con una cabecera Retry-After.
  • Rotación de claves. Rota tu clave con POST /v1/partner/rotate-key.
  • Reembolsos y fallos. Si un swap no puede completarse, el proveedor lo reembolsa a la dirección de reembolso y su estado pasa a REFUNDED. Las direcciones marcadas no reciben cotización. Un depósito marcado después de llegar queda retenido para revisión en lugar de reembolsarse, y el usuario lo resuelve con el soporte de NEAR Intents. Consulta Cómo funciona el control.

Preguntas frecuentes

Las API keys se emiten en el onboarding de partners. Contacta con el soporte de L2Pass para pedir acceso.
No. Los usuarios pagan a una dirección de depósito de un solo uso para su cotización, y el swap lo ejecutan solvers en NEAR Intents. L2Pass nunca guarda tokens ni claves privadas de los usuarios.
Sí. Fija una comisión de partner, y cada cotización la devuelve como partner_fee_bps y partner_fee junto a la comisión de la plataforma.
Sí, @l2pass/swapkit-sdk en npm. Consulta la referencia de la API para más detalles.

Enlaces

Última actualización: 19 de octubre de 2026