Saltar para o conteúdo 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 foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.Ver versão em inglês →
Pré-requisito: uma carteira Solana financiada com pelo menos ~0,05 SOL. Se você ainda não tem uma, consulte getting-started/what-you-need.

​
Objetivo

Fazer swap de uma pequena quantidade de SOL (digamos, 0,1 SOL) por USDC. Este é o trade mais simples possível na Raydium e cobre o fluxo completo — conectar uma carteira, escolher tokens, revisar uma cotação, assinar e verificar. O que você pagará:
  • 0,25% de taxa de negociação (dividida entre LPs e protocolo).
  • Alguns milésimos de dólar em taxa de rede.
  • Ao preço atual de SOL ~$160, o custo total de atrito em um trade de 0,1 SOL é bem inferior a um dólar.
O que você terá depois:
  • 0,1 SOL a menos em SOL (mais um pequeno resíduo de wSOL).
  • ~16 USDC (mais ou menos, dependendo do preço exato no momento da execução).
  • Uma assinatura de transação que você pode procurar em um explorador Solana.

​
Passo a passo

​
1. Abra raydium.io/swap

Acesse raydium.io/swap no seu navegador. Verifique a URL — clones de phishing existem. O domínio correto é exatamente raydium.io. O painel de swap possui:
  • Uma seção “From” (qual token você está gastando).
  • Uma seção “To” (qual token você está comprando).
  • Um botão de swap no meio para inverter direções.
  • Uma engrenagem de configurações no canto superior direito para slippage e taxa prioritária.
  • Um ícone de compartilhamento para links de referência (consulte user-flows/referrals-and-blinks).

​
2. Conecte sua carteira

Clique em “Connect Wallet” no canto superior direito. Um modal aparece com as carteiras Solana atualmente integradas com Raydium. Escolha a sua. Sua carteira solicita que você aprove a conexão — isto é somente leitura. Permite que o site veja seu endereço e sugira transações. Não move fundos. Confirme. Após conectar, o canto superior direito mostra seu endereço de carteira (truncado) e seu saldo de SOL.

​
3. Escolha os tokens

  • From: SOL (deve ser o padrão).
  • To: clique na lista suspensa e digite “USDC”. O token com a insígnia verificada é o USDC canônico (mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v). Evite imitações com nomes similares, mas mints diferentes.

​
4. Insira o valor

Digite 0.1 no campo “From”. O campo “To” é preenchido automaticamente com a cotação de saída (por exemplo, 16.2 USDC). Abaixo dos campos, a Raydium mostra:
  • Price: “1 SOL ≈ 162 USDC” ou similar.
  • Slippage tolerance: “0,5%” por padrão. Aceitável para SOL/USDC.
  • Routing: mostra qual(is) pool(s) a Raydium usará. Para SOL/USDC, geralmente é um único pool CLMM.
  • Price impact: quanto seu trade move o preço. Para 0,1 SOL, próximo a zero.

​
5. Revise e faça o swap

Clique no botão Swap. Um modal de confirmação aparece mostrando:
  • O valor mínimo que você receberá (após slippage).
  • Taxa de rede estimada.
  • A divisão da “rota”.
Clique em Confirm. Sua carteira abrirá um prompt de assinatura.

​
6. Aprove em sua carteira

A carteira mostra:
  • Os detalhes da transação: duas ou três instruções (talvez envolver SOL, fazer swap, desfazer o envolvimento).
  • Estimativa de taxa de rede.
  • Resultado da simulação (mudanças nos saldos de tokens).
Leia a simulação. Você deve ver SOL diminuir em cerca de 0,1 e USDC aumentar em cerca de 16,2. Se a simulação disser o contrário — por exemplo, “SOL diminuir em 1,0” — rejeite e investigue. Clique em Approve / Confirm. A carteira assina e transmite.

​
7. Confirmação

Em alguns segundos, a Raydium mostra “Transaction succeeded” com um link para Solscan / Solana Explorer. Seus saldos são atualizados. Se falhar, consulte Troubleshooting abaixo.

​
Verificando se funcionou

​
Em sua carteira

Abra a lista de tokens da carteira. Você deve agora ver:
  • USDC balance: ~16,2 USDC.
  • SOL balance: diminuído em ~0,1 SOL mais uma pequena taxa de rede (~0,0015 SOL).
  • Uma transação recente com status “Success”.

​
Em um explorador Solana

Copie a assinatura da transação (do toast de sucesso da Raydium ou do log de transações da sua carteira) e cole em: Você verá:
  • Status: Success.
  • Signer: seu endereço de carteira.
  • Token balance changes: seu SOL saindo, seu USDC entrando, além de transferências no lado do pool.
  • Programs invoked: um programa Raydium (CPMM, CLMM ou AMM v4 dependendo da rota), o programa Token, o programa System.
Isto é final. A transação não pode ser revertida.

​
O que acabou de acontecer, um nível mais profundo

  1. Você pediu à Raydium para fazer swap de X SOL por Y USDC.
  2. O frontend (ou Trade API) procurou pools, escolheu o melhor e construiu uma transação.
  3. A transação tinha 2–4 instruções: possivelmente criar um ATA USDC (se você ainda não tivesse um), envolver SOL em wSOL, chamar o programa de swap Raydium, desfazer o envolvimento de qualquer wSOL residual.
  4. Sua carteira assinou a transação com sua chave privada.
  5. O RPC a transmitiu para os validadores Solana.
  6. Uma vez confirmada, o programa Raydium moveu tokens: wSOL de você para o pool, USDC do pool para você e acumulou taxas para LPs.
Para a visão do desenvolvedor disto, consulte user-flows/swap.

​
Troubleshooting

​
”Transaction simulation failed” ou “custom error: 0x1”

Geralmente significa SOL insuficiente para taxas ou a rota mudou entre a cotação e a execução. Solução: certifique-se de ter pelo menos 0,02 SOL acima de seu valor de swap para taxas e tente novamente.

​
Slippage tolerance exceeded

O preço do pool se moveu mais do que seu limite de slippage entre a cotação e a execução. Comum em momentos voláteis. Solução: abra configurações (ícone de engrenagem), aumente o slippage para 1% ou 2% e tente novamente. Não aumente muito além de 2% para pares principais — isso é um convite para ataques MEV sandwich.

​
”Token account does not exist”

O token de destino (USDC neste caso) precisa de um ATA em sua carteira. A transação de swap da Raydium normalmente inclui a etapa de criação do ATA, mas algumas carteiras antigas pulam isto. Solução: atualize sua carteira. Se persistir, crie manualmente o ATA através do fluxo “Add token” da sua carteira e tente novamente.

​
Apenas fica “pendurado” em pending

Solana está congestionada. Sua transação pode estar aguardando, sendo descartada ou retentada. Solução: aguarde 30 segundos. Se nada chegar, feche o modal, abra configurações, aumente a taxa prioritária (“Turbo” ou “Max” na UI Raydium) e tente novamente. Consulte integration-guides/priority-fee-tuning.

​
USDC não chegou

Verifique o status da transação no explorador.
  • Success: USDC está em sua carteira. Atualize a lista de tokens da sua carteira.
  • Failed: as taxas foram pagas, mas nenhum swap aconteceu. Verifique a mensagem de erro on-chain no log do explorador.
  • Not found: a transação nunca chegou; seu SOL está seguro. Tente novamente.

​
Depois do seu primeiro swap

​
Erros comuns que iniciantes cometem

  • Não deixar SOL suficiente para taxas. Fazer swap de literalmente todo seu SOL não deixa espaço para a taxa — a transação falha. Sempre mantenha ~0,02 SOL.
  • Slippage definido muito baixo em pares voláteis. 0,5% padrão é bom para SOL/USDC, mas apertado para memecoins. Aumente para 2–5% para esses.
  • Slippage definido muito alto. Slippage de 10%+ em um par principal convida a ataques sandwich. Mantenha no mínimo que ainda deixa o trade chegar.
  • Fazer swap do token errado. “USDC” vs “USDC.wh” (embrulhado do Ethereum via Wormhole) são mints diferentes. Sempre use o com a insígnia verificada, a menos que você especificamente queira o wrapper.
  • Clicar em tokens aleatórios de “airdrop”. Se um token desconhecido aparecer em sua carteira, não interaja com ele. Muitos são golpes onde a interação ativa uma aprovação maliciosa.

​
Para onde ir em seguida