API da Raydium: o que ela cobre e o que falta na Solana

Escrevem sobre a Raydium como se ela não tivesse API, geralmente gente vendendo uma. Isso não é verdade, e vale dizer logo de cara: a API da Raydium funciona, é grátis para chamar, e para muitos casos é a escolha certa.

A seguir está a lista completa de endpoints lida direto do próprio documento OpenAPI da Raydium, as duas categorias de dados que realmente faltam nele, e como estava o resto da Solana em 22 de setembro de 2026. O método está no final, incluindo um número em que nossos dados e os da Raydium discordam, e eu ainda não resolvi qual está certo.

O que a API da Raydium realmente entrega

A Raydium API v3 publica uma página Swagger em api-v3.raydium.io/docs. Por trás dela existe um documento OpenAPI com exatamente 27 paths, todos GET. Agrupados pelo que servem:

É mesmo sem chave. Nada para se cadastrar, nenhum header para enviar:

As respostas voltam no formato {id, success, data}, o que é organizado e fácil de tratar. Se o que você precisa é "descrever esse pool da Raydium" ou "quanto a Raydium acha que esse token vale agora", pare de ler e vá usar. É grátis, é rápido, e é o próprio relato do protocolo sobre si mesmo.

As duas coisas que não estão nela

Procurei nos 27 paths pelas palavras que você esperaria encontrar se algum dos dois recursos existisse. Nada bateu com ohlc, candle, kline, chart, trade, swap, tx ou history.

Não há candles de preço. /mint/price te dá o preço agora. Pergunte de novo daqui a uma hora e você recebe o preço daquele momento. Nada na API entrega um open, high, low e close de um período, então um gráfico é algo que você mesmo precisa construir e armazenar, uma amostra de cada vez, a partir do dia em que você começa a fazer polling. Backfill não é uma opção porque o histórico nunca foi exposto.

Não há feed de swaps. O mais próximo disso é /pools/line/liquidity, que desenha a liquidez ao longo do tempo. Isso é uma pergunta diferente de quem negociou, em que tamanho e a que preço. Se você quer dados por negociação vindos da própria API da Raydium, eles não estão lá, e a alternativa é você mesmo fazer o parsing das transações da Solana contra os programas AMM, CLMM e CPMM.

Nenhuma das duas ausências é uma crítica. A Raydium construiu uma API que serve a interface da Raydium, e as duas lacunas ficam fora do que essa interface precisa.

Em 22 de setembro de 2026, a Raydium era 5% do volume das DEXes na Solana

Esta é a parte que decide se uma API só da Raydium é o formato certo para o que você está construindo. Aqui está toda DEX indexada na Solana naquele dia, por volume de 24 horas:

As duas entradas da Raydium somam US$ 238.316.633, o que é 5,1% do dia. A PumpSwap sozinha foi 66,7%.

Compare isso com o que as pessoas realmente pedem a uma API de DEX na Solana. A pergunta de sempre é "quanto vale esse token e onde ele está sendo negociado", e para um token lançado neste mês a resposta é, com muita frequência, PumpSwap ou Pump.fun, não Raydium. Uma integração só com a Raydium responde essa pergunta corretamente para os pools que a Raydium tem, e não retorna nada para o resto da chain, sem nenhum erro para te avisar em qual dos dois casos você está.

Onde o nosso número e o da Raydium discordam

O próprio /main/info da Raydium reportou US$ 576.515.472 de volume em 24 horas naquele mesmo dia. Nós medimos US$ 238.316.633 somando as duas entradas da Raydium que indexamos. É uma diferença de cerca de US$ 338 milhões, e eu não vou fingir que ela não existe.

O que eu posso mostrar é que a Raydium roda três programas on-chain, não dois. AMM v4 e CLMM estão os dois no nosso índice. CPMM é um programa separado, com seu próprio endpoint de configuração, /main/cpmm-config, ao lado de /main/clmm-config, e não aparece na nossa lista de DEXes sob nenhum id. Então pelo menos parte da diferença é um programa que não estamos cobrindo, e isso já está registrado como um bug de cobertura do nosso lado, não como uma nota de rodapé num artigo.

O resto pode ser regra de contagem. Protocolos e indexadores discordam o tempo todo sobre volume roteado e sobre quais produtos de um protocolo entram no número principal, e a Raydium tem todo o direito de contar a própria atividade do jeito dela.

Veja a fatia dos dois jeitos. No nosso número, a Raydium é 5,1% do volume de DEXes na Solana. Substituindo pelo número da própria Raydium e ajustando o total da chain, dá 11,4%. O ponto desta seção sobrevive às duas contas: a Raydium é minoria na chain, e uma API no formato da Raydium é o formato errado para uma pergunta que envolve a Solana inteira.

Candles e swaps de um pool da Raydium

