API v3 de Raydium

API REST para consultar pools de liquidez, mints, granjas y datos de cadena en Raydium

Esta página fue traducida automáticamente por IA. La versión en inglés es la fuente autorizada.

Ver versión en inglés →

​

¿Qué es la API v3 de Raydium?

La API v3 de Raydium proporciona una interfaz REST para consultar pools de liquidez, metadatos de tokens, granjas y estadísticas de cadena en los venues de trading de Raydium en Solana. Es utilizada por monederos, agregadores, routers de DEX y traders para obtener datos canónicos de pools, feeds de precios y análisis históricos.

La API está diseñada para alto rendimiento: las respuestas tienen típicamente un desfase de 1–5 minutos según la sensibilidad del endpoint. Todas las respuestas se envuelven en un contenedor consistente con metadatos.

​

Hosts base

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

​

Contenedor de respuesta

Todos los endpoints devuelven un contenedor JSON con metadatos de solicitud y la carga útil de respuesta:

​

Respuesta exitosa

{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Datos específicos del endpoint
  }
}

​

Respuesta de error

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

El campo id es un identificador único de solicitud (UUID). Siempre verifica success antes de procesar data.

​

Gotchas comunes

​

Ordenamiento de pares de mints en /pools/info/mint

Cuando consultas /pools/info/mint?mint1=ABC&mint2=XYZ, el endpoint normaliza internamente el par ordenando los mints alfabéticamente. Si necesitas buscar un solo mint, omite mint2 completamente; la API encontrará todos los pools que contengan ese mint.

​

Valores de filtro de tipo de pool

El parámetro de consulta poolType acepta valores enum específicos:

• all — todos los tipos de pool
• concentrated — solo pools CLMM
• standard — solo pools AMM (producto constante)
• allFarm — pools con al menos una granja activa
• concentratedFarm — pools concentrados con granjas
• standardFarm — pools estándar con granjas

Los errores tipográficos o desajustes de mayúsculas serán rechazados.

​

Valores del campo de ordenamiento de pools

Los valores válidos de poolSortField son:

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

​

Paginación con /pools/info/list-v2

El endpoint v2 utiliza paginación basada en cursor a través de nextPageId. El token opaco se devuelve en la respuesta y debe pasarse de vuelta sin modificaciones. No intentes construir tu propio cursor; codifica el estado de Elasticsearch.

​

Valores por defecto de tamaño de página y límites

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

Las solicitudes que superan los límites se rechazan con un error.

​

Configuraciones de tarifa dinámica y orden límite de CLMM

Dos nuevos endpoints exponen datos de calibración para el flujo CreateCustomizablePool de CLMM:

• GET /main/clmm-dynamic-config — lista de tiers DynamicFeeConfig (período de filtro, período de decaimiento, factor de reducción, numerador máximo, control de tarifa dinámica). Pasa el id de uno de estos a createCustomizablePool cuando enableDynamicFee=true.
• GET /main/clmm-limit-order-config — configuración de órdenes límite por pool: si las órdenes límite están habilitadas, el monto de entrada mínimo y el limit_order_admin fuera de la cadena autorizado para liquidar órdenes completadas.

Los datos de órdenes límite por monedero (abiertas / completadas / cerradas) residen en Temp API; consulta api-reference/temp-api-v1/overview.

​

Documentación relacionada

• Descripción general de API REST
• Referencia de API
• Guía de integración para agregadores

​

Uso de ejemplo

Obtener estadísticas principales:

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

Listar los 10 mejores pools por TVL:

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

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

Obtener precios de mints:

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

Obtener pools de granjas para un token LP:

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

​

Estado y disponibilidad

La API v3 de Raydium está activa en mainnet. Para disponibilidad e incidentes, sigue a @Raydium.