Passer au contenu 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.

Cette page est traduite automatiquement par IA. La version anglaise fait foi.Voir la version anglaise →

​
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

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

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

​
Réponse d’erreur

{
  "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.

​
Documentation connexe

​
Exemples d’utilisation

Obtenir les statistiques principales : 
curl -s https://api-v3.raydium.io/main/info | jq .
Lister les 10 meilleurs pools par TVL : 
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 : 
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 : 
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
Obtenir les pools de fermes pour un jeton LP : 
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.