Trade API

Quote and transaction-building endpoints for routed swaps.

Get swap quote

get

Get a routed swap quote for an exact input amount.

Query parameters

inputMintstringRequired

Token mint address to swap from.

outputMintstringRequired

Token mint address to swap to.

amountstringRequired

Amount in base units, such as token decimals or lamports for SOL.

slippageBpsnumberRequired

Slippage tolerance in basis points. For example, 50 = 0.5%.

txVersionstring · enumRequired

Transaction version.

Possible values:

Responses

200

Successful quote response.

application/json

idstringOptional

successbooleanOptional

versionstringOptional

get

/compute/swap-base-in

HTTPcURLJavaScriptPython

GET /compute/swap-base-in?inputMint=text&outputMint=text&amount=text&slippageBps=1&txVersion=v0 HTTP/1.1
Host: transaction-v1.raydium.io
Accept: */*

200

Successful quote 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"
      }
    ]
  }
}

Enter swap

post

Build one or more serialized swap transactions from a quote response.

Body

application/json

swapResponseobjectRequired

Response returned by the quote endpoint.

walletstringRequired

User wallet public key.

txVersionstring · enumRequired

Transaction version.

Possible values:

wrapSolbooleanOptional

Wrap SOL to wSOL for the input leg.

unwrapSolbooleanOptional

Unwrap wSOL to SOL for the output leg.

inputAccountstringOptional

Input token account. Omit if the input is SOL.

outputAccountstringOptional

Output token account. Omit if the output is SOL.

computeUnitPriceMicroLamportsstringOptional

Priority fee in micro-lamports.

Responses

200

Successful transaction build response.

application/json

idstringOptional

versionstringOptional

successbooleanOptional

post

/transaction/swap-base-in

HTTPcURLJavaScriptPython

POST /transaction/swap-base-in HTTP/1.1
Host: transaction-v1.raydium.io
Content-Type: application/json
Accept: */*
Content-Length: 168

{
  "swapResponse": {},
  "wallet": "text",
  "txVersion": "V0",
  "wrapSol": true,
  "unwrapSol": true,
  "inputAccount": "text",
  "outputAccount": "text",
  "computeUnitPriceMicroLamports": "text"
}

200

Successful transaction build response.

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