Raydium API v3

API REST para consultar pools de liquidez, mints, farms e dados da blockchain no Raydium do Solana

Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.

Ver versão em inglês →

​

O que é Raydium API v3?

Raydium API v3 oferece uma interface REST para consultar pools de liquidez, metadados de tokens, farms e estatísticas da blockchain nos venues de trading do Raydium no Solana. Ela é utilizada por wallets, agregadores, roteadores DEX e traders para obter dados canônicos de pools, feeds de preços e análises históricas.

A API foi projetada para alto throughput — as respostas têm tipicamente entre 1–5 minutos de atraso dependendo da sensibilidade do endpoint. Todas as respostas são envolvidas em um envelope consistente com metadados.

​

Hosts base

Ambiente	URL
Mainnet	https://api-v3.raydium.io
Devnet	https://api-v3-devnet.raydium.io

​

Envelope de resposta

Todos os endpoints retornam um envelope JSON com metadados da requisição e o payload da resposta:

​

Resposta de sucesso

{
  "id": "abc123def456",
  "success": true,
  "data": {
    // dados específicos do endpoint
  }
}

​

Resposta de erro

{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}

O campo id é um identificador único de requisição (UUID). Sempre inspecione success antes de processar data.

​

Armadilhas comuns

​

Ordenação de pares de mints em /pools/info/mint

Quando você consulta /pools/info/mint?mint1=ABC&mint2=XYZ, o endpoint normaliza internamente o par ordenando os mints alfabeticamente. Se você precisa buscar um único mint, omita mint2 inteiramente — a API encontrará todos os pools que contêm esse mint.

​

Valores de filtro de tipo de pool

O parâmetro de query poolType aceita valores de enum específicos:

• all — todos os tipos de pool
• concentrated — apenas pools CLMM
• standard — apenas pools AMM (constant-product)
• allFarm — pools com pelo menos uma farm ativa
• concentratedFarm — pools concentrados com farms
• standardFarm — pools standard com farms

Erros de digitação ou incompatibilidades de sensibilidade de maiúsculas serão rejeitados.

​

Valores de campo de ordenação de pool

Os valores válidos de poolSortField são:

• default (ordena por volume 24h)
• liquidity (TVL)
• volume24h, volume7d, volume30d
• fee24h, fee7d, fee30d
• apr24h, apr7d, apr30d

​

Paginação com /pools/info/list-v2

O endpoint v2 utiliza paginação baseada em cursor via nextPageId. O token opaco é retornado na resposta e deve ser passado de volta de forma idêntica. Não tente construir seu próprio cursor — ele codifica o estado do Elasticsearch.

​

Padrões e limites de tamanho de página

• /pools/info/list e /pools/info/mint limitam pageSize a 1000.
• /farms/info/lp limita pageSize a 100.
• /pools/info/list-v2 limita size a 1000.

Requisições que excedem os limites são rejeitadas com um erro.

​

Configurações dinâmicas de taxa e limite de CLMM

Dois novos endpoints expõem dados de calibração para o fluxo CreateCustomizablePool do CLMM:

• GET /main/clmm-dynamic-config — lista de tiers de DynamicFeeConfig (período de filtro, período de decaimento, fator de redução, numerador máximo, controle de taxa dinâmica). Passe o id de um desses ao chamar createCustomizablePool quando enableDynamicFee=true.
• GET /main/clmm-limit-order-config — configuração de limite de pedidos por pool: se limites de pedidos estão habilitados, o valor mínimo de entrada e o limit_order_admin off-chain autorizado a liquidar pedidos preenchidos.

Dados de limite de pedidos por wallet (abertos / preenchidos / fechados) ficam na Temp API; veja api-reference/temp-api-v1/overview.

​

Documentação relacionada

• Visão geral da API REST
• Referência de API
• Guia de integração para agregadores

​

Exemplo de uso

Obter estatísticas principais:

curl -s https://api-v3.raydium.io/main/info | jq .

Listar os 10 principais pools por TVL:

curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .

Obter pools SOL-USDC:

curl -s 'https://api-v3.raydium.io/pools/info/mint?mint1=So11111111111111111111111111111111111111112&mint2=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&poolType=all&poolSortField=liquidity&sortType=desc&pageSize=5&page=1' | jq .

Obter preços de mints:

curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .

Obter pools de farm para um token LP:

curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .

​

Status e disponibilidade

A Raydium API v3 está ativa na mainnet. Para disponibilidade e incidentes, siga @Raydium.