Saltar al contenido 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 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

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

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