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 →

​
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

AmbienteURL
Mainnethttps://api-v3.raydium.io
Devnethttps://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

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