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 →
L’API IPFS dynamique fournit des métadonnées et des images régénérées pour les positions de liquidité CLMM et CPMM sur Solana. Ce service est conçu pour les dApps qui affichent des NFT dynamiques — comme les cartes de position de liquidité concentrée — en fournissant les informations du pool en temps réel, l’évaluation de la position et les frais non réclamés sans nécessiter de consultations on-chain.

Hôtes

EnvironnementHôte
Mainnetdynamic-ipfs.raydium.io
Devnetdynamic-ipfs-devnet.raydium.io

Présentation

L’API expose trois endpoints, chacun renvoyant un objet d’interface de position complet :
  • /clmm/position — Récupérer les métadonnées d’une position CLMM active
  • /lock/clmm/position — Récupérer les métadonnées d’une position CLMM verrouillée
  • /lock/cpmm/position — Récupérer les métadonnées d’une position CPMM verrouillée
Chaque réponse inclut les détails complets du pool (tokens, décimales, TVL), les montants de la position, l’évaluation en USD, le pourcentage de TVL dans le pool, et les frais et récompenses accumulés (mais non réclamés).

Cas d’usage

Générez des NFT de visualisation de position dynamiques en demandant les métadonnées d’une position spécifique. L’API calcule l’état de la position en temps réel à partir des données on-chain et met en cache les résultats, ce qui la rend idéale pour :
  • Afficher des cartes de position avec la valeur USD en direct et l’accumulation de frais
  • Afficher le pourcentage de TVL et les montants de tokens dans le pool
  • Montrer les frais de trading non réclamés et les tokens de récompense
  • Construire des tableaux de bord de portefeuille qui suivent la performance de la position

Authentification

Aucune authentification requise. Tous les endpoints sont publics.

Limitation de débit

Aucune limite appliquée. Service au meilleur effort.

Motifs courants

Récupérer une position CLMM

curl -s "https://dynamic-ipfs.raydium.io/clmm/position?id=4Ygp92zRvl4kCr97V3Zs5xg4k3qX1tN6m8pR2vL9jA1"
Le paramètre id doit être la clé publique on-chain du compte de position (une adresse Solana au format base58).

Récupérer une position verrouillée

curl -s "https://dynamic-ipfs.raydium.io/lock/clmm/position?id=<position_pda>"

Documentation associée

Consultez CLMM pour la structure du compte de position et comment dériver les identifiants de position.