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

> Каталог всех HTTP API, управляемых Raydium: данные о пулах, построение транзакций, перпы, сервисы LaunchLab (форум, минт, история, аутентификация), шлюз IPFS, позиции по владельцам и устаревший Python API. Ниже перечислены конечные точки с интерактивной площадкой.

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

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

<Info>
  Каждая конечная точка на этом сайте имеет панель **Try it** на основе OpenAPI-площадки Mintlify. Площадка работает в браузере и обращается непосредственно к живым хостам production (или devnet). Перед отправкой запросов, требующих подписи кошелька, прочитайте раздел [Аутентификация](#authentication).
</Info>

## Каталог сервисов

Raydium управляет одиннадцатью публичными HTTP-сервисами. Каждый из них документирован как отдельная группа в навигационном дереве слева.

| Сервис                                                                | Хост Mainnet                   | Хост Devnet                           | Описание                                                                                                                                                       |
| --------------------------------------------------------------------- | ------------------------------ | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [API v3](/ru/api-reference/api-v3/overview)                           | `api-v3.raydium.io`            | `api-v3-devnet.raydium.io`            | Пулы / минты / конфиг / информация о сети — канонический API чтения, на который полагаются UI и SDK.                                                           |
| [Transaction API](/ru/api-reference/route-api-v2/overview)            | `transaction-v1.raydium.io`    | `transaction-v1-devnet.raydium.io`    | Серверное построение транзакций swap / liquidity. Точка входа агрегатора.                                                                                      |
| [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`    | Поиск токенов, индексы, лидерборды, метаданные каждого минта для LaunchLab-запусков.                                                                           |
| [LaunchLab History API](/ru/api-reference/launch-history-v1/overview) | `launch-history-v1.raydium.io` | `launch-history-v1-devnet.raydium.io` | История торговли, 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 и другими on-chain NFT, внешний вид которых зависит от динамического состояния. |
| [Owner API](/ru/api-reference/owner-api-v1/overview)                  | `owner-v1.raydium.io`          | `owner-v1-devnet.raydium.io`          | Позиции, остатки и подлежащие получению награды в разрезе каждого кошелька.                                                                                    |
| [API v1](/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`       | Место для короткоживущих специальных конечных точек. Сейчас показывает сводки по комиссиям создателей CPMM. Может измениться без предупреждения.               |

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

Большинство сервисов предназначены только для чтения и принимают анонимные запросы. Используются два паттерна:

* **Рукопожатие с подписью кошелька** — требуется для `launch-auth-v1` для выпуска `ray-token`, затем передаётся как заголовок `ray-token` для `launch-forum-v1`. Подпишите Solana ed25519-сообщение вида `time:<unix-seconds>` своим кошельком, отправьте подпись + адрес кошелька на `/request-token` в `launch-auth-v1`, получите JWT и передавайте его в качестве заголовка запроса `ray-token` при последующих вызовах форума.
* **Без аутентификации** — все остальные сервисы. Доверенные вызывающие (Raydium UI, интеграторы) обращаются к конечным точкам напрямую по HTTPS.

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

## Ограничения скорости

Все хосты находятся за Cloudflare с прогрессивным ограничением скорости на IP источника.

Интеграторам, нуждающимся в более высоких лимитах, следует связаться с командой Raydium. Всплески выше опубликованных лимитов возвращаются как `HTTP 429` с заголовком `Retry-After`.

## Конверт ответа

Большинство сервисов оборачивают свои JSON-payload в унифицированный конверт:

```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
}
```

`api-v3` возвращает конверт как `{ "id", "success", "data" }`. Сервисы pump-\* используют вспомогательные функции `addBorderSuccess` / `addBorderErr`, которые выдают ту же форму с заполнением `msg` только при ошибках. Проверьте начальную страницу каждого сервиса для точного конверта, который он использует.

## Как использовать этот раздел

Нажмите на любую конечную точку в левой навигации. Вы увидите:

* HTTP-метод, полный URL и базовый хост.
* Параметры запроса с типами из спецификации OpenAPI.
* Панель **Try it**, которая позволяет задать параметры и отправить реальный запрос на mainnet (или выбрать сервер devnet из выпадающего списка, если доступно).
* Форму ответа на основе репрезентативного живого ответа и сайта исходного кода `addBorderSuccess`.

Для доступа на уровне SDK — построение транзакций на клиенте, батчинг свопов, типы TypeScript — см. [`sdk-api/typescript-sdk`](/ru/sdk-api/typescript-sdk).

## Ссылки

* [`sdk-api/rest-api`](/ru/sdk-api/rest-api) — обзор REST поверхности для разработчиков, впервые интегрирующих Raydium.
* [`integration-guides/aggregator`](/ru/integration-guides/aggregator) — как использовать Transaction API вместе с on-chain пулами.
* [`reference/program-addresses`](/ru/reference/program-addresses) — все ID программ, возвращаемые `api-v3`, соответствуют одному из этих.
