Обзор Transaction API

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

Что такое Transaction API?

Raydium Transaction API (Route V2) — это серверный сервис, который создаёт сериализованные транзакции обмена Solana без необходимости поддерживать RPC-соединение на клиенте или включать весь Raydium SDK. Это значительно упрощает интеграцию для:

Веб-фронтенда, который не может запустить локального RPC-клиента
Мобильных приложений с ограниченными ресурсами
Автоматических торговых ботов
Агрегаторов и провайдеров кошельков

Вместо выполнения сложной маршрутизации пулов и конструирования транзакций на клиенте вы запрашиваете котировки обмена и построение транзакций у нашего API, а затем подписываете и транслируете результат, используя любой Solana RPC.

Обзор рабочего процесса

Transaction API разделяет задачи на две фазы:

1. Фаза вычислений: получение котировки

Вызовите /compute/swap-base-in или /compute/swap-base-out, чтобы получить ожидаемый результат обмена (или требуемый вход) на основе текущих состояний пулов. Этот endpoint доступен только для чтения и не требует подписей:

GET /compute/swap-base-in?inputMint=EPjF...&outputMint=So111...&amount=1000000&slippageBps=50&txVersion=V0

Ответ включает:

Ожидаемый объём выходного токена
Разбор маршрута (какие пулы и источники ликвидности используются)
Влияние на цену

2. Фаза транзакции: построение и подпись

После получения ответа от вычислительного endpoint передайте его (вместе с кошельком и конфигурацией) в /transaction/swap-base-in или /transaction/swap-base-out:

POST /transaction/swap-base-in
Content-Type: application/json

{
  "wallet": "YourWalletAddress",
  "swapResponse": { ...response from /compute/swap-base-in },
  "txVersion": "V0",
  "computeUnitPriceMicroLamports": "1000",
  "wrapSol": false,
  "unwrapSol": false,
  "inputAccount": "TokenAccount1...",
  "outputAccount": "TokenAccount2..."
}

Ответ содержит:

Закодированную в base64 версионированную транзакцию, готовую к подписи
Адреса таблиц поиска адресов (если txVersion=V0)

Ваш клиент затем:

Декодирует транзакцию
Подписывает её с помощью keypair пользователя
Транслирует её через любой Solana RPC
Ожидает подтверждения

Вычислительные endpoint

`GET /compute/swap-base-in`

Случай использования: пользователь указывает сумму входа, мы вычисляем выход. Обязательные параметры запроса:

inputMint – адрес mint входного токена
outputMint – адрес mint желаемого токена
amount – сумма входа в lamports (наименьшая единица)
slippageBps – максимально допустимое проскальзывание в базовых пунктах (0–10000)
txVersion – V0 или LEGACY

Опционально:

referrerBps – если у вас есть авторитет рефferrера, базовые пункты выхода, которые нужно собрать в виде комиссии рефferrера

`GET /compute/swap-base-out`

Случай использования: пользователь указывает желаемый выход, мы вычисляем требуемый вход. Обязательные параметры запроса:

inputMint, outputMint, amount (желаемый выход), slippageBps, txVersion

Примечание: нет базовых пунктов рефферера для base-out (ещё не реализовано).

Endpoint транзакций

`POST /transaction/swap-base-in`

Построение транзакции для фиксированной суммы входа. Обязательное содержимое:

wallet – адрес вашего подписывающего кошелька
swapResponse – весь объект вычислительного ответа
txVersion – версия транзакции
computeUnitPriceMicroLamports – плата за приоритет в микро-lamports

Опционально:

wrapSol – если true, обернуть нативный SOL для входа
unwrapSol – если true, развернуть WSOL в SOL на выходе
inputAccount – аккаунт токена для входа (обязателен, если не оборачивается SOL)
outputAccount – аккаунт токена для выхода
nonceInfo – долговечный nonce для автономной подписи
jitoInfo – параметры пакета защиты от MEV Jito
referrerWallet – кошелёк рефferера для сбора комиссии

`POST /transaction/swap-base-out`

Построение транзакции для фиксированной суммы выхода. Те же параметры, что и base-in, за исключением:

поле referrerInfo в настоящее время закомментировано (ещё не реализовано)

Конверт ответа

Все endpoint возвращают стандартный конверт:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "success": true,
  "version": "V1",
  "data": { ... }
}

При ошибке success имеет значение false, а msg содержит код ошибки (например, REQ_WALLET_ERROR, REQ_SLIPPAGE_BPS_ERROR).

Форма ответа транзакции

Успешный ответ транзакции выглядит так:

{
  "id": "...",
  "success": true,
  "version": "V1",
  "data": {
    "transaction": "AgABB...",  // Base64-кодированная транзакция
    "addressLookupTableAddresses": ["Address1...", "Address2..."]  // Только для V0
  }
}

Пример интеграции

Вот типичный поток в псевдокоде:

// 1. Получить котировку
const quote = await fetch(
  'https://transaction-v1.raydium.io/compute/swap-base-in?' +
  'inputMint=EPjF...&outputMint=So111...&amount=1000000&slippageBps=50&txVersion=V0'
).then(r => r.json());

// 2. Проверить котировку
if (!quote.success) {
  throw new Error(quote.msg);
}

