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 →
Requisito previo: una billetera Solana financiada con al menos ~0,05 SOL. Si aún no tienes una, consulta getting-started/what-you-need.

Objetivo

Intercambiar una pequeña cantidad de SOL (digamos, 0,1 SOL) por USDC. Este es el trade de Raydium más simple posible y cubre el flujo completo: conectar una billetera, elegir tokens, revisar una cotización, firmar y verificar. Lo que pagarás:
  • Tarifa de negociación del 0,25% (dividida entre proveedores de liquidez y protocolo).
  • Algunos milésimos de dólar en tarifa de red.
  • A precio actual de SOL ~$160, el costo total de fricción en un trade de 0,1 SOL es bien menor a un dólar.
Lo que tendrás después:
  • 0,1 SOL menos de SOL (más un pequeño polvo de limpieza de wSOL).
  • ~16 USDC (más o menos, dependiendo del precio exacto en la ejecución).
  • Una firma de transacción que puedes buscar en un explorador de Solana.

Paso a paso

1. Abre raydium.io/swap

Ve a raydium.io/swap en tu navegador. Verifica la URL — existen clones de phishing. El dominio correcto es exactamente raydium.io. El panel de swap tiene:
  • Una sección “From” (qué token estás gastando).
  • Una sección “To” (qué token estás comprando).
  • Un botón de swap en el medio para invertir direcciones.
  • Una rueda de configuración en la esquina superior derecha para slippage y tarifa de prioridad.
  • Un icono de compartir para enlaces de referencia (consulta user-flows/referrals-and-blinks).

2. Conecta tu billetera

Haz clic en “Connect Wallet” en la esquina superior derecha. Aparece un modal con las billeteras Solana actualmente integradas con Raydium. Elige la tuya. Tu billetera te pide que apruebes la conexión — esto es solo lectura. Permite que el sitio vea tu dirección y sugiera transacciones. No mueve fondos. Confirma. Después de conectar, la esquina superior derecha muestra tu dirección de billetera (truncada) y tu saldo de SOL.

3. Elige tokens

  • From: SOL (debe ser el predeterminado).
  • To: haz clic en el dropdown e ingresa “USDC”. El token con el distintivo verified es el USDC canónico (mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v). Evita imitaciones con nombres similares pero diferentes mints.

4. Ingresa cantidad

Escribe 0.1 en el campo “From”. El campo “To” se completa automáticamente con la salida cotizada (p. ej. 16.2 USDC). Debajo de los campos, Raydium muestra:
  • Precio: “1 SOL ≈ 162 USDC” o similar.
  • Tolerancia de slippage: “0,5%” por defecto. Aceptable para SOL/USDC.
  • Ruteo: muestra qué pool(s) usará Raydium. Para SOL/USDC esto es usualmente un único pool CLMM.
  • Impacto de precio: cuánto tu trade mueve el precio. Para 0,1 SOL, casi cero.

5. Revisa y haz swap

Haz clic en el botón Swap. Aparece un modal de confirmación mostrando:
  • La cantidad mínima que recibirás (después de slippage).
  • Tarifa de red estimada.
  • El desglose de la “ruta”.
Haz clic en Confirm. Tu billetera muestra un prompt de firma.

6. Aprueba en tu billetera

La billetera muestra:
  • Los detalles de la transacción: dos o tres instrucciones (tal vez envolver SOL, swap, desenvuelva).
  • Estimación de tarifa de red.
  • Resultado de la simulación (cambios de saldo de token).
Lee la simulación. Deberías ver que SOL disminuye aproximadamente 0,1 y USDC aumenta aproximadamente 16,2. Si la simulación dice algo diferente — p. ej. “SOL disminuye por 1,0” — rechaza e investiga. Haz clic en Approve / Confirm. La billetera firma y transmite.

7. Confirmación

En pocos segundos, Raydium muestra “Transaction succeeded” con un enlace a Solscan / Solana Explorer. Tus saldos se actualizan. Si falla, consulta Solución de problemas a continuación.

Verificar que funcionó

En tu billetera

Abre la lista de tokens de tu billetera. Deberías ahora ver:
  • Saldo de USDC: ~16,2 USDC.
  • Saldo de SOL: disminuido por ~0,1 SOL más una pequeña tarifa de red (~0,0015 SOL).
  • Una transacción reciente con estado “Success”.

