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 →
Todo endpoint neste site possui um painel Try it (Experimente) alimentado pelo playground OpenAPI do Mintlify. O playground roda no seu navegador e acessa diretamente os hosts de produção (ou devnet) em tempo real. Leia Autenticação antes de enviar requisições que exigem assinatura de carteira.

Catálogo de serviços

A Raydium opera onze serviços HTTP públicos. Cada um é documentado como seu próprio grupo na árvore de navegação à esquerda.
ServiçoHost MainnetHost DevnetO que faz
API v3api-v3.raydium.ioapi-v3-devnet.raydium.ioPool / mint / config / chain-info — a API de leitura canônica em que a UI e o SDK se baseiam.
Transaction APItransaction-v1.raydium.iotransaction-v1-devnet.raydium.ioConstrução de transações de swap / liquidez no lado do servidor. O ponto de entrada do agregador.
Perps APIapi-perp-v1.raydium.ioConfigurações, metadados de ativos, seleção de RPC para o front-end do Raydium Perps.
LaunchLab Mint APIlaunch-mint-v1.raydium.iolaunch-mint-v1-devnet.raydium.ioBusca de tokens, índices, placares, metadados por mint para launches do LaunchLab.
LaunchLab History APIlaunch-history-v1.raydium.iolaunch-history-v1-devnet.raydium.ioHistórico de transações, agregados de K-line para pools do LaunchLab.
LaunchLab Forum APIlaunch-forum-v1.raydium.iolaunch-forum-v1-devnet.raydium.ioComentários, threads, uploads IPFS vinculados a um launch do LaunchLab. Com assinatura de carteira.
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 carteira. Obrigatório para chamar a API do fórum.
Dynamic IPFS APIdynamic-ipfs.raydium.iodynamic-ipfs-devnet.raydium.ioRegenerador de imagem / metadados de NFT. Alimenta a arte de posição CLMM e outros NFTs on-chain cuja aparência depende de estado dinâmico.
Owner APIowner-v1.raydium.ioowner-v1-devnet.raydium.ioPosições por carteira, saldos, recompensas reclamáveis.
API v1api.raydium.ioEndpoints v1/v2 legados, mantidos ativo para clientes que ainda não migraram para API v3.
Temp APItemp-api-v1.raydium.iotemp-api-v1-devnet.raydium.ioZona de espera para endpoints bespoke de curta duração. Atualmente expõe resumos de taxa de criador CPMM. Sujeito a mudanças sem aviso.

Autenticação

A maioria dos serviços é somente leitura e aceita requisições anônimas. Dois padrões aparecem:
  • Handshake assinado por carteira — obrigatório por launch-auth-v1 para cunhar um ray-token, depois transportado como header ray-token por launch-forum-v1. Assine uma mensagem Solana ed25519 da forma time:<unix-seconds> com sua carteira, envie a assinatura + endereço da carteira para /request-token de launch-auth-v1, receba um JWT de volta e passe-o como header de requisição ray-token em chamadas de fórum subsequentes.
  • Sem autenticação — todos os outros serviços. Chamadores confiáveis (a UI da Raydium, integradores) acessam os endpoints diretamente via HTTPS.
O playground do Mintlify permite que você cole um ray-token no painel de autenticação antes de enviar requisições de fórum; o valor é mantido apenas no seu navegador.

Limites de taxa

Todos os hosts estão atrás da Cloudflare com limite de taxa progressivo por IP de origem. Integradores que precisam de limites maiores devem entrar em contato com a equipe da Raydium. Rajadas acima dos limites publicados são retornadas como HTTP 429 com um header Retry-After.

Envelope de resposta

A maioria dos serviços envolve seus payloads JSON em um envelope uniforme:
{
  "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
}
api-v3 retorna o envelope como { "id", "success", "data" }. Os serviços pump-* usam helpers addBorderSuccess / addBorderErr que produzem a mesma forma com msg preenchido apenas em erros. Verifique a página de introdução de cada serviço para o envelope exato que ele usa.

Como usar esta seção

Clique em qualquer endpoint na navegação à esquerda. Você verá:
  • O método HTTP, URL completa e host base.
  • Parâmetros de requisição com tipos extraídos da especificação OpenAPI.
  • Um painel Try it que permite definir parâmetros e enviar uma requisição real para mainnet (ou escolher um servidor devnet no dropdown quando disponível).
  • A forma de resposta, proveniente de uma resposta ao vivo representativa e do callsite addBorderSuccess do código-fonte.
Para acesso no nível SDK — construir transações no cliente, agregar swaps, tipos TypeScript — veja sdk-api/typescript-sdk.

Ponteiros