> ## 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 pour interroger les pools de liquidité, les jetons, les fermes et les données de chaîne de Raydium sur Solana

<Info>
  **Cette page est traduite automatiquement par IA. La version anglaise fait foi.**

  [Voir la version anglaise →](/api-reference/api-v3/overview)
</Info>

## Qu'est-ce que l'API v3 de Raydium ?

L'API v3 de Raydium fournit une interface REST pour interroger les pools de liquidité, les métadonnées de jetons, les fermes et les statistiques de chaîne sur tous les lieux de trading de Raydium sur Solana. Elle est utilisée par les portefeuilles, les agrégateurs, les routeurs DEX et les traders pour accéder aux données canoniques des pools, aux flux de prix et aux analyses historiques.

L'API est conçue pour un débit élevé — les réponses sont généralement obsolètes de 1 à 5 minutes selon la sensibilité de l'endpoint. Toutes les réponses sont enveloppées dans un format cohérent avec des métadonnées.

## Hôtes de base

| Environnement | URL                                |
| ------------- | ---------------------------------- |
| **Mainnet**   | `https://api-v3.raydium.io`        |
| **Devnet**    | `https://api-v3-devnet.raydium.io` |

## Enveloppe de réponse

Tous les endpoints retournent une enveloppe JSON avec les métadonnées de la requête et le payload de réponse :

### Réponse réussie

```json theme={null}
{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Données spécifiques à l'endpoint
  }
}
```

### Réponse d'erreur

```json theme={null}
{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}
```

Le champ `id` est un identifiant de requête unique (UUID). Vérifiez toujours `success` avant de traiter `data`.

## Pièges courants

### Ordonnancement des paires de jetons sur `/pools/info/mint`

Lorsque vous interrogez `/pools/info/mint?mint1=ABC&mint2=XYZ`, l'endpoint normalise en interne la paire en triant les jetons alphabétiquement. Si vous devez rechercher un seul jeton, omettez entièrement `mint2` — l'API trouvera tous les pools contenant ce jeton.

### Valeurs du filtre de type de pool

Le paramètre de requête `poolType` accepte des valeurs d'énumération spécifiques :

* `all` — tous les types de pools
* `concentrated` — pools CLMM uniquement
* `standard` — pools AMM (produit constant) uniquement
* `allFarm` — pools avec au moins une ferme active
* `concentratedFarm` — pools concentrés avec fermes
* `standardFarm` — pools standards avec fermes

Les fautes de frappe ou les incohérences de casse seront rejetées.

### Valeurs du champ de tri des pools

Les valeurs valides de `poolSortField` sont :

* `default` (trie par volume sur 24h)
* `liquidity` (TVL)
* `volume24h`, `volume7d`, `volume30d`
* `fee24h`, `fee7d`, `fee30d`
* `apr24h`, `apr7d`, `apr30d`

### Pagination avec `/pools/info/list-v2`

L'endpoint v2 utilise la pagination basée sur un curseur via `nextPageId`. Le token opaque est retourné dans la réponse et doit être repassé tel quel. N'essayez pas de construire votre propre curseur — il encode l'état d'Elasticsearch.

### Valeurs par défaut et limites de la taille de page

* `/pools/info/list` et `/pools/info/mint` limitent `pageSize` à **1000**.
* `/farms/info/lp` limite `pageSize` à **100**.
* `/pools/info/list-v2` limite `size` à **1000**.

Les requêtes dépassant les limites sont rejetées avec une erreur.

### Configurations CLMM avec frais dynamiques et ordres limités

Deux nouveaux endpoints exposent les données de calibration pour le flux `CreateCustomizablePool` de CLMM :

* `GET /main/clmm-dynamic-config` — liste des tiers de `DynamicFeeConfig` (période de filtrage, période de décroissance, facteur de réduction, numérateur maximal, contrôle des frais dynamiques). Transmettez l'`id` de l'un d'eux à `createCustomizablePool` lorsque `enableDynamicFee=true`.
* `GET /main/clmm-limit-order-config` — configuration des ordres limités par pool : si les ordres limités sont activés, le montant minimal en entrée et le keeper `limit_order_admin` hors chaîne autorisé à régler les ordres remplis.

Les données par portefeuille des ordres limités (ouverts / remplis / fermés) se trouvent sur Temp API ; voir [`api-reference/temp-api-v1/overview`](/fr/api-reference/temp-api-v1/overview).

## Documentation connexe

* [Aperçu de l'API REST](/fr/sdk-api/rest-api)
* [Référence API](/fr/api-reference)
* [Guide d'intégration pour les agrégateurs](/fr/integration-guides/aggregator)

## Exemples d'utilisation

**Obtenir les statistiques principales :**

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

**Lister les 10 meilleurs pools par 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 .
```

**Obtenir les 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 .
```

**Obtenir les prix des jetons :**

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

**Obtenir les pools de fermes pour un jeton LP :**

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

## État et disponibilité

L'API v3 de Raydium est en ligne sur le mainnet. Pour la disponibilité et les incidents, suivez [@Raydium](https://x.com/Raydium).