Solana Swap Quoting

Single endpoint, same shape as EVM / TON. The Solana-specific calldata sits under data.solana. See the Swap Quoting page for the full input parameters.

Native SOL and WSOL

So11111111111111111111111111111111111111111

Use this tokenIn / tokenOut value when the user is paying with, or receiving, native SOL from their wallet. Wrapped SOL is the SPL mint So11111111111111111111111111111111111111112. Use the WSOL mint only when the user is intentionally swapping an existing WSOL token account.

Request

GET /api/2/swap/quoting?chainId=solana:solana
  &tokenIn=So11111111111111111111111111111111111111111
  &tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
  &amount=1
  &walletAddress=8ZmF…
  &slippage=1
  &prioritizationFeeLamports=auto
  &jitoTipLamports=10000
  &feePercentage=0.5
  &feeWallet=8ZmF…

Param	Required	Notes
`chainId`	✓	`solana:solana`
`tokenIn` / `tokenOut`	✓	Token mint address. Native SOL sentinel = `So111…111`; WSOL SPL mint = `So111…112`.
`amount` or `amountRaw`	✓	Human-readable (`"1.5"`) or raw (`"1500000"` for 6-decimal USDC)
`walletAddress`	✓	User’s Solana base58 pubkey
`slippage`	–	`%` value (`0`-`100`) or `auto`. Defaults to `auto`.
`prioritizationFeeLamports`	–	Jupiter-compatible priority fee budget: `auto`, fixed lamports, or `{"priorityLevelWithMaxLamports":{"priorityLevel":"medium" \| "high" \| "veryHigh","maxLamports":1000000,"global":false}}`
`dynamicComputeUnitLimit`	–	`true` by default; dynamically sizes the Solana compute limit from the built swap instructions
`jitoTipLamports`	–	Add a Jito tip transfer to one of the official tip accounts
`multiLander`	–	`true` returns N candidates over a durable nonce — see Multi-lander
`landerTipLamports`	–	Per-lander tip when `multiLander=true`
`payerAddress`	–	Fee abstraction. This wallet pays transaction fees, priority fees, Jito tips, and ATA rent. It must sign when different from `walletAddress`. The swap funds still come from `walletAddress`.
`closeAuthority`	–	Optional close authority for non-WSOL ATAs Mobula creates during the swap when `payerAddress` is used. Usually set it to the central payer wallet to reclaim rent later.
`destinationWallet`	–	Solana-only tokenOut recipient. Defaults to `walletAddress`. Do not combine with `finalRecipientWallet`.
`swapRecipientAddress`	–	Solana-only router-enforced final recipient. MobulaRouter transfers the exact final swap output to this wallet after swap execution and fee/slippage checks. Do not combine with `destinationWallet`. Legacy alias: `finalRecipientWallet`.
`feePercentage`	–	Caller referral fee 0-99%. Charged on the route’s quote asset, on either the input or output side. The asset can be native SOL or an SPL token such as USDC or WSOL.
`feeWallet`	–	Required when `feePercentage > 0` (and for `minFeesNative` / `feeToken`)
`minFeesNative`	–	Minimum referral fee in SOL, e.g. `0.05`. Floors the referral fee — `max(amountIn × feePercentage/100, minFeesNative)` — enforced on-chain by MobulaRouter when the fee asset is native SOL.
`feeToken`	–	Mint of a token to charge a flat minimum fee in (with `minFeesTokenRaw`). Transferred to `feeWallet` via a dedicated instruction, independent of the route.
`minFeesTokenRaw`	–	Raw amount (smallest unit) of `feeToken` to charge. Tx reverts if the user’s balance is insufficient.
`onlyRouters`	–	Comma-list of `jupiter,naos,kyberswap,lifi`
`excludedProtocols` / `onlyProtocols`	–	DEX-level filter (e.g. `raydium,orca,manifest,bisonfi,pancakeswap`)

Supported Solana protocols

Mobula routing includes the following Solana integrations in addition to Raydium, Orca, Meteora, Pump.fun, PumpSwap, and the other supported DEXs:

Protocol	`onlyProtocols` value	Model
Manifest	`manifest`	On-chain central limit order book
BisonFi	`bisonfi`	Proprietary market maker
PancakeSwap	`pancakeswap`	Concentrated-liquidity AMM

These protocols participate in automatic best-route selection. Use onlyProtocols to restrict a quote to one or more integrations, or excludedProtocols to remove them from consideration.

Response — `data.solana`

{
  "data": {
    "amountOutTokens": "245.123",
    "amountInUSD": 200.45,
    "amountOutUSD": 199.87,
    "slippagePercentage": 1,
    "prioritizationFeeLamports": 9999,
    "computeUnitLimit": 388876,
    "prioritizationType": {
      "computeBudget": {
        "microLamports": 25715,
        "estimatedMicroLamports": 785154
      }
    },
    "marketImpactPercentage": 0.04,
    "poolFeesPercentage": 0.25,
    "tokenIn":  { "address": "So111…111", "symbol": "SOL",  "decimals": 9 },
    "tokenOut": { "address": "EPjF…",     "symbol": "USDC", "decimals": 6 },
    "requestId": "f8b2…",
    "details": {
      "route": {
        "hops": [
          { "poolAddress": "5Q5…", "exchange": "Raydium", "poolType": "CLMM", "feeBps": 25 }
        ],
        "totalFeePercentage": 0.25,
        "aggregator": "jupiter"
      }
    },
    "fee": { "amount": "0.001", "percentage": 0.5, "wallet": "8ZmF…", "deductedFrom": "input" },
    "solana": {
      "transaction": {
        "serialized": "base64-encoded-VersionedTransaction-bytes",
        "variant": "versioned"
      },
      "lastValidBlockHeight": 269450123
    },
    "evm": null,
    "ton": null
  }
}

