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

> Пересоздание динамических метаданных NFT и визуализации позиций ликвидности Raydium

<Info>
  **Эта страница переведена с помощью ИИ. За эталон принимается английская версия.**

  [Открыть английскую версию →](/api-reference/dynamic-ipfs-v1/overview)
</Info>

Dynamic IPFS API предоставляет пересоздаваемые метаданные и изображения для позиций ликвидности CLMM и CPMM на Solana. Этот сервис предназначен для dApps, которые отображают динамические NFT—например карточки сосредоточенных позиций ликвидности—предоставляя информацию о пулах в реальном времени, оценку позиций и невостребованные комиссии без необходимости обращений в блокчейн.

## Хосты

| Окружение | Адрес                            |
| --------- | -------------------------------- |
| Mainnet   | `dynamic-ipfs.raydium.io`        |
| Devnet    | `dynamic-ipfs-devnet.raydium.io` |

## Обзор

API предоставляет три конечные точки, каждая из которых возвращает полный объект интерфейса позиции:

* **`/clmm/position`** — получить метаданные активной CLMM позиции
* **`/lock/clmm/position`** — получить метаданные заблокированной CLMM позиции
* **`/lock/cpmm/position`** — получить метаданные заблокированной CPMM позиции

Каждый ответ включает полные детали пула (токены, десятичные разряды, TVL), размеры позиции, оценку в USD, процент TVL в пуле и накопленные (но невостребованные) комиссии и награды.

## Варианты использования

Создавайте динамические визуализации позиций NFT, запрашивая метаданные для конкретной позиции. API вычисляет состояние позиции в реальном времени на основе данных блокчейна и кэширует результаты, что идеально подходит для:

* отображения карточек позиций с актуальной стоимостью в USD и накоплением комиссий;
* показа процента TVL и размеров токенов в пуле;
* отображения невостребованных торговых комиссий и токенов вознаграждений;
* создания портфельных панелей, отслеживающих производительность позиций.

## Аутентификация

Аутентификация не требуется. Все конечные точки являются публичными.

## Ограничение частоты запросов

Не применяется. Best effort сервис.

## Частые паттерны

### Получить 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](/ru/products/clmm) для структуры учетной записи позиции и способов получения ID позиций.