Referência de API

Catálogo de todas as APIs HTTP operadas pela Raydium: dados de pools, construção de transações, perps, serviços de fórum / mint / histórico / autenticação do LaunchLab, gateway IPFS, posições do proprietário e a API Python legada. Os endpoints listados abaixo abrem um playground interativo.

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-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

• 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 por api-v3 se resolve para um destes.