> ## 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.

# Dynamic IPFS API

> 為 Raydium 流動性質押位置重新產生動態 NFT 中繼資料和位置視覺效果

<Info>
  **本頁內容由 AI 自動翻譯，所有內容以英文版本為準。**

  [查看英文版 →](/api-reference/dynamic-ipfs-v1/overview)
</Info>

Dynamic IPFS API 為 Solana 上的 CLMM 和 CPMM 流動性位置提供重新產生的中繼資料和圖像。此服務專為轉譯動態 NFT 的 dApp 而設計，例如集中流動性位置卡片，可提供即時池資訊、位置估值和未領取的費用，無需進行鏈上查詢。

## 主機

| 環境      | 主機                               |
| ------- | -------------------------------- |
| Mainnet | `dynamic-ipfs.raydium.io`        |
| Devnet  | `dynamic-ipfs-devnet.raydium.io` |

## 概述

此 API 公開三個端點，每個端點都會傳回完整的位置介面物件：

* **`/clmm/position`** — 取得活躍 CLMM 位置的中繼資料
* **`/lock/clmm/position`** — 取得鎖定 CLMM 位置的中繼資料
* **`/lock/cpmm/position`** — 取得鎖定 CPMM 位置的中繼資料

每個回應都包含完整的池詳細資訊（代幣、小數點、TVL）、位置金額、美元估值、池內 TVL 百分比，以及累積（但未領取）的費用和獎勵。

## 使用案例

透過請求特定位置的中繼資料來產生動態位置視覺化 NFT。此 API 從鏈上資料計算即時位置狀態並快取結果，適合用於：

* 轉譯具有即時美元價值和費用累積的位置卡片
* 顯示池內的 TVL 百分比和代幣金額
* 顯示未領取的交易費用和獎勵代幣
* 建立追蹤位置效能的投資組合儀表板

## 驗證

無需驗證。所有端點均為公開。

## 速率限制

無強制限制。盡力服務。

## 常見模式

### 取得 CLMM 位置

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

`id` 參數應為位置帳戶的鏈上公鑰（Solana base58 格式的地址）。

### 取得鎖定位置

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

## 相關文件

請參閱 [CLMM](/zh-Hant/products/clmm) 以了解位置帳戶結構及如何衍生位置 ID。