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

# API v3 de Raydium

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

<Info>
  **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 →](/api-reference/api-v3/overview)
</Info>

## ¿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

```json theme={null}
{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Datos específicos del endpoint
  }
}
```

### Respuesta de error

```json theme={null}
{
  "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`](/es/api-reference/temp-api-v1/overview).

## Documentación relacionada

* [Descripción general de API REST](/es/sdk-api/rest-api)
* [Referencia de API](/es/api-reference)
* [Guía de integración para agregadores](/es/integration-guides/aggregator)

## Uso de ejemplo

**Obtener estadísticas principales:**

```bash theme={null}
curl -s https://api-v3.raydium.io/main/info | jq .
```

**Listar los 10 mejores pools por TVL:**

```bash theme={null}
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:**

```bash theme={null}
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:**

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

**Obtener pools de granjas para un token LP:**

```bash theme={null}
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](https://x.com/Raydium).