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ço | Host Mainnet | Host Devnet | O que faz |
|---|---|---|---|
| API v3 | api-v3.raydium.io | api-v3-devnet.raydium.io | Pool / mint / config / chain-info — a API de leitura canônica em que a UI e o SDK se baseiam. |
| Transaction API | transaction-v1.raydium.io | transaction-v1-devnet.raydium.io | Construção de transações de swap / liquidez no lado do servidor. O ponto de entrada do agregador. |
| Perps API | api-perp-v1.raydium.io | — | Configurações, metadados de ativos, seleção de RPC para o front-end do Raydium Perps. |
| LaunchLab Mint API | launch-mint-v1.raydium.io | launch-mint-v1-devnet.raydium.io | Busca de tokens, índices, placares, metadados por mint para launches do LaunchLab. |
| LaunchLab History API | launch-history-v1.raydium.io | launch-history-v1-devnet.raydium.io | Histórico de transações, agregados de K-line para pools do LaunchLab. |
| LaunchLab Forum API | launch-forum-v1.raydium.io | launch-forum-v1-devnet.raydium.io | Comentários, threads, uploads IPFS vinculados a um launch do LaunchLab. Com assinatura de carteira. |
| LaunchLab Auth API | launch-auth-v1.raydium.io | launch-auth-v1-devnet.raydium.io | Emite 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 API | dynamic-ipfs.raydium.io | dynamic-ipfs-devnet.raydium.io | Regenerador 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 API | owner-v1.raydium.io | owner-v1-devnet.raydium.io | Posições por carteira, saldos, recompensas reclamáveis. |
| API v1 | api.raydium.io | — | Endpoints v1/v2 legados, mantidos ativo para clientes que ainda não migraram para API v3. |
| Temp API | temp-api-v1.raydium.io | temp-api-v1-devnet.raydium.io | Zona 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-v1para cunhar umray-token, depois transportado como headerray-tokenporlaunch-forum-v1. Assine uma mensagem Solana ed25519 da formatime:<unix-seconds>com sua carteira, envie a assinatura + endereço da carteira para/request-tokendelaunch-auth-v1, receba um JWT de volta e passe-o como header de requisiçãoray-tokenem 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.
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 comoHTTP 429 com um header Retry-After.
Envelope de resposta
A maioria dos serviços envolve seus payloads JSON em um envelope uniforme: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
addBorderSuccessdo código-fonte.
sdk-api/typescript-sdk.
Ponteiros
sdk-api/rest-api— visão geral narrativa da superfície REST, escrita para integradores pela primeira vez.integration-guides/aggregator— como usar a Transaction API junto com pools on-chain.reference/program-addresses— todo ID de programa retornado porapi-v3se resolve para um destes.


