Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

Esta página fue traducida automáticamente por IA. La versión en inglés es la fuente autorizada.Ver versión en inglés →

​
Entradas

Cada swap requiere:
  • Token de entrada (dirección mint + cantidad)
  • Token de salida (dirección mint)
  • Tolerancia de slippage (0.5% por defecto en la interfaz; 1% en pares volátiles)
  • Comisión de prioridad (ajustadas automáticamente por defecto)
La cantidad se especifica como “exact-in” (estableces qué pagas; se calcula la salida) o “exact-out” (estableces qué obtienes; se calcula la entrada). La interfaz usa exact-in por defecto.

​
Tutorial de la interfaz

En raydium.io/swap:
  1. Ingresa cantidades. Elige los tokens de entrada y salida; escribe una cantidad en cualquier campo. El otro se completa automáticamente usando la cotización actual.
  2. Revisa la ruta. El panel de ruta muestra qué pool(s) eligió Raydium:
    • Pool única (más común): “SOL → USDC via CLMM 0.05%”
    • Multi-salto: “SOL → USDC via CPMM, luego USDC → RAY via CLMM”
    • Dividida: “SOL → USDC via 60% CLMM 0.05%, 40% CPMM 0.25%”
    Para cada salto: el TVL, comisión e impacto esperado. Los trades grandes muestran una advertencia prominente cuando el impacto supera 1%.
  3. Verifica el slippage. Por defecto 0.5%. Para pares estables es 0.1%; para tokens meme 2–5%. Si la cotización cambia mientras la consultas (los precios fluctúan), la interfaz re-cotiza cada 10 segundos y parpadea.
  4. Establece la comisión de prioridad. Automática por defecto; tres niveles:
    • Normal (percentil 50) — por defecto
    • Rápido (percentil 75)
    • Turbo (percentil 95) Los usuarios avanzados pueden ingresar un número específico en micro-lamports/CU.
  5. Confirma y firma. La transacción se envía; la interfaz rastrea la confirmación. Tiempo esperado 5–15 segundos con congestión normal.
  6. Después del swap. La interfaz muestra la cantidad realmente recibida (puede diferir de la cotización hasta el slippage); haz clic para ir al explorador de transacciones para más detalles.

​
Cómo el enrutador elige un pool

Cuando existen múltiples pools para el mismo par, el enrutador de Raydium elige según:
  1. Mayor amountOut después de comisiones. Calcula la cotización para cada pool elegible; elige el que da más salida.
  2. Desempate por TVL. Mayor TVL significa menor impacto en el siguiente trade — resistente a fluctuaciones de precio entre cotización y envío.
  3. Prefiere single-pool sobre multi-hop. Multi-hop compone comisiones y slippage; el enrutador solo elige multi-hop si supera single-pool por >5 bps.
  4. Divide si es grande. Para trades grandes en relación al TVL del pool, la ruta puede dividirse entre pools para reducir el impacto de precio.
Productos comparados en pares típicos:
  • Pools CPMM dominan con TVL bajo (<$1M) porque son baratos de crear y la comisión de swap financia directamente a los LPs.
  • Pools CLMM dominan en TVL medio/alto para pares volátiles — la liquidez concentrada significa mejores cotizaciones en el rango de precio común.
  • Pools AMM v4 dominan en pares establecidos con profunda integración con OpenBook (SOL-USDC, RAY-USDC). La mayoría de pares nuevos nunca tocan AMM v4.

​
Comisiones de transferencia Token-2022

Si el mint de entrada o salida es Token-2022 con comisión de transferencia:
  • El amountOut de la cotización es la cantidad neta que recibe el usuario después de la comisión.
  • La “comisión” mostrada en la interfaz se divide en “Comisión de pool” (comisión LP) y “Comisión de transferencia” (pagada al emisor del mint).
Ver algorithms/token-2022-transfer-fees.

​
Slippage

El slippage protege contra movimientos adversos de precio entre cotización y ejecución. Raydium convierte tu porcentaje de slippage en una cantidad mínima que debes recibir: 
minimumAmountOut = expectedAmountOut × (1 - slippage)
Si la salida real sería menor, la tx revierte con ExceededSlippage. Valores por defecto comunes:
Tipo de parSlippage
Estable-estable0.01–0.1%
Mayor-mayor (SOL/USDC)0.1–0.5%
Volátiles mid-cap0.5–1%
Tokens meme2–5%
Token-2022 con comisión de transferenciaañade comisión de transferencia al slippage
Slippage muy ajustado causa reversiones frecuentes bajo movimientos de precio normales. Slippage muy suelto invita ataques sandwich (ver integration-guides/routing-and-mev).

​
Comisiones de prioridad

Las comisiones de prioridad pagan más a los validadores para procesar tu transacción durante congestión. La interfaz usa por defecto una configuración automática. Usa Rápido o Turbo cuando la red está ocupada, cuando estás haciendo swap en un par volátil, o cuando una transacción anterior expiró antes de confirmarse. Las comisiones de prioridad más altas no mejoran el precio cotizado. Solo mejoran la probabilidad de que tu transacción se procese antes de que la cotización se vuelva obsoleta.

​
Modos de fallo comunes

​
Tx revierte con ExceededSlippage

El precio se movió más que tu tolerancia entre cotización y ejecución. Soluciones:
  1. Aumenta el slippage solo lo necesario.
  2. Reduce el tamaño del trade (menos impacto).
  3. Re-cotiza e intenta de nuevo; el precio puede haber sido transitorio.
  4. Evita slippage muy alto en pares mayores, porque puede exponerte a peor ejecución.

​
Tx agota el tiempo

Comisión de prioridad demasiado baja para la congestión actual. Solución: aumenta la comisión de prioridad; ver integration-guides/priority-fee-tuning.

​
InvalidAccountData en swap CLMM

La ruta puede depender de una cuenta CLMM que falló al cargar o cambió mientras la cotización estaba abierta. Recarga la página, re-cotiza e intenta de nuevo. Si persiste, elige otra ruta si la interfaz ofrece una.

​
”Pool no encontrado” / datos de pool obsoletos

El pool se creó recientemente y aún no se ha indexado. Re-obtén por ID directamente: Espera algunos minutos, recarga la aplicación, y busca de nuevo por el mint del pool o token. Los pools recién creados pueden tardar un tiempo en aparecer en la búsqueda de interfaz indexada.

​
La salida es cero / muy pequeña

El tamaño del swap excede la liquidez del pool. El pool es muy shallow; reduce el tamaño del trade, intenta otra ruta, o espera más liquidez.

​
Tx se procesa pero el saldo no cambió

Recarga tu billetera y saldos de Raydium. Si la transacción se ejecutó exitosamente en el explorador, verifica si la cuenta de token de salida está oculta en tu interfaz de billetera.

​
Verificación

Usa el enlace de transacción mostrado por Raydium después de la confirmación. En Solscan o SolanaFM, verifica:
  • Estado: Éxito.
  • Firmante: tu dirección de billetera.
  • Cambios de saldo de token: token de entrada disminuyó, token de salida aumentó.
  • Programas invocados: un programa swap de Raydium más programas de token/sistema.

​
Referencias

Fuentes: