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 →
Swap é a operação de usuário mais comum. Esta página percorre o fluxo da interface do Raydium, explica as configurações que você pode controlar e lista os modos de falha que você provavelmente encontrará.

​
Entradas

Cada swap precisa de:
  • Token de entrada (endereço de mint + quantidade)
  • Token de saída (endereço de mint)
  • Tolerância de slippage (padrão 0,5% na interface; 1% em pares voláteis)
  • Taxa de prioridade (padrão dimensionado automaticamente)
O valor é especificado como “exact-in” (você define o que paga; saída calculada) ou “exact-out” (você define o que recebe; entrada calculada). A interface usa exact-in por padrão.

​
Passo a passo da interface

Em raydium.io/swap:
  1. Insira os valores. Escolha os tokens de entrada e saída; digite um valor em qualquer caixa. A outra se preenche automaticamente usando a cotação atual.
  2. Revise a rota. O painel de rota mostra qual(is) pool(s) o Raydium escolheu:
    • Rota única (mais comum): “SOL → USDC via CLMM 0.05%”
    • Multi-hop: “SOL → USDC via CPMM, depois USDC → RAY via CLMM”
    • Dividida: “SOL → USDC via 60% CLMM 0.05%, 40% CPMM 0.25%”
    Para cada hop: o TVL, a taxa e o impacto esperado. Trades maiores mostram um aviso destacado quando o impacto excede 1%.
  3. Verifique o slippage. O padrão é 0,5%. Para pares estáveis é 0,1%; para tokens meme é 2–5%. Se a cotação mudar enquanto você estiver vendo (os preços flutuam), a interface re-cota a cada 10 segundos e pisca.
  4. Defina a taxa de prioridade. Automática por padrão; três níveis:
    • Normal (50º percentil) — padrão
    • Rápido (75º percentil)
    • Turbo (95º percentil) Usuários avançados podem inserir um número específico em micro-lamports/CU.
  5. Confirme e assine. A transação é enviada; a interface acompanha a confirmação. Tempo esperado de 5–15 segundos em congestionamento normal.
  6. Pós-swap. A interface mostra o valor real recebido (pode diferir da cotação em até o slippage); clique para ir ao explorador de transações para detalhes completos.

​
Como o roteamento escolhe um pool

Quando múltiplos pools existem para o mesmo par, o router do Raydium escolhe por:
  1. Maior amountOut após as taxas. Calcule a cotação para cada pool elegível; escolha o que oferece mais saída.
  2. Critério de desempate por TVL. TVL maior significa impacto menor no próximo trade — resiliente a flutuações de preço entre cotação e envio.
  3. Prefira rota única sobre multi-hop. Multi-hop compõe taxas e slippage; o router só escolhe multi-hop se supera rota única por >5 bps.
  4. Divida se for grande. Para trades que são grandes em relação ao TVL do pool, a rota pode se dividir entre pools para reduzir o impacto de preço.
Produtos comparados em pares típicos:
  • Pools CPMM dominam em TVL baixo (<$1M) porque são baratos de criar e a taxa de swap financia LPs diretamente.
  • Pools CLMM dominam em TVL médio/alto para pares voláteis — liquidez concentrada significa cotações melhores dentro do intervalo de preço comum.
  • Pools AMM v4 dominam em pares estabelecidos há muito tempo com integração profunda do OpenBook (SOL-USDC, RAY-USDC). A maioria dos novos pares nunca toca AMM v4.

​
Token-2022 com taxas de transferência

Se o mint de entrada ou saída for Token-2022 com uma taxa de transferência:
  • O amountOut da cotação é o valor líquido recebido pelo usuário após a taxa.
  • A “taxa” exibida na interface se divide em “Taxa do Pool” (taxa de LP) e “Taxa de Transferência” (paga ao emissor do mint).
Consulte algorithms/token-2022-transfer-fees.

​
Slippage

O slippage protege contra movimentos adversos de preço entre cotação e execução. O Raydium converte sua porcentagem de slippage em um valor mínimo que você deve receber: 
minimumAmountOut = expectedAmountOut × (1 - slippage)
Se a saída real for menor, a tx reverte com ExceededSlippage. Padrões comuns:
Tipo de parSlippage
Estável-estável0,01–0,1%
Maior-maior (SOL/USDC)0,1–0,5%
Voláteis mid-cap0,5–1%
Tokens meme2–5%
Token-2022 com taxa de transferênciaadicione taxa de transferência ao slippage
Slippage muito apertado causa reversões frequentes sob movimento de preço normal. Slippage muito solto convida ataques sandwich (consulte integration-guides/routing-and-mev).

​
Taxas de prioridade

As taxas de prioridade pagam validadores mais para processar sua transação durante congestionamento. A interface usa um padrão automático por padrão. Use Rápido ou Turbo quando a rede está ocupada, quando você está fazendo swap de um par volátil, ou quando uma transação anterior expirou antes da confirmação. Taxas de prioridade mais altas não melhoram o preço cotado. Elas apenas aumentam a chance de sua transação ser processada antes de a cotação ficar desatualizada.

​
Modos de falha comuns

​
Tx reverte com ExceededSlippage

O preço mudou mais do que sua tolerância entre cotação e execução. Soluções:
  1. Aumente o slippage apenas o necessário.
  2. Reduza o tamanho do trade (menos impacto).
  3. Re-cote e tente novamente; o preço pode ter sido transitório.
  4. Evite slippage muito alto em pares principais, porque pode expô-lo a execução pior.

​
Tx expira

Taxa de prioridade muito baixa para o congestionamento atual. Solução: aumente a taxa de prioridade; consulte integration-guides/priority-fee-tuning.

​
InvalidAccountData em swap CLMM

A rota pode depender de uma conta CLMM que falhou ao carregar ou mudou enquanto a cotação estava aberta. Atualize a página, re-cote e tente novamente. Se persistir, escolha outra rota se a interface oferece uma.

​
”Pool não encontrado” / dados de pool desatualizados

O pool foi criado recentemente e ainda não foi indexado. Re-busque por ID diretamente: Aguarde alguns minutos, atualize o aplicativo e procure novamente pelo pool ou mint de token. Pools recém-criados podem levar um tempo para aparecer na busca indexada da interface.

​
A saída é zero / muito pequena

O tamanho do swap excede a liquidez do pool. O pool é muito raso; reduza o tamanho do trade, tente outra rota ou aguarde mais liquidez.

​
Tx é processada mas o saldo não mudou

Atualize seus saldos de carteira e Raydium. Se a transação foi bem-sucedida no explorador, verifique se a conta do token de saída está oculta na interface da sua carteira.

​
Verificação

Use o link de transação mostrado pelo Raydium após confirmação. No Solscan ou SolanaFM, verifique:
  • Status: Success.
  • Signatário: seu endereço de carteira.
  • Mudanças de saldo de token: token de entrada diminuiu, token de saída aumentou.
  • Programas invocados: um programa swap do Raydium mais programas de token/sistema.

​
Referências

Fontes: