REST API surface

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

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

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

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

​

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

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

Сервис	Хост mainnet	Хост devnet	Что он предоставляет
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	Canonical API чтения пулов / мinted токенов / конфигов / информации о цепи. Front door по умолчанию для UI и большинства интеграций.
Transaction API	transaction-v1.raydium.io	transaction-v1-devnet.raydium.io	Построение swap-транзакций на стороне сервера.
Perps API	api-perp-v1.raydium.io	—	Настройки, метаданные активов, выбор RPC для фронтенда Raydium Perps.
LaunchLab Mint API	launch-mint-v1.raydium.io	launch-mint-v1-devnet.raydium.io	Поиск токенов, индексы, таблицы лидеров, метаданные для конкретных мinted токенов.
LaunchLab History API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	История торговли и OHLC 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 и т. д.).
Owner API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	Позиции, балансы и заработные награды для конкретного кошелька.
API v1 (legacy)	api.raydium.io	—	Устаревшие пути /v1 и /v2, оставленные активными для клиентов, не мигрировавших на API v3.
Temp API	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-огибающую:

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

При ошибке:

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

{
  "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 повторяет это ограничение, где оно применяется.

​

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

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. Каждый сервис имеет собственную группу; кликните любой endpoint для параметров, формы ответа, примеров кода и Try-it панели.
• TypeScript SDK — sdk-api/typescript-sdk. SDK потребляет API v3 внутренне для нескольких путей; для построения транзакций всегда пере-загружает состояние из RPC, никогда не доверяет API вслепую.
• Trade API интеграция — integration-guides/aggregator. Паттерны для подключения ликвидности Raydium в многоDEX агрегатор.
• AI-friendly документация — sdk-api/ai-integration. Указатели для AI-coding агентов, которым нужно вызывать эти API.