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

# Raydium API v3

> REST API для запроса пулов ликвидности, минтов, ферм и данных блокчейна Raydium на Solana

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

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

## Что такое Raydium API v3?

Raydium API v3 предоставляет REST-интерфейс для запроса пулов ликвидности, метаданных токенов, ферм и статистики блокчейна на всех торговых площадках Raydium в Solana. Его используют кошельки, агрегаторы, DEX-маршрутизаторы и трейдеры для получения канонических данных о пулах, ценовых фидов и исторической аналитики.

API спроектирован на высокую пропускную способность — ответы обычно устаревают на 1–5 минут в зависимости от чувствительности эндпоинта. Все ответы упакованы в единую оболочку с метаданными.

## Базовые хосты

| Окружение   | URL                                |
| ----------- | ---------------------------------- |
| **Mainnet** | `https://api-v3.raydium.io`        |
| **Devnet**  | `https://api-v3-devnet.raydium.io` |

## Оболочка ответа

Все эндпоинты возвращают JSON-оболочку с метаданными запроса и полезной нагрузкой ответа:

### Успешный ответ

```json theme={null}
{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Endpoint-specific data
  }
}
```

### Ошибка ответа

```json theme={null}
{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}
```

Поле `id` — уникальный идентификатор запроса (UUID). Всегда проверяйте `success` перед обработкой `data`.

## Типичные подводные камни

### Порядок пары минтов в `/pools/info/mint`

Когда вы запрашиваете `/pools/info/mint?mint1=ABC&mint2=XYZ`, эндпоинт внутри нормализует пару, отсортировав минты в алфавитном порядке. Если нужно искать один минт, полностью пропустите `mint2` — API найдёт все пулы, содержащие этот минт.

### Значения фильтра типа пула

Параметр запроса `poolType` принимает конкретные значения перечисления:

* `all` — все типы пулов
* `concentrated` — только CLMM пулы
* `standard` — только AMM пулы (с постоянным произведением)
* `allFarm` — пулы с хотя бы одной активной фермой
* `concentratedFarm` — концентрированные пулы с фермами
* `standardFarm` — стандартные пулы с фермами

Опечатки или несовпадения в чувствительности к регистру будут отклонены.

### Значения поля сортировки пула

Допустимые значения `poolSortField`:

* `default` (сортировка по объёму за 24 ч)
* `liquidity` (TVL)
* `volume24h`, `volume7d`, `volume30d`
* `fee24h`, `fee7d`, `fee30d`
* `apr24h`, `apr7d`, `apr30d`

### Постраничный переход с `/pools/info/list-v2`

Эндпоинт v2 использует постраничный переход на основе курсора через `nextPageId`. Непрозрачный токен возвращается в ответе и должен быть передан обратно без изменений. Не пытайтесь конструировать свой собственный курсор — он кодирует состояние Elasticsearch.

### Размер страницы по умолчанию и лимиты

* `/pools/info/list` и `/pools/info/mint` ограничивают `pageSize` **1000**.
* `/farms/info/lp` ограничивает `pageSize` **100**.
* `/pools/info/list-v2` ограничивает `size` **1000**.

Запросы, превышающие лимиты, отклоняются с ошибкой.

### Конфигурации CLMM с динамическими комиссиями и лимит-ордерами

Два новых эндпоинта предоставляют данные калибровки для flow `CreateCustomizablePool` CLMM:

* `GET /main/clmm-dynamic-config` — список уровней `DynamicFeeConfig` (период фильтрации, период затухания, коэффициент снижения, максимальный числитель, управление динамической комиссией). Передайте `id` одного из них в `createCustomizablePool` при `enableDynamicFee=true`.
* `GET /main/clmm-limit-order-config` — конфигурация лимит-ордеров для каждого пула: включены ли лимит-ордеры, минимальная сумма ввода и внецепевой `limit_order_admin` хранитель, авторизованный на расчёт заполненных ордеров.

Данные лимит-ордеров для каждого кошелька (открытые / заполненные / закрытые) находятся в Temp API; см. [`api-reference/temp-api-v1/overview`](/ru/api-reference/temp-api-v1/overview).

## Смежная документация

* [Обзор REST API](/ru/sdk-api/rest-api)
* [Справочник API](/ru/api-reference)
* [Руководство по интеграции для агрегаторов](/ru/integration-guides/aggregator)

## Примеры использования

**Получить основную статистику:**

```bash theme={null}
curl -s https://api-v3.raydium.io/main/info | jq .
```

**Список топ-10 пулов по TVL:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
```

**Получить пулы SOL-USDC:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/pools/info/mint?mint1=So11111111111111111111111111111111111111112&mint2=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&poolType=all&poolSortField=liquidity&sortType=desc&pageSize=5&page=1' | jq .
```

**Получить цены минтов:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
```

**Получить пулы ферм для LP токена:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .
```

## Статус и доступность

Raydium API v3 работает на mainnet. О доступности и инцидентах следите в [@Raydium](https://x.com/Raydium).