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

# L2Pass Swap API para wallets y apps

> Añade swaps cross-chain de stablecoins a tu wallet o app con la API L2Pass SwapKit: estimación, cotización con dirección de depósito, estado y webhooks. API key de partner.

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](https://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.

| Endpoint | Qué hace |
| :- | :- |
| `GET /v1/assets` | Lista los activos y redes compatibles |
| `POST /v1/swap/estimate` | Devuelve una estimación sin dirección de depósito |
| `POST /v1/swap/quote` | Devuelve una cotización vinculante con una dirección de depósito de un solo uso |
| `GET /v1/swap/status/{quoteId}` | Devuelve el estado: PENDING, COMPLETED, FAILED o REFUNDED |
| `GET /v1/partner/me` | Devuelve tu perfil de partner y tus límites |
| `GET /v1/partner/transactions` | Lista tus swaps |
| `GET /v1/partner/analytics` | Devuelve analíticas de uso |

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](https://api.l2pass.com/docs).

## 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](https://docs.l2pass.com/es/products/swap/learn/failed-swaps-and-refunds.md#how-screening-works).

## Preguntas frecuentes

> [accordion] ¿Cómo consigo una API key?
>
> Las API keys se emiten en el onboarding de partners. Contacta con el [soporte de L2Pass](https://docs.l2pass.com/es/resources/support.md) para pedir acceso.

> [accordion] ¿La API guarda fondos de los usuarios?
>
> 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.

> [accordion] ¿Puedo ganar una comisión con los swaps?
>
> 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.

> [accordion] ¿Hay un SDK?
>
> Sí, `@l2pass/swapkit-sdk` en npm. Consulta la [referencia de la API](https://api.l2pass.com/docs) para más detalles.

## Enlaces

* [Referencia de la API](https://api.l2pass.com/docs)
* [Qué es L2Pass RFQ by NEAR Intents](https://docs.l2pass.com/es/products/swap/learn/what-is-l2pass-rfq.md)
* [Comisiones de L2Pass Swap explicadas](https://docs.l2pass.com/es/products/swap/learn/fees.md)
* [Referidos y condiciones por volumen](https://docs.l2pass.com/es/products/swap/learn/referrals-and-partners.md)
* [Contactar con soporte](https://docs.l2pass.com/es/resources/support.md)

*Última actualización: 19 de octubre de 2026*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.