Priority fee fields

Both /api/2/swap/quoting and /api/2/swap/quoting-instructions expose the applied Solana priority fee using the Jupiter-compatible response model. These fields are at the root of data, not inside data.solana.

Field	Type	Description
`prioritizationFeeLamports`	number	Maximum priority fee paid if the transaction consumes its full compute limit. It is calculated as `ceil(computeUnitLimit * microLamports / 1,000,000)`.
`computeUnitLimit`	number	Compute unit limit encoded by the `SetComputeUnitLimit` instruction.
`prioritizationType.computeBudget.microLamports`	number	Compute unit price encoded by the `SetComputeUnitPrice` instruction, in micro-lamports per CU.
`prioritizationType.computeBudget.estimatedMicroLamports`	number	Uncapped compute unit price estimate. When `maxLamports` caps the fee, this can be higher than `microLamports`; otherwise the values can be equal.

Use these returned values when reporting or validating transaction fees. They describe the transaction Mobula built and require no additional RPC call.

`data.solana` fields

Field	Type	Description
`transaction.serialized`	base64	Full Solana transaction. Deserialize with `VersionedTransaction.deserialize` (or `Transaction.from` for legacy).
`transaction.variant`	`'versioned' \| 'legacy'`	Discriminator — almost always `'versioned'` in practice.
`lastValidBlockHeight`	number	Blockhash expiry — your client should broadcast before the chain ticks past this.

Multi-lander

Set multiLander=true to receive N candidate transactions sharing a durable nonce. Race them across Jito / Nozomi / 0slot for fastest landing — only one can commit.

{
  "data": {
    "candidates": [
      { "lander": "jito",     "serialized": "base64…", "tipAccount": "Cw8C…", "tipLamports": 1000 },
      { "lander": "nozomi",   "serialized": "base64…", "tipAccount": "TpdX…", "tipLamports": 1000 },
      { "lander": "zeroslot", "serialized": "base64…", "tipAccount": "6fQa…", "tipLamports": 1000 }
    ],
    "nonceAccount": "Hgs…",
    "nonceAuthority": "BvW…",
    "solana": null,
    "evm": null,
    "ton": null
  }
}

Sign every candidate, POST them all to /swap/send in batch mode (candidates: [{lander, signedTransaction}, …]).

Signing

import { VersionedTransaction } from '@solana/web3.js';

const tx = VersionedTransaction.deserialize(
  Buffer.from(quote.data.solana.transaction.serialized, 'base64'),
);
// The user wallet signs because it owns the input funds.
let signed = await wallet.signTransaction(tx);

// If the quote used payerAddress and it differs from walletAddress,
// the payer must sign too because it pays tx fees / ATA rent.
if (centralFeePayerKeypair) {
  // With a local Keypair:
  signed.sign([centralFeePayerKeypair]);
}

// Or with a wallet adapter / remote signer:
// signed = await centralFeePayerWallet.signTransaction(signed);

const signedBase64 = Buffer.from(signed.serialize()).toString('base64');

await fetch('/api/2/swap/send', {
  method: 'POST',
  body: JSON.stringify({ chainId: 'solana:solana', signedTransaction: signedBase64 }),
});

Supported aggregators

Jupiter, KyberSwap, NAOS, Li.Fi — pick one or several via onlyRouters. Per-DEX filtering (Raydium, Orca, Meteora DLMM/Damm, Pump AMM, Whirlpool, Manifest, BisonFi, PancakeSwap, …) via onlyProtocols / excludedProtocols.

Limits

Blockhash expiry — lastValidBlockHeight is ~150 slots (60s). Re-quote if the user takes longer than that to sign.
Priority budget — use prioritizationFeeLamports with dynamicComputeUnitLimit=true so the CU price is derived from the final compute limit. When bundling with Jito, set jitoTipLamports separately.
Address forms — Solana addresses are case-sensitive base58. Don’t lowercase.

Introduction

Swap API

Bridge (Alpha Preview)

Perps Execution

Agentic Payments

Native SOL and WSOL

Request

Supported Solana protocols

Sponsored fees, close authority, and final recipient

Response — `data.solana`

Priority fee fields

`data.solana` fields

Multi-lander

Signing

Supported aggregators

Limits

​Native SOL and WSOL

​Request

​Supported Solana protocols

​Sponsored fees, close authority, and final recipient

​Response — data.solana

​Priority fee fields

​data.solana fields

​Multi-lander

​Signing

​Supported aggregators

​Limits

Native SOL and WSOL

Request

Supported Solana protocols

Sponsored fees, close authority, and final recipient

Response — `data.solana`

Priority fee fields

`data.solana` fields

Multi-lander

Signing

Supported aggregators

Limits