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

# REST API surface

> Высокоуровневый обзор одиннадцати публичных HTTP-сервисов Raydium — что делает каждый, общие соглашения (огибающая ответа, аутентификация, лимиты запросов, кэширование) и как выбрать правильный сервис для интеграции.

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

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

<Info>
  **Документация на уровне endpoint находится во вкладке [API Reference](/ru/api-reference).** Каждый endpoint там имеет интерактивную панель **Try it**, работающую на OpenAPI-playground от Mintlify — заполните параметры в браузере и проверьте на live mainnet (или devnet, где доступен) напрямую. Эта страница — **нарративный спутник**: какие сервисы существуют, когда использовать какой и общие соглашения, связывающие все. Если вы ищете "что принимает `GET /pools/info/ids`", переходите на API Reference; если ищете "какой сервис мне интегрировать", читайте дальше.
</Info>

## Одиннадцать сервисов вкратце

Raydium поддерживает одиннадцать публичных HTTP-сервисов. Каждый документирован как отдельная группа во вкладке [API Reference](/ru/api-reference) и имеет OpenAPI-спецификацию, питающую интерактивный playground.

| Сервис                                                                | Хост mainnet                   | Хост devnet                           | Что он предоставляет                                                                                                                 |
| --------------------------------------------------------------------- | ------------------------------ | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| [API v3](/ru/api-reference/api-v3/overview)                           | `api-v3.raydium.io`            | `api-v3-devnet.raydium.io`            | Canonical API чтения пулов / мinted токенов / конфигов / информации о цепи. Front door по умолчанию для UI и большинства интеграций. |
| [Transaction API](/ru/api-reference/route-api-v2/overview)            | `transaction-v1.raydium.io`    | `transaction-v1-devnet.raydium.io`    | Построение swap-транзакций на стороне сервера.                                                                                       |
| [Perps API](/ru/api-reference/perp-api-v1/overview)                   | `api-perp-v1.raydium.io`       | —                                     | Настройки, метаданные активов, выбор RPC для фронтенда Raydium Perps.                                                                |
| [LaunchLab Mint API](/ru/api-reference/launch-mint-v1/overview)       | `launch-mint-v1.raydium.io`    | `launch-mint-v1-devnet.raydium.io`    | Поиск токенов, индексы, таблицы лидеров, метаданные для конкретных мinted токенов.                                                   |
| [LaunchLab History API](/ru/api-reference/launch-history-v1/overview) | `launch-history-v1.raydium.io` | `launch-history-v1-devnet.raydium.io` | История торговли и OHLC k-line агрегаты для пулов LaunchLab.                                                                         |
| [LaunchLab Forum API](/ru/api-reference/launch-forum-v1/overview)     | `launch-forum-v1.raydium.io`   | `launch-forum-v1-devnet.raydium.io`   | Цепочки комментариев и загрузки IPFS на LaunchLab-лаунчи. **С подписью кошелька.**                                                   |
| [LaunchLab Auth API](/ru/api-reference/launch-auth-v1/overview)       | `launch-auth-v1.raydium.io`    | `launch-auth-v1-devnet.raydium.io`    | Выпуск недолгоживущих JWT-токенов `ray-token` из сообщения с подписью кошелька. Требуется Forum API.                                 |
| [Dynamic IPFS API](/ru/api-reference/dynamic-ipfs-v1/overview)        | `dynamic-ipfs.raydium.io`      | `dynamic-ipfs-devnet.raydium.io`      | Регенерация изображений / метаданных для динамических NFT (позиции CLMM и т. д.).                                                    |
| [Owner API](/ru/api-reference/owner-api-v1/overview)                  | `owner-v1.raydium.io`          | `owner-v1-devnet.raydium.io`          | Позиции, балансы и заработные награды для конкретного кошелька.                                                                      |
| [API v1 (legacy)](/ru/api-reference/api-v1/overview)                  | `api.raydium.io`               | —                                     | Устаревшие пути `/v1` и `/v2`, оставленные активными для клиентов, не мигрировавших на API v3.                                       |
| [Temp API](/ru/api-reference/temp-api-v1/overview)                    | `temp-api-v1.raydium.io`       | `temp-api-v1-devnet.raydium.io`       | Область для недолгоживущих специальных endpoint. **Surface может измениться без уведомления.**                                       |

Версионирование находится в **hostname** для сервисов v3 / v1 — дополнительного версионирования на уровне пути нет. Breaking changes поставляются с новым хостом с периодом перекрытия; команда публично обязалась на минимум 6 месяцев перекрытия при любой миграции v3 → v4.

## Выберите сервис

| Если вы хотите…                                                                                           | Используйте                                                    |
| --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| Читать метаданные пулов, цены, APR, конфиги комиссий                                                      | **API v3**                                                     |
| Читать метаданные мinted токенов (имя, символ, логотип, decimals, риск-теги)                              | **API v3** `/mint/list`, `/mint/price`                         |
| Построить транзакцию swap / add-liquidity / remove-liquidity на стороне сервера                           | **Transaction API**                                            |
| Показать позиции кошелька (LP-токены, позиции CLMM, доля в фармах)                                        | **Owner API**                                                  |
| Искать LaunchLab-токены, просматривать таблицы лидеров, получать метаданные для конкретного мinted токена | **LaunchLab Mint API**                                         |
| Отобразить k-line / candlestick-график для пула LaunchLab                                                 | **LaunchLab History API**                                      |
| Опубликовать или прочитать комментарии на LaunchLab-лаунче                                                | **LaunchLab Auth API** → `ray-token` → **LaunchLab Forum API** |
| Отобразить изображение NFT позиции CLMM                                                                   | **Dynamic IPFS API**                                           |
| Показать настройки фьючерсных маркетов или списки активов для Perps UI                                    | **Perps API**                                                  |
| Поддерживать совместимость с клиентом, использующим пути v1/v2 с префиксом                                | **API v1 (legacy)**                                            |

## Общие соглашения

### Огибающая ответа

Каждый сервис, кроме IPFS, возвращает одну и ту же JSON-огибающую:

```json theme={null}
{
  "id":      "uuid-v4-per-request",
  "success": true,
  "data":    { ... }
}
```

При ошибке:

```json theme={null}
{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "human-readable error string",
  "data":    null
}
```

Некоторые сервисы дополнительно включают целое число `error.code` (API v3 использует это для стабильных идентификаторов ошибок между minor-версиями). Точную форму смотрите на странице обзора каждого сервиса.

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

Встречаются два паттерна:

* **Без аутентификации** — все сервисы кроме Forum. Вызывайте их анонимно через HTTPS.
* **Handshake с подписью кошелька** — требуется для **LaunchLab Forum API**. Подпишите Solana ed25519-сообщение вида `time:<unix-seconds>` своим кошельком, отправьте подпись + адрес кошелька на **LaunchLab Auth API** `/request-token`, получите JWT и передавайте его как заголовок `ray-token` при последующих вызовах форума.

Mintlify-playground принимает `ray-token` на панели аутентификации перед отправкой запросов форума; значение хранится в браузере только.

### Лимиты запросов

Все хосты находятся за Cloudflare с прогрессивным rate-лимитингом на IP-адрес источника. Опубликованные рекомендации для интеграций:

Всплески выше опубликованных лимитов возвращают `HTTP 429` с заголовком `Retry-After`. Агрегаторы или боты, которым нужны более высокие лимиты, должны связаться с командой Raydium вместо атаки на публичные хосты — запуск собственного индексера против on-chain program IDs также опция для read-heavy рабочих нагрузок.

### Кэширование и консистентность

