Trade API

Route swaps through Raydium pools using the Trade API

The Trade API lets you get quotes and execute swaps through Raydium's routing engine. For a complete implementation, see the SDK demo.

Get quote

GET https://transaction-v1.raydium.io/compute/swap-base-in

Returns a quote for swapping tokens.

Query parameters

Name	Type	Required	Description
inputMint	string	Yes	Token mint address to swap from
outputMint	string	Yes	Token mint address to swap to
amount	string	Yes	Amount in base units (lamports)
slippageBps	number	Yes	Slippage tolerance in basis points (e.g. 50 = 0.5%)
txVersion	string	Yes	Transaction version (V0 or LEGACY)

Response

{
  "id": "cbbcc7e2-a5fa-4040-a260-b229842c93c7",
  "success": true,
  "version": "V1",
  "data": {
    "swapType": "BaseIn",
    "inputMint": "So11111111111111111111111111111111111111112",
    "inputAmount": "100000000",
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "outputAmount": "13738391",
    "otherAmountThreshold": "13669699",
    "slippageBps": 50,
    "priceImpactPct": 0,
    "referrerAmount": "0",
    "routePlan": [
      {
        "poolId": "3nMFwZXwY1s1M5s8vYAHqd4wGs4iSxXE4LRoUMMYqEgF",
        "inputMint": "So11111111111111111111111111111111111111112",
        "outputMint": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
        "feeMint": "So11111111111111111111111111111111111111112",
        "feeRate": 1,
        "feeAmount": "10000",
        "remainingAccounts": [
          "DDe2TojkajtXKYJEMKfjY3Xjdw1XhZqr8UEBNgrg512P",
          "AWeEpV2ASCkVmcpK7htwWCqztmKMNdsmquKMa7y96Wif",
          "22ps6VsrEnCwEfGX4nkFV2xz4ohpvF5aTVtSg5FcwGRn"
        ],
        "lastPoolPriceX64": "6841151606851928973"
      },
      {
        "poolId": "3NeUgARDmFgnKtkJLqUcEUNCfknFCcGsFfMJCtx6bAgx",
        "inputMint": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
        "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "feeMint": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
        "feeRate": 1,
        "feeAmount": "1376",
        "remainingAccounts": [
          "CxPCSxEmvkTyd6tqpVcZv2QscGrzkZKBmH7R9Bs9wocT",
          "9iD8oCrLQFNd1sbhYZg2awLrsZu4f1AAZG6bHuJkLXEx",
          "32D4WyeYS7irtnGpVS2VYja5H8uUpc8zF24kd15oFD2o"
        ],
        "lastPoolPriceX64": "18455174383562030500"
      }
    ]
  }
}

Endpoints

Endpoint	Description
/compute/swap-base-in	Specify exact input amount
/compute/swap-base-out	Specify exact output amount (slippage applies to input)

---

Serialize transaction

POST https://transaction-v1.raydium.io/transaction/swap-base-in

Builds the transaction from a quote.

Request body

Name	Type	Required	Description
swapResponse	object	Yes	Response from get quote
wallet	string	Yes	User's wallet public key
txVersion	string	Yes	Transaction version (V0 or LEGACY)
wrapSol	boolean	No	Wrap SOL to wSOL for input
unwrapSol	boolean	No	Unwrap wSOL to SOL for output
inputAccount	string	No	Input token account (omit if SOL)
outputAccount	string	No	Output token account (omit if SOL)
computeUnitPriceMicroLamports	string	No	Priority fee in micro-lamports

Response

{
  "id": "bca0c725-0037-48ce-8d0a-db39a0f6e020-tx",
  "version": "V1",
  "success": true,
  "data": [
    {
      "transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAQADEUxrOZd2...[truncated]"
    }
  ]
}

---

Priority fees

GET https://api-v3.raydium.io/main/auto-fee

Returns recommended priority fees based on recent network activity.

Response

json

{
  "id": "5cbb436c-ae8e-4907-933f-a142b0c47be4",
  "success": true,
  "data": {
    "default": {
      "vh": 20000,
      "h": 15000,
      "m": 10000
    }
  }
}

Tier	Description
vh	Very high
h	High
m	Medium

Full example

Install:

yarn add @raydium-io/raydium-sdk-v2

Setup:

import { Transaction, VersionedTransaction, sendAndConfirmTransaction } from '@solana/web3.js'
import { NATIVE_MINT } from '@solana/spl-token'
import axios from 'axios'
import { connection, owner, fetchTokenAccountData } from '../config'
import { API_URLS } from '@raydium-io/raydium-sdk-v2'

// config.ts
export const owner: Keypair = Keypair.fromSecretKey(bs58.decode('<YOUR_WALLET_SECRET_KEY>'))
export const connection = new Connection('<YOUR_RPC_URL>')

⚠️ Don't use your main wallet private key for testing.

Get quote:

const { data: swapResponse } = await axios.get<SwapCompute>(
  `${API_URLS.SWAP_HOST}/compute/swap-base-in?inputMint=${inputMint}&outputMint=${outputMint}&amount=${amount}&slippageBps=${slippage * 100}&txVersion=${txVersion}`
)

Serialize:

const { data: swapTransactions } = await axios.post(
  `${API_URLS.SWAP_HOST}/transaction/swap-base-in`, 
  {
    computeUnitPriceMicroLamports: String(priorityFee),
    swapResponse,
    txVersion,
    wallet: owner.publicKey.toBase58(),
    wrapSol: isInputSol,
    unwrapSol: isOutputSol,
    inputAccount: isInputSol ? undefined : inputTokenAcc?.toBase58(),
    outputAccount: isOutputSol ? undefined : outputTokenAcc?.toBase58(),
  }
)

Deserialize and send:

const allTxBuf = swapTransactions.data.map((tx) => Buffer.from(tx.transaction, 'base64'))
const allTransactions = allTxBuf.map((txBuf) =>
  isV0Tx ? VersionedTransaction.deserialize(txBuf) : Transaction.from(txBuf)
)

for (const tx of allTransactions) {
  const transaction = tx as VersionedTransaction
  transaction.sign([owner])
  const txId = await connection.sendTransaction(transaction, { skipPreflight: true })
  
  const { lastValidBlockHeight, blockhash } = await connection.getLatestBlockhash({
    commitment: 'finalized',
  })
  
  await connection.confirmTransaction(
    { blockhash, lastValidBlockHeight, signature: txId },
    'confirmed'
  )
}

Need help? Ask in #dev-chat on Discord.