En un explorador de Solana

Copia la firma de transacción (del toast de éxito de Raydium o del registro de transacciones de tu billetera) y pégala en: Verás:
  • Estado: Success.
  • Firmante: tu dirección de billetera.
  • Cambios de saldo de token: tu SOL saliente, tu USDC entrante, más transferencias del lado del pool.
  • Programas invocados: un programa de Raydium (CPMM, CLMM, o AMM v4 dependiendo de la ruta), el programa Token, el programa System.
Esto es final. La transacción no puede ser revertida.

Qué acaba de pasar, un nivel más profundo

  1. Pediste a Raydium que intercambiara X SOL por Y USDC.
  2. El frontend (o Trade API) buscó pools, eligió el mejor y construyó una transacción.
  3. La transacción tenía 2–4 instrucciones: posiblemente crear un ATA de USDC (si no tenías uno aún), envolver SOL en wSOL, llamar al programa de swap de Raydium, desenvuelva cualquier wSOL residual.
  4. Tu billetera firmó la transacción con tu clave privada.
  5. El RPC la transmitió a los validadores de Solana.
  6. Una vez confirmada, el programa de Raydium movió tokens: wSOL de ti al pool, USDC del pool a ti, y acumuló tarifas para LPs.
Para la vista de desarrollador de esto, consulta user-flows/swap.

Solución de problemas

”Transaction simulation failed” o “custom error: 0x1”

Usualmente significa SOL insuficiente para tarifas, o la ruta cambió entre cotización y ejecución. Solución: asegúrate de tener al menos 0,02 SOL por encima de tu cantidad de swap para tarifas, e intenta de nuevo.

Tolerancia de slippage excedida

El precio del pool se movió más que tu límite de slippage entre cotización y ejecución. Común durante momentos volátiles. Solución: abre configuración (icono de rueda), aumenta el slippage a 1% o 2%, e intenta de nuevo. No aumentes mucho más alto que 2% para los principales — eso es una invitación para ataques de sándwich MEV.

”Token account does not exist”

El token de destino (USDC en este caso) necesita un ATA en tu billetera. La transacción de swap de Raydium normalmente incluye el paso de creación de ATA, pero algunas billeteras antiguas lo omiten. Solución: actualiza tu billetera. Si persiste, crea manualmente el ATA a través del flujo “Add token” de tu billetera, luego intenta de nuevo.

Solo “cuelga” en pendiente

Solana está congestionada. Tu transacción puede estar esperando, cayendo o reintentando. Solución: espera 30 segundos. Si nada aterriza, cierra el modal, abre configuración, aumenta la tarifa de prioridad (“Turbo” o “Max” en la UI de Raydium), e intenta de nuevo. Consulta integration-guides/priority-fee-tuning.

USDC no llegó

Comprueba el estado de la transacción en el explorador.
  • Success: USDC está en tu billetera. Recarga la lista de tokens de tu billetera.
  • Failed: las tarifas fueron pagadas pero no ocurrió swap. Comprueba el mensaje de error en la cadena en el registro del explorador.
  • Not found: la transacción nunca aterrizó; tu SOL está seguro. Intenta de nuevo.

Después de tu primer swap

Errores comunes que cometen los principiantes

  • No dejar suficiente SOL para tarifas. Intercambiar literalmente todo tu SOL no deja espacio para la tarifa — la transacción falla. Siempre mantén ~0,02 SOL.
  • Slippage establecido demasiado bajo en pares volátiles. El predeterminado de 0,5% está bien para SOL/USDC pero es ajustado para memecoins. Aumenta a 2–5% para esos.
  • Slippage establecido demasiado alto. Slippage de 10%+ en un par principal invita ataques de sándwich. Mantenlo en el mínimo que aún permita que el trade aterrice.
  • Intercambiar el token incorrecto. “USDC” vs “USDC.wh” (envuelto desde Ethereum vía Wormhole) son mints diferentes. Siempre usa el que tenga el distintivo verified a menos que específicamente quieras el wrapper.
  • Hacer clic en tokens aleatorios de “airdrop”. Si un token desconocido aparece en tu billetera, no interactúes con él. Muchos son estafas donde interactuar activa una aprobación maliciosa.

A dónde ir después