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 →
A documentação em nível de endpoint fica na aba API Reference. Todo endpoint lá tem um painel Try it interativo fornecido pelo playground OpenAPI do Mintlify — preencha os parâmetros no navegador e acesse a mainnet ao vivo (ou devnet, onde disponível) diretamente. Esta página é o companheiro narrativo: que serviços existem, quando usar cada um e as convenções que abrangem todos eles. Se você está procurando por “o que GET /pools/info/ids aceita”, clique em API Reference; se está procurando por “qual serviço devo integrar”, continue lendo.

​
Os onze serviços em síntese

O Raydium executa onze serviços HTTP públicos. Cada um é documentado como seu próprio grupo na aba API Reference e tem uma especificação OpenAPI apoiando o playground interativo.
ServiçoHost MainnetHost DevnetO que fornece
API v3api-v3.raydium.ioapi-v3-devnet.raydium.ioAPI canônica de leitura de pools / mints / config / chain-info. A porta de entrada padrão para a UI e a maioria dos integradores.
Transaction APItransaction-v1.raydium.iotransaction-v1-devnet.raydium.ioConstrução de transações de swap do lado do servidor.
Perps APIapi-perp-v1.raydium.io—Configurações, metadados de ativos, seleção de RPC para a interface do Raydium Perps.
LaunchLab Mint APIlaunch-mint-v1.raydium.iolaunch-mint-v1-devnet.raydium.ioBusca de tokens, índices, placares, metadados por mint.
LaunchLab History APIlaunch-history-v1.raydium.iolaunch-history-v1-devnet.raydium.ioHistórico de negociações e agregados de k-line OHLC para pools do LaunchLab.
LaunchLab Forum APIlaunch-forum-v1.raydium.iolaunch-forum-v1-devnet.raydium.ioTópicos de comentários e uploads IPFS nos lançamentos do LaunchLab. Assinado por wallet.
LaunchLab Auth APIlaunch-auth-v1.raydium.iolaunch-auth-v1-devnet.raydium.ioEmite JWTs ray-token de curta duração a partir de uma mensagem assinada por wallet. Necessário para Forum.
Dynamic IPFS APIdynamic-ipfs.raydium.iodynamic-ipfs-devnet.raydium.ioRegeneração de imagem / metadados para NFTs dinâmicos (posições CLMM, etc.).
Owner APIowner-v1.raydium.ioowner-v1-devnet.raydium.ioPosições por wallet, saldos, recompensas resgatáveis.
API v1 (legado)api.raydium.io—Caminhos /v1 e /v2 legados mantidos ao vivo para clientes que não migraram para API v3.
Temp APItemp-api-v1.raydium.iotemp-api-v1-devnet.raydium.ioZona de transição para endpoints ad-hoc de curta duração. A superfície pode mudar sem aviso prévio.
A versionação existe no hostname para os serviços v3 / v1 — não há versionação adicional em nível de caminho. Mudanças que quebram compatibilidade chegam como um novo host com sobreposição; a equipe se comprometeu publicamente com pelo menos 6 meses de sobreposição em qualquer migração v3 → v4.

​
Escolha um serviço

Se você quer…Use
Ler metadados de pools, preços, APRs, configurações de taxaAPI v3
Ler metadados de mints (nome, símbolo, logo, decimais, tags de risco)API v3 /mint/list, /mint/price
Construir uma transação de swap / adicionar liquidez / remover liquidez do lado do servidorTransaction API
Mostrar posições de uma wallet (tokens LP, posições CLMM, stakes em farms)Owner API
Buscar tokens do LaunchLab, navegar placares, buscar metadados por mintLaunchLab Mint API
Renderizar um gráfico de k-line / vela para um pool do LaunchLabLaunchLab History API
Postar ou ler comentários em um lançamento do LaunchLabLaunchLab Auth API → ray-token → LaunchLab Forum API
Renderizar uma imagem NFT de posição CLMMDynamic IPFS API
Mostrar configurações de mercado futuro ou listas de ativos para a UI do PerpsPerps API
Manter compatibilidade com um cliente prefixado com caminho v1/v2API v1 (legado)

​
Convenções transversais

​
Envelope de resposta

Todos os serviços, exceto IPFS, retornam o mesmo envelope JSON: 
{
  "id":      "uuid-v4-per-request",
  "success": true,
  "data":    { ... }
}
Em caso de falha: 
{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "human-readable error string",
  "data":    null
}
Alguns serviços incluem adicionalmente um inteiro error.code (API v3 o usa para identificadores de erro estáveis entre versões menores). Consulte a página de visão geral de cada serviço para o formato exato.

​
Autenticação

