Raydium API v3

REST API для запроса пулов ликвидности, минтов, ферм и данных блокчейна Raydium на Solana

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

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

​

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

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

API спроектирован на высокую пропускную способность — ответы обычно устаревают на 1–5 минут в зависимости от чувствительности эндпоинта. Все ответы упакованы в единую оболочку с метаданными.

​

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

Окружение	URL
Mainnet	https://api-v3.raydium.io
Devnet	https://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.

​

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

• Обзор REST API
• Справочник API
• Руководство по интеграции для агрегаторов

​

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

Получить основную статистику:

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.