* Большинство read-endpoint API v3 кэшируются на edge на 5–60 секунд; конкретные TTL указаны на странице API Reference каждого endpoint.
* Кэш инвалидируется индексером на program-touching событиях, которые он наблюдает.
* Во время больших reorg или перегруженности может быть расхождение на 1–2 слота между представлением API и on-chain-состоянием. **SDK и прямые RPC-чтения всегда более актуальны** — если клиент собирается подписать транзакцию, пере-загрузите релевантные аккаунты через RPC, никогда не доверяйте значению API вслепую.

### Формат ошибок

Ошибки возвращаются как HTTP 4xx/5xx с той же огибающей (`success: false`, заполненный `msg`). API v3 дополнительно включает стабильный `error.code`:

```json theme={null}
{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "Pool not found",
  "error":   { "code": 40401, "message": "Pool not found" }
}
```

`error.code` стабилен между minor-версиями API; рассматривайте его как основной сигнал в логике клиента и `msg` как человекочитаемую поверхность.

### Соглашение аргумента mint-pair

Многие endpoint API v3 принимают `mint1=…&mint2=…` и требуют `mint1 < mint2` (порядок восходящих pubkey-байтов). Это так, чтобы API мог вернуть один и тот же canonical пул независимо от предпочитаемого порядка аргументов вызывающей стороны. Отсортируйте два мinted токена на стороне клиента перед построением URL — endpoint-документация в [API Reference](/ru/api-reference) повторяет это ограничение, где оно применяется.

## Рекомендуемые клиент-паттерны

1. **Гидрируйте один раз, обновляйте ленивым образом.** Вытащите `GET /main/info` и `GET /mint/list` (оба на API v3) при загрузке приложения и кэшируйте локально с TTL в 1 час. Оба тяжело кэшируются на edge и редко меняются.
2. **Загружайте в bulk, где endpoint это позволяет.** `GET /pools/info/ids?ids=…` принимает список через запятую — загрузите десять пулов в одном запросе, не десять запросов.
3. **Избегайте горячих path-путей для fetch цен.** `GET /mint/price` годится для UI-рендеринга; никогда не зацикливайте в боте. Для торговых ботов запустите индексер или подпишитесь на `programSubscribe`-события RPC напрямую.
4. **Зеркалируйте или проксируйте для высокого throughput.** Что угодно выше потолка опубликованного rate-limit должно подаваться из вашего собственного кэш-слоя, не напрямую с публичных хостов. Агрегаторы с sustained `>120 req/min` к `transaction-v1` должны запускать собственный quote / route engine.
5. **Пере-загружайте прямо перед подписанием.** API-ответы могут быть стариком на 5–60 секунд. Для действительно корректного снимка пула во время подписания пере-прочитайте релевантные аккаунты через SDK или прямой RPC-вызов `getMultipleAccounts`. Рассматривайте API-значения как hint для поиска, не как источник сведения.
6. **Используйте Transaction API для низкоубыточной интеграции.** Если вы не хотите включать SDK в ваш клиент (мобайл-native, бот в constrained-среде), Transaction API вернет base64-encoded versioned транзакцию для подписания пользователем. Возвращаемый `swapResponse` вкладывает quote — рассматривайте его как действительный на \~30 секунд.

## Куда дальше

* **Справочник endpoint (интерактивный)** — [API Reference](/ru/api-reference). Каждый сервис имеет собственную группу; кликните любой endpoint для параметров, формы ответа, примеров кода и Try-it панели.
* **TypeScript SDK** — [`sdk-api/typescript-sdk`](/ru/sdk-api/typescript-sdk). SDK потребляет API v3 внутренне для нескольких путей; для построения транзакций всегда пере-загружает состояние из RPC, никогда не доверяет API вслепую.
* **Trade API интеграция** — [`integration-guides/aggregator`](/ru/integration-guides/aggregator). Паттерны для подключения ликвидности Raydium в многоDEX агрегатор.
* **AI-friendly документация** — [`sdk-api/ai-integration`](/ru/sdk-api/ai-integration). Указатели для AI-coding агентов, которым нужно вызывать эти API.