Dois padrões aparecem:
  • Sem autenticação — todos os serviços exceto Forum. Acesse-os anonimamente via HTTPS.
  • Handshake assinado por wallet — exigido pela LaunchLab Forum API. Assine uma mensagem Solana ed25519 do formulário time:<unix-seconds> com sua wallet, envie a assinatura + endereço da wallet para LaunchLab Auth API /request-token, receba um JWT de volta e passe-o como o header de requisição ray-token em chamadas subsequentes do fórum.
O playground do Mintlify aceita ray-token no painel de autenticação antes de enviar requisições ao fórum; o valor é mantido apenas no seu navegador.

​
Limites de taxa

Todos os hosts ficam atrás do Cloudflare com limitação de taxa progressiva por IP de origem. Orientações publicadas para integradores: Rajadas acima dos limites publicados retornam HTTP 429 com um header Retry-After. Agregadores ou bots que precisam de limites mais altos devem entrar em contato com a equipe do Raydium em vez de bombardear os hosts públicos — executar seu próprio indexador contra os IDs do programa on-chain também é uma opção para cargas de trabalho de leitura intensiva.

​
Cache e consistência

  • A maioria dos endpoints de leitura da API v3 são cacheados na borda por 5–60 segundos; TTLs específicos são anotados na página de referência de API de cada endpoint.
  • O cache é invalidado pelo indexador em eventos que tocam o programa que ele observa.
  • Durante reorganizações grandes ou congestionamento, pode haver uma divergência de 1–2 slots entre a visualização da API e o estado on-chain. O SDK e as leituras diretas de RPC são sempre mais atuais — se um cliente está prestes a assinar uma transação, re-busque as contas relevantes via RPC, nunca confie em um valor de API cegamente.

​
Formato de erro

Os erros retornam como HTTP 4xx/5xx com o mesmo envelope (success: false, msg preenchido). API v3 inclui adicionalmente um error.code estável: 
{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "Pool not found",
  "error":   { "code": 40401, "message": "Pool not found" }
}
O error.code é estável entre versões menores da API; trate-o como o sinal principal na lógica do cliente e msg como a superfície legível por humanos.

​
Convenção de argumento de par de mints

Muitos endpoints da API v3 aceitam mint1=…&mint2=… e exigem mint1 < mint2 (ordem de byte de chave pública ascendente). Isso permite que a API retorne o mesmo pool canônico independentemente da ordem de argumento preferida do chamador. Classifique os dois mints do lado do cliente antes de construir a URL — a documentação em nível de endpoint em API Reference repete essa restrição onde se aplica.

​
Padrões recomendados de cliente

  1. Hidrate uma vez, atualize com preguiça. Puxe GET /main/info e GET /mint/list (ambos na API v3) no carregamento do app e cache localmente com TTL de 1 hora. Ambos são muito cacheados na borda e raramente mudam.
  2. Agrupe em massa onde o endpoint permite. GET /pools/info/ids?ids=… aceita uma lista separada por vírgulas — busque dez pools em uma requisição, não dez requisições.
  3. Evite buscas de preço no caminho crítico. GET /mint/price é bom para renderização de UI; nunca o faça em loop em um bot. Para bots de negociação, execute um indexador ou subscreva-se a eventos programSubscribe de RPC diretamente.
  4. Espelhe ou proxy para alta taxa de transferência. Qualquer coisa acima do teto de limite de taxa publicado deve ser servida a partir de sua própria camada de cache, não diretamente dos hosts públicos. Agregadores com >120 req/min sustentado contra transaction-v1 devem estar executando seu próprio mecanismo de cotação / rota.
  5. Re-busque logo antes de assinar. Respostas de API podem ter 5–60s de atraso. Para um snapshot de pool realmente correto no momento da assinatura, releia as contas relevantes via SDK ou uma chamada direta de RPC getMultipleAccounts. Trate valores de API como uma dica de busca, não uma fonte de liquidação.
  6. Use a Transaction API para integração sem atrito. Se você não quer agrupar o SDK em seu cliente (mobile nativo, bot em ambiente restrito), a Transaction API retornará uma transação versionada codificada em base64 para o usuário assinar. A swapResponse que ela retorna contém uma cotação — trate-a como válida por ~30 segundos.

​
Para onde ir a seguir

  • Referência de endpoint (interativa) — API Reference. Cada serviço tem seu próprio grupo; clique em qualquer endpoint para parâmetros, forma de resposta, exemplos de código e painel Try-it.
  • SDK TypeScript — sdk-api/typescript-sdk. O SDK consome API v3 internamente para vários caminhos; para construção de transações ele sempre re-busca estado de RPC, nunca confia na API cegamente.
  • Integração com Trade API — integration-guides/aggregator. Padrões para conectar liquidez do Raydium em um agregador multi-DEX.
  • Docs amigáveis a IA — sdk-api/ai-integration. Indicadores para agentes de codificação de IA que precisam chamar essas APIs.