As duas coisas que faltam na API da Raydium são exatamente as duas coisas para as quais uma API de dados de DEX existe. As duas chamadas abaixo rodaram contra a DexPaprika em 22 de setembro de 2026, contra um pool CLMM da Raydium que movimenta US$ 49,5 milhões por dia. Os candles não precisam de chave; desde 30 de setembro de 2026 o feed de swaps precisa de um plano Dev ou Pro.

Candles de hora em hora, que a API da Raydium não consegue te dar de jeito nenhum:

Isso retorna um array de candles, cada um trazendo time_open, time_close, open, high, low, close e volume. Troque 1h por um intervalo menor e o formato não muda.

Swaps individuais, que também não estão na API da Raydium, em api-pro.dexpaprika.com com sua chave sozinha no header Authorization:

Cada linha traz sender e recipient, token_0_symbol e token_1_symbol, os dois valores, price_0_usd e price_1_usd, além de created_at, created_at_block_number, log_index e factory_id. Esse último diz por qual programa a negociação passou, o que importa numa chain onde um único protocolo roda três deles.

As mesmas duas chamadas funcionam contra Orca, Meteora, PumpSwap e o resto da lista acima sem mudar de formato, e esse é todo o argumento a favor de um índice no nível da chain em vez de um no nível do protocolo.

Sem chave já basta para testar os candles. Uma chave gratuita em console.dexpaprika.com aumenta a taxa e a cota, e os números atuais de cada plano estão na página de preços, não neste artigo, porque eles mudam. Vale saber antes de construir: os dados do plano gratuito podem ter até 60 segundos de atraso, e tempo real é o plano pago.

Perguntas comuns

A Raydium tem uma API?

Sim. A Raydium API v3 em api-v3.raydium.io, 27 endpoints GET, documentada em api-v3.raydium.io/docs e na própria documentação da Raydium, na seção de referência de API.

Você precisa de uma chave de API para a Raydium?

Não. Todo endpoint que chamei em 22 de setembro de 2026 respondeu 200 sem chave e sem nenhum tipo de header de autenticação.

Quais são os rate limits da API da Raydium?

A Raydium não publica nenhum, e as respostas não trazem headers ratelimit-* de onde ler um orçamento. O serviço fica atrás do Cloudflare, então trate como um limite que existe mas não é divulgado: espace suas chamadas e recue diante de qualquer coisa que não seja um 200.

A API da Raydium dá preços históricos ou OHLCV?

Não. Não existe endpoint de candle, OHLCV ou kline na especificação. /mint/price retorna só o preço atual, e /pools/line/liquidity é liquidez ao longo do tempo, não preço.

Dá para obter o histórico de swaps da Raydium pela API?

Não pela própria API da Raydium. Dados por negociação significam fazer o parsing das transações da Solana contra os programas AMM, CLMM e CPMM você mesmo, ou ler de um índice que já faz isso.

Qual DEX da Solana eu devo indexar primeiro?

Em 22 de setembro de 2026, a PumpSwap carregava dois terços do volume de DEXes da chain, e a Pump.fun tinha 46.537 pools, mais do que qualquer outra venue da lista. Se você está cobrindo tokens novos, é lá que eles estão. Se está cobrindo pares consolidados, Orca e Raydium CLMM importam mais. Cobrir só uma venue eventualmente vai fazer você precificar algo errado.

Como esses números foram medidos

Tudo acima foi lido direto de uma fonte ao vivo em 22 de setembro de 2026.

A contagem de endpoints e os agrupamentos vêm do próprio documento OpenAPI da Raydium, que a página Swagger carrega em api-v3.raydium.io/docs/swagger-ui-init.js. Eu fiz o parsing do documento em vez de ler a página renderizada, então o número 27 é da própria especificação, não meu. A ausência de endpoints de candle e de negociação é uma busca nos 27 paths por oito termos, listados acima para você repetir.

Os números de volume e TVL da Raydium vêm de um único GET /main/info sem chave. A tabela da Solana vem de um único GET /networks/solana/dexes sem chave contra api.dexpaprika.com, com cada número vindo da mesma resposta para que as linhas e o total batam. As chamadas de OHLCV e de transações estão citadas ao pé da letra, e as duas retornaram 200.

A diferença de US$ 338 milhões continua sem solução e está registrada do nosso lado como uma questão de cobertura, não deixada como nota de rodapé de artigo. Onde uma afirmação deste texto depende dela, eu apresentei a fatia dos dois jeitos.

Todo número de volume é uma janela de 24 horas que se encerra no momento da medição, então espere movimento. A composição da Solana é a parte com mais chance de parecer diferente daqui a um mês: o ranking aqui é impulsionado por lançamentos de tokens, que é exatamente o tipo de atividade que muda as venues rapidamente.

Referência REST completa em docs.dexpaprika.com. Existem páginas por DEX com feed de swaps ao vivo para Raydium, Orca, Meteora, PumpSwap e Pump.fun.

A mesma pergunta para outras duas DEXes: o que a API da Uniswap retorna, e o que a PancakeSwap documenta para a BNB Smart Chain.