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

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.

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

​
Что такое Raydium API v3?

Raydium API v3 предоставляет REST-интерфейс для запроса пулов ликвидности, метаданных токенов, ферм и статистики блокчейна на всех торговых площадках Raydium в Solana. Его используют кошельки, агрегаторы, DEX-маршрутизаторы и трейдеры для получения канонических данных о пулах, ценовых фидов и исторической аналитики. API спроектирован на высокую пропускную способность — ответы обычно устаревают на 1–5 минут в зависимости от чувствительности эндпоинта. Все ответы упакованы в единую оболочку с метаданными.

​
Базовые хосты

ОкружениеURL
Mainnethttps://api-v3.raydium.io
Devnethttps://api-v3-devnet.raydium.io

​
Оболочка ответа

Все эндпоинты возвращают JSON-оболочку с метаданными запроса и полезной нагрузкой ответа:

​
Успешный ответ

{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Endpoint-specific data
  }
}

​
Ошибка ответа

{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}
Поле id — уникальный идентификатор запроса (UUID). Всегда проверяйте success перед обработкой data.

​
Типичные подводные камни

​
Порядок пары минтов в /pools/info/mint

Когда вы запрашиваете /pools/info/mint?mint1=ABC&mint2=XYZ, эндпоинт внутри нормализует пару, отсортировав минты в алфавитном порядке. Если нужно искать один минт, полностью пропустите mint2 — API найдёт все пулы, содержащие этот минт.

​
Значения фильтра типа пула

Параметр запроса poolType принимает конкретные значения перечисления:
  • all — все типы пулов
  • concentrated — только CLMM пулы
  • standard — только AMM пулы (с постоянным произведением)
  • allFarm — пулы с хотя бы одной активной фермой
  • concentratedFarm — концентрированные пулы с фермами
  • standardFarm — стандартные пулы с фермами
Опечатки или несовпадения в чувствительности к регистру будут отклонены.

​
Значения поля сортировки пула

Допустимые значения poolSortField:
  • default (сортировка по объёму за 24 ч)
  • liquidity (TVL)
  • volume24h, volume7d, volume30d
  • fee24h, fee7d, fee30d
  • apr24h, apr7d, apr30d

​
Постраничный переход с /pools/info/list-v2

Эндпоинт v2 использует постраничный переход на основе курсора через nextPageId. Непрозрачный токен возвращается в ответе и должен быть передан обратно без изменений. Не пытайтесь конструировать свой собственный курсор — он кодирует состояние Elasticsearch.

​
Размер страницы по умолчанию и лимиты

  • /pools/info/list и /pools/info/mint ограничивают pageSize 1000.
  • /farms/info/lp ограничивает pageSize 100.
  • /pools/info/list-v2 ограничивает size 1000.
Запросы, превышающие лимиты, отклоняются с ошибкой.

​
Конфигурации CLMM с динамическими комиссиями и лимит-ордерами

Два новых эндпоинта предоставляют данные калибровки для flow CreateCustomizablePool CLMM:
  • GET /main/clmm-dynamic-config — список уровней DynamicFeeConfig (период фильтрации, период затухания, коэффициент снижения, максимальный числитель, управление динамической комиссией). Передайте id одного из них в createCustomizablePool при enableDynamicFee=true.
  • GET /main/clmm-limit-order-config — конфигурация лимит-ордеров для каждого пула: включены ли лимит-ордеры, минимальная сумма ввода и внецепевой limit_order_admin хранитель, авторизованный на расчёт заполненных ордеров.
Данные лимит-ордеров для каждого кошелька (открытые / заполненные / закрытые) находятся в Temp API; см. api-reference/temp-api-v1/overview.

​
Смежная документация

​
Примеры использования

Получить основную статистику: 
curl -s https://api-v3.raydium.io/main/info | jq .
Список топ-10 пулов по TVL: 
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
Получить пулы SOL-USDC: 
curl -s 'https://api-v3.raydium.io/pools/info/mint?mint1=So11111111111111111111111111111111111111112&mint2=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&poolType=all&poolSortField=liquidity&sortType=desc&pageSize=5&page=1' | jq .
Получить цены минтов: 
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
Получить пулы ферм для LP токена: 
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .

​
Статус и доступность

Raydium API v3 работает на mainnet. О доступности и инцидентах следите в @Raydium.