Справочник API

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

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

Открыть английскую версию →

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

​

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

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

Сервис	Хост Mainnet	Хост Devnet	Описание
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	Пулы / минты / конфиг / информация о сети — канонический API чтения, на который полагаются UI и SDK.
Transaction API	transaction-v1.raydium.io	transaction-v1-devnet.raydium.io	Серверное построение транзакций swap / liquidity. Точка входа агрегатора.
Perps API	api-perp-v1.raydium.io	—	Параметры, метаданные активов, выбор RPC для фронтенда Raydium Perps.
LaunchLab Mint API	launch-mint-v1.raydium.io	launch-mint-v1-devnet.raydium.io	Поиск токенов, индексы, лидерборды, метаданные каждого минта для LaunchLab-запусков.
LaunchLab History API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	История торговли, K-line агрегаты для пулов LaunchLab.
LaunchLab Forum API	launch-forum-v1.raydium.io	launch-forum-v1-devnet.raydium.io	Комментарии, темы, загрузки IPFS, привязанные к запуску LaunchLab. С подписью кошелька.
LaunchLab Auth API	launch-auth-v1.raydium.io	launch-auth-v1-devnet.raydium.io	Выдаёт короткоживущие JWT ray-token из подписанного кошельком сообщения. Требуется для вызова forum API.
Dynamic IPFS API	dynamic-ipfs.raydium.io	dynamic-ipfs-devnet.raydium.io	Регенератор изображений / метаданных NFT. Управляет изображениями позиций CLMM и другими on-chain NFT, внешний вид которых зависит от динамического состояния.
Owner API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	Позиции, остатки и подлежащие получению награды в разрезе каждого кошелька.
API v1	api.raydium.io	—	Устаревшие конечные точки v1/v2, поддерживаемые для клиентов, которые не перешли на API v3.
Temp API	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 в унифицированный конверт:

{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}

При ошибке:

{
  "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.

​

Ссылки

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