> ## 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 IPFS Dinamis

> Regenerasi metadata NFT dinamis dan visual posisi untuk posisi likuiditas Raydium

<Info>
  **Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.**

  [Lihat versi bahasa Inggris →](/api-reference/dynamic-ipfs-v1/overview)
</Info>

API IPFS Dinamis menyediakan metadata dan gambar yang diregenerasi untuk posisi likuiditas CLMM dan CPMM di Solana. Layanan ini dirancang untuk dApp yang merender NFT dinamis—seperti kartu posisi likuiditas terkonsentrasi—dengan menyediakan informasi pool real-time, valuasi posisi, dan biaya yang belum diklaim tanpa memerlukan lookup on-chain.

## Host

| Lingkungan | Host                             |
| ---------- | -------------------------------- |
| Mainnet    | `dynamic-ipfs.raydium.io`        |
| Devnet     | `dynamic-ipfs-devnet.raydium.io` |

## Ikhtisar

API mengekspos tiga endpoint, masing-masing mengembalikan objek antarmuka posisi lengkap:

* **`/clmm/position`** — Ambil metadata untuk posisi CLMM yang aktif
* **`/lock/clmm/position`** — Ambil metadata untuk posisi CLMM yang terkunci
* **`/lock/cpmm/position`** — Ambil metadata untuk posisi CPMM yang terkunci

Setiap respons mencakup detail pool lengkap (token, desimal, TVL), jumlah posisi, valuasi USD, persentase TVL dalam pool, serta biaya dan reward yang terkumpul (tetapi belum diklaim).

## Kasus penggunaan

Hasilkan NFT visualisasi posisi dinamis dengan meminta metadata untuk posisi tertentu. API menghitung status posisi real-time dari data on-chain dan menyimpan hasil dalam cache, sehingga ideal untuk:

* Merender kartu posisi dengan nilai USD langsung dan akumulasi biaya
* Menampilkan persentase TVL dan jumlah token dalam pool
* Menunjukkan biaya trading yang belum diklaim dan token reward
* Membangun dashboard portfolio yang melacak kinerja posisi

## Otentikasi

Tidak ada otentikasi yang diperlukan. Semua endpoint adalah publik.

## Pembatasan rate

Tidak ada yang diterapkan. Layanan best effort.

## Pola umum

### Ambil posisi CLMM

```bash theme={null}
curl -s "https://dynamic-ipfs.raydium.io/clmm/position?id=4Ygp92zRvl4kCr97V3Zs5xg4k3qX1tN6m8pR2vL9jA1"
```

Parameter `id` harus berupa kunci publik on-chain dari akun posisi (alamat Solana dalam format base58).

### Ambil posisi yang terkunci

```bash theme={null}
curl -s "https://dynamic-ipfs.raydium.io/lock/clmm/position?id=<position_pda>"
```

## Dokumentasi terkait

Lihat [CLMM](/id/products/clmm) untuk struktur akun posisi dan cara menurunkan ID posisi.