Skip to main content

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.

The Dynamic IPFS API serves regenerated metadata and images for CLMM and CPMM liquidity positions on Solana. This service is designed for dApps that render dynamic NFTs—such as concentrated liquidity position cards—by providing real-time pool information, position valuation, and unclaimed fees without requiring on-chain lookups.

Hosts

EnvironmentHost
Mainnetdynamic-ipfs.raydium.io
Devnetdynamic-ipfs-devnet.raydium.io

Overview

The API exposes three endpoints, each returning a complete position interface object:
  • /clmm/position — Fetch metadata for an active CLMM position
  • /lock/clmm/position — Fetch metadata for a locked CLMM position
  • /lock/cpmm/position — Fetch metadata for a locked CPMM position
Each response includes the full pool details (tokens, decimals, TVL), position amounts, USD valuation, TVL percentage within the pool, and accumulated (but unclaimed) fees and rewards.

Use cases

Generate dynamic position visualization NFTs by requesting metadata for a specific position. The API computes real-time position state from on-chain data and caches results, making it ideal for:
  • Rendering position cards with live USD value and fee accrual
  • Displaying TVL percentage and token amounts in the pool
  • Showing unclaimed trading fees and reward tokens
  • Building portfolio dashboards that track position performance

Authentication

No authentication is required. All endpoints are public.

Rate limiting

None enforced. Best effort service.

Common patterns

Fetch a CLMM position

curl -s "https://dynamic-ipfs.raydium.io/clmm/position?id=4Ygp92zRvl4kCr97V3Zs5xg4k3qX1tN6m8pR2vL9jA1"
The id parameter should be the on-chain public key of the position account (a Solana address in base58 format).

Fetch a locked position

curl -s "https://dynamic-ipfs.raydium.io/lock/clmm/position?id=<position_pda>"
See CLMM for position account structure and how to derive position IDs.