Перейти к основному содержанию

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.

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

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

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