// 3. Построить транзакцию
const tx = await fetch(
  'https://transaction-v1.raydium.io/transaction/swap-base-in',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      wallet: userWalletAddress,
      swapResponse: quote,
      txVersion: 'V0',
      computeUnitPriceMicroLamports: '1000',
      inputAccount: userInputTokenAccount,
      outputAccount: userOutputTokenAccount,
    }),
  }
).then(r => r.json());

// 4. Декодировать и подписать
const transaction = VersionedTransaction.deserialize(
  Buffer.from(tx.data.transaction, 'base64')
);
transaction.sign([userKeypair]);

// 5. Отправить через RPC
const rpc = new Connection('https://api.mainnet-beta.solana.com');
const sig = await rpc.sendTransaction(transaction);
await rpc.confirmTransaction(sig);

Объяснение ключевых параметров

`txVersion`

V0: современная транзакция Solana с таблицами поиска адресов (ALTs). Меньший размер сериализации, более низкие комиссии.
LEGACY: формат транзакции до ALT. Больше, но работает со всеми RPC endpoint.

Выбирайте V0 по возможности; переходите на LEGACY, если ваш RPC или кошелёк не поддерживает ALT.

`computeUnitPriceMicroLamports`

Плата за приоритет для более быстрого включения в блок. Установите на 0 для отсутствия платы за приоритет или на более высокие значения (например, 1000) для конкуренции в перегруженных сетях. Единицы — микро-lamports за вычислительную единицу.

`slippageBps`

Максимальная толерантность к проскальзыванию в базовых пунктах. 100 = 1%, 50 = 0,5%.

Используйте более низкие значения (например, 25–50 bps) для большинства стабильных обменов
Увеличивайте для волатильных или низколиквидных пар

`wrapSol` и `unwrapSol`

wrapSol: если true, API оборачивает ваш нативный SOL в WSOL. inputAccount не требуется.
unwrapSol: если true, API разворачивает выходной WSOL обратно в нативный SOL. outputAccount не требуется.

Если оба имеют значение false, вы должны предоставить явные аккаунты токенов.

Сетевые endpoint

Сеть	Mainnet	Devnet
Host	`transaction-v1.raydium.io`	`transaction-v1-devnet.raydium.io`
Протокол	HTTPS	HTTPS

Коды ошибок

Распространённые сообщения об ошибках:

Код	Значение
`REQ_SLIPPAGE_BPS_ERROR`	Проскальзывание недействительно или выходит за допустимые пределы
`REQ_INPUT_MINT_ERROR`	Адрес входного mint недействителен
`REQ_OUTPUT_MINT_ERROR`	Адрес выходного mint недействителен
`REQ_AMOUNT_ERROR`	Сумма не является допустимым числом
`REQ_TX_VERSION_ERROR`	txVersion должен быть V0 или LEGACY
`REQ_WALLET_ERROR`	Адрес кошелька недействителен
`REQ_INPUT_ACCOUT_ERROR`	Аккаунт входного токена отсутствует или недействителен
`REQ_OUTPUT_ACCOUT_ERROR`	Аккаунт выходного токена отсутствует или недействителен
`UNKNOWN_ERROR`	Ошибка на сервере; проверьте параметры вашего запроса

Обзор

API v3

Transaction API

Perps API

API LaunchLab

Dynamic IPFS API

Owner API

API v1

Temp API

Обзор Transaction API

Что такое Transaction API?

Обзор рабочего процесса

1. Фаза вычислений: получение котировки

2. Фаза транзакции: построение и подпись

Вычислительные endpoint

`GET /compute/swap-base-in`

`GET /compute/swap-base-out`

Endpoint транзакций

`POST /transaction/swap-base-in`

`POST /transaction/swap-base-out`

Конверт ответа

Форма ответа транзакции

Пример интеграции

Объяснение ключевых параметров

`txVersion`

`computeUnitPriceMicroLamports`

`slippageBps`

`wrapSol` и `unwrapSol`

Сетевые endpoint

Коды ошибок

См. также

Обзор

API v3

Transaction API

Perps API

API LaunchLab

Dynamic IPFS API

Owner API

API v1

Temp API

Documentation Index

​Что такое Transaction API?

​Обзор рабочего процесса

​1. Фаза вычислений: получение котировки

​2. Фаза транзакции: построение и подпись

​Вычислительные endpoint

​GET /compute/swap-base-in

​GET /compute/swap-base-out

​Endpoint транзакций

​POST /transaction/swap-base-in

​POST /transaction/swap-base-out

​Конверт ответа

​Форма ответа транзакции

​Пример интеграции

​Объяснение ключевых параметров

​txVersion

​computeUnitPriceMicroLamports

​slippageBps

​wrapSol и unwrapSol

​Сетевые endpoint

​Коды ошибок

​См. также

Что такое Transaction API?

Обзор рабочего процесса

1. Фаза вычислений: получение котировки

2. Фаза транзакции: построение и подпись

Вычислительные endpoint

`GET /compute/swap-base-in`

`GET /compute/swap-base-out`

Endpoint транзакций

`POST /transaction/swap-base-in`

`POST /transaction/swap-base-out`

Конверт ответа

Форма ответа транзакции

Пример интеграции

Объяснение ключевых параметров

`txVersion`

`computeUnitPriceMicroLamports`

`slippageBps`

`wrapSol` и `unwrapSol`

Сетевые endpoint

Коды ошибок

См. также