REST API surface

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.

​

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

​

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

​

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

​

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

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

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

​

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

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

​

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

​

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

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

​

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

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

​

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

​

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

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.