Swap Quoting - Mobula API

Get swap quote with transaction details

curl --request GET \
  --url https://demo-api.mobula.io/api/2/swap/quoting

{
  "data": {
    "requestId": "<string>",
    "solana": {
      "transaction": {
        "serialized": "AQABAuObQ8Adqk1eqZxRMJg4r6vGtXq9k0...base64...",
        "variant": "versioned"
      },
      "lastValidBlockHeight": 269450123
    },
    "amountOutTokens": "245.123",
    "slippagePercentage": 1,
    "amountInUSD": 200.45,
    "amountOutUSD": 199.87,
    "marketImpactPercentage": 0.04,
    "poolFeesPercentage": 0.25,
    "tokenIn": {
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "name": "USD Coin",
      "symbol": "USDC",
      "logo": "https://metadata.mobula.io/assets/logos/evm_8453_0x8335…"
    },
    "tokenOut": {
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "name": "USD Coin",
      "symbol": "USDC",
      "logo": "https://metadata.mobula.io/assets/logos/evm_8453_0x8335…"
    },
    "details": {
      "route": {
        "hops": [
          {
            "poolAddress": "<string>",
            "tokenIn": {
              "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "decimals": 6,
              "name": "USD Coin",
              "symbol": "USDC",
              "logo": "https://metadata.mobula.io/assets/logos/evm_8453_0x8335…"
            },
            "tokenOut": {
              "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "decimals": 6,
              "name": "USD Coin",
              "symbol": "USDC",
              "logo": "https://metadata.mobula.io/assets/logos/evm_8453_0x8335…"
            },
            "amountInTokens": "1.0",
            "amountOutTokens": "245.1",
            "exchange": "Raydium",
            "poolType": "CLMM",
            "feePercentage": 0.25,
            "feeBps": 25
          }
        ],
        "totalFeePercentage": 0.25,
        "aggregator": "jupiter"
      },
      "aggregator": "<string>",
      "raw": {}
    },
    "fee": {
      "amount": "0.001",
      "percentage": 0.5,
      "wallet": "0xCALLER…",
      "deductedFrom": "input"
    },
    "evm": null,
    "ton": null
  },
  "error": "<string>"
}

GET

swap

quoting

Get swap quote with transaction details

curl --request GET \
  --url https://demo-api.mobula.io/api/2/swap/quoting

{
  "data": {
    "requestId": "<string>",
    "solana": {
      "transaction": {
        "serialized": "AQABAuObQ8Adqk1eqZxRMJg4r6vGtXq9k0...base64...",
        "variant": "versioned"
      },
      "lastValidBlockHeight": 269450123
    },
    "amountOutTokens": "245.123",
    "slippagePercentage": 1,
    "amountInUSD": 200.45,
    "amountOutUSD": 199.87,
    "marketImpactPercentage": 0.04,
    "poolFeesPercentage": 0.25,
    "tokenIn": {
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "name": "USD Coin",
      "symbol": "USDC",
      "logo": "https://metadata.mobula.io/assets/logos/evm_8453_0x8335…"
    },
    "tokenOut": {
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "name": "USD Coin",
      "symbol": "USDC",
      "logo": "https://metadata.mobula.io/assets/logos/evm_8453_0x8335…"
    },
    "details": {
      "route": {
        "hops": [
          {
            "poolAddress": "<string>",
            "tokenIn": {
              "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "decimals": 6,
              "name": "USD Coin",
              "symbol": "USDC",
              "logo": "https://metadata.mobula.io/assets/logos/evm_8453_0x8335…"
            },
            "tokenOut": {
              "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "decimals": 6,
              "name": "USD Coin",
              "symbol": "USDC",
              "logo": "https://metadata.mobula.io/assets/logos/evm_8453_0x8335…"
            },
            "amountInTokens": "1.0",
            "amountOutTokens": "245.1",
            "exchange": "Raydium",
            "poolType": "CLMM",
            "feePercentage": 0.25,
            "feeBps": 25
          }
        ],
        "totalFeePercentage": 0.25,
        "aggregator": "jupiter"
      },
      "aggregator": "<string>",
      "raw": {}
    },
    "fee": {
      "amount": "0.001",
      "percentage": 0.5,
      "wallet": "0xCALLER…",
      "deductedFrom": "input"
    },
    "evm": null,
    "ton": null
  },
  "error": "<string>"
}

Batch Support Available: This endpoint supports batch queries via POST method for fetching up to 30 swap quotes in a single request. Jump to Batch Query section

Overview

The Swap Quoting endpoint provides swap quotes with optimized routing across multiple DEXs and liquidity sources. It returns the estimated output amount, slippage, and a serialized transaction ready to be signed.

Solana Swap Execution - Alpha ModeSwap execution on Solana (including this endpoint and /swap/quoting-instructions) is currently in alpha mode. This means:

The feature is functional but may have limitations or unexpected behavior
Performance and reliability improvements are ongoing
We recommend testing thoroughly before production use
Please report any issues to the Mobula team for faster resolution

EVM chains (Ethereum, BSC, Base, etc.) are fully stable and production-ready.

Supported EVM Chains

The Swap API routes EVM swaps through MobulaRouter, a smart contract deployed across the following chains:

Chain	Chain ID	Router Address
Ethereum	`evm:1`	`0x0005ea683517b3a4463bfd798c9850Ad2d586795`
Optimism	`evm:10`	`0x0005ea38EB0a69D1253508EBDBdB9eA8Cb26B5Ef`
BNB Chain	`evm:56`	`0x0005ea70fa6dbd2efd17697d2351301adb6318b2`
Gnosis	`evm:100`	`0x40A9849E3bfcf0f3d3be9dfaE3C997aCa19c19ED`
Polygon	`evm:137`	`0x0005ea38EB0a69D1253508EBDBdB9eA8Cb26B5Ef`
Monad	`evm:143`	`0x40A9849E3bfcf0f3d3be9dfaE3C997aCa19c19ED`
Mantle	`evm:5000`	`0x40A9849E3bfcf0f3d3be9dfaE3C997aCa19c19ED`
MegaETH	`evm:4326`	`0x40A9849E3bfcf0f3d3be9dfaE3C997aCa19c19ED`
Base	`evm:8453`	`0x0005ea38EB0a69D1253508EBDBdB9eA8Cb26B5Ef`
Arbitrum	`evm:42161`	`0x0005ea38EB0a69D1253508EBDBdB9eA8Cb26B5Ef`
Avalanche	`evm:43114`	`0x0005ea38EB0a69D1253508EBDBdB9eA8Cb26B5Ef`
Linea	`evm:59144`	`0x40A9849E3bfcf0f3d3be9dfaE3C997aCa19c19ED`
Blast	`evm:81457`	`0x40A9849E3bfcf0f3d3be9dfaE3C997aCa19c19ED`
Scroll	`evm:534352`	`0x40A9849E3bfcf0f3d3be9dfaE3C997aCa19c19ED`

The router proxy address differs across chains. Don’t hardcode a single address — always read it from the table above, or from the evm.transaction.to field of every quote response. See Smart Contract Integration for per-chain explorer links and the canonical ABI.

All EVM swaps go through the MobulaRouter contract, which routes to the best available aggregator for optimal pricing. The router address is returned in the evm.transaction.to field of the response.

Query Parameters

chainId (required) — The blockchain identifier (e.g., evm:1, solana, ethereum)
tokenIn (required) — Address of the token to swap from (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native tokens)
tokenOut (required) — Address of the token to swap to (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native tokens)
amount (required if amountRaw not provided) — Human-readable amount of tokenIn to swap (e.g., "1.5" for 1.5 tokens). This will be converted to raw amount by multiplying by 10^decimals.
amountRaw (required if amount not provided) — Raw amount as a string (e.g., "1500000" for 1.5 USDC with 6 decimals). This is the exact amount that will be used in the swap without conversion. Must be a positive integer string.
walletAddress (required) — Wallet address that will execute the swap
slippage (optional) — Maximum acceptable slippage percentage (0-100). Default: 1
excludedProtocols (optional) — Comma-separated list of factory addresses to exclude from routing. Can be any factory address.
onlyProtocols (optional) — Comma-separated list of tradable pool types to restrict routing to (e.g., uniswap-v2, uniswap-v3, raydium-amm). Only valid tradable pool types will be considered; non-tradable types will be filtered out.
poolAddress (optional) — Specific pool address to use for the swap
onlyVerifiedTokens (optional) — When set to "true", the endpoint will reject quotes where tokenOut is an unverified launchpad token (e.g., tokens originating from Pump.fun, Pumpswap, Raydium Launchlab, etc.). Returns an error with the token’s source if rejected. Default: "false" (all tokens allowed).
onlyRouters (optional) — Comma-separated list of routers to use for routing (e.g., jupiter, kyberswap, lifi). Only the specified routers will be used for the swap. Supported values: jupiter (Solana), kyberswap (EVM), lifi (EVM)
feePercentage (optional) — Fee percentage to charge on the swap (0.01 to 99). Default: 0 (no fee).
- On EVM chains: Fee is applied to the swap via MobulaRouter. No feeWallet required - fees go to the protocol.
- On Solana: Fee is taken from native SOL only. The fee is a percentage of the SOL amount being swapped (input or output), and it’s deducted from that amount. Must be provided together with feeWallet. Note: At least one side of the swap must be native SOL for fees to apply.
feeWallet (optional, Solana only) — Wallet address to receive fees. Must be a valid Solana wallet address. Only required on Solana when feePercentage is set.
minFeesNative (optional, TON & Solana) — Minimum caller referral fee in the chain’s native token (for example, 0.1 TON or 0.05 SOL). Applies a floor to the referral fee: max(amountIn × feePercentage / 100, minFeesNative). Honored when the fee is taken in the native token — on TON for native-TON input swaps, on Solana when the fee asset is native SOL (the quote side of the pair). On Solana it is enforced on-chain by MobulaRouter. Requires feeWallet.
feeToken (optional, Solana only) — Mint address of a token in which to charge a flat minimum fee, paired with minFeesTokenRaw. The router transfers minFeesTokenRaw of this token from the user to feeWallet via a dedicated instruction added next to the swap — independent of the swap route (the token does not need to be tokenIn or tokenOut). The transaction reverts if the user’s balance is insufficient. Requires feeWallet.
minFeesTokenRaw (optional, Solana only) — Raw amount (smallest unit, e.g. "1000000" for 1 USDC) of feeToken to charge as a flat minimum fee. Must be a positive integer.
priorityFee (optional, Solana only) — Priority fee configuration for Solana transactions. Can be:
- auto: Automatically estimate priority fee based on network conditions
- A preset name: low, medium, high, veryHigh
- A number: Exact priority fee in microLamports per compute unit
Presets (microLamports per CU):
- low: 10,000 (0.01 lamports/CU)
- medium: 100,000 (0.1 lamports/CU)
- high: 500,000 (0.5 lamports/CU)
- veryHigh: 1,000,000 (1 lamport/CU)
Default: no priority fee for internal routing, Jupiter uses auto.
computeUnitLimit (optional, Solana only) — Compute unit limit for Solana transactions. Can be true for dynamic limit estimation or a specific number. Default: 400,000.
jitoTipLamports (optional, Solana only) — Jito tip amount in lamports for block engine priority. This adds a SOL transfer instruction to a Jito tip account to prioritize the transaction via Jito’s block engine. Example: 10000 = 0.00001 SOL tip. Note: This is separate from priorityFee (compute unit price). For best results, use both together.
payerAddress (optional, Solana only) — Payer wallet address for fee abstraction. This wallet will be the fee payer (paying SOL rent/transaction fees) and the signer of the transaction. The swap itself will still use the walletAddress for token transfers. Use this to allow a third party (e.g., a service or sponsor) to pay transaction fees while the user’s wallet executes the actual swap. If not provided, walletAddress is used as the payer.

Amount Specification

Either amount OR amountRaw must be provided (but not both).

Understanding Token Decimals

Tokens have a decimals property that determines how many decimal places they support:

ETH/WETH: 18 decimals
USDC: 6 decimals
USDT: 6 decimals
BTC: 8 decimals

The relationship between human-readable amount and raw amount is:

raw amount = human-readable amount × 10^decimals

Examples:

For USDC (6 decimals): amount="1.5" becomes 1500000 raw units
For ETH (18 decimals): amount="0.0001" becomes 100000000000000 raw units (1e14)
For USDC (6 decimals): amountRaw="1500000" represents 1.5 USDC

When to use amount:

You have a human-readable amount (e.g., “1.5” tokens)
You want the API to handle the conversion automatically
Simpler for most use cases

When to use amountRaw:

You already have the raw amount from another source
You want to avoid precision loss from floating-point conversion
You need exact control over the amount being swapped

Fees

Fees allow you to charge a percentage fee on swaps. This is useful for monetizing your integration. How it works:

On EVM chains: Fee is applied via MobulaRouter. Default is 0% (no fee).
On Solana: Fee is taken from native SOL (deducted from the swap amount) and sent to your designated feeWallet.
- minFeesNative enforces a minimum referral fee in SOL — max(amountIn × feePercentage / 100, minFeesNative) — applied on-chain by MobulaRouter when the fee asset is native SOL.
- feeToken + minFeesTokenRaw charge a flat minimum fee in any SPL token via a dedicated transfer to feeWallet, independent of the swap route.
On TON: minFeesNative can enforce a minimum caller referral fee for native TON input swaps: max(amountIn × feePercentage / 100, minFeesNative).

Requirements:

Fee percentage must be between 0.01% and 99%
minFeesNative must be a non-negative native-token amount and must be used with feeWallet.
feeToken (mint) and minFeesTokenRaw (positive integer raw amount) must be provided together and require feeWallet (Solana only).

Usage Examples

Basic Swap Quote with Native SOL (Human-readable Amount)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=YourWalletAddress&slippage=1"

Basic Swap Quote with Native SOL (Raw Amount)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amountRaw=1000000000&walletAddress=YourWalletAddress&slippage=1"

Swap with Excluded Protocols (Human-readable Amount)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=ethereum&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&amount=1&walletAddress=0xYourWalletAddress&slippage=2&excludedProtocols=uniswap-v2,sushiswap"

Swap with Excluded Protocols (Raw Amount)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=ethereum&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&amountRaw=1000000000000000000&walletAddress=0xYourWalletAddress&slippage=2&excludedProtocols=uniswap-v2,sushiswap"

Swap with Specific Pool Type (Human-readable Amount)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:1&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0xdAC17F958D2ee523a2206206994597C13D831ec7&amount=0.5&walletAddress=0xYourWalletAddress&onlyProtocols=uniswap-v3"

Swap with Specific Pool Type (Raw Amount)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:1&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0xdAC17F958D2ee523a2206206994597C13D831ec7&amountRaw=500000000000000000&walletAddress=0xYourWalletAddress&onlyProtocols=uniswap-v3"

Swap with Specific Router (Solana - Jupiter)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=YourWalletAddress&onlyRouters=jupiter"

Swap with Specific Router (EVM - KyberSwap)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:1&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&amount=1&walletAddress=0xYourWalletAddress&onlyRouters=kyberswap"

Swap with Multiple Routers (EVM - KyberSwap and LiFi)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:1&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&amount=1&walletAddress=0xYourWalletAddress&onlyRouters=kyberswap,lifi"

Swap on Base (Native ETH to USDC)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:8453&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&amount=0.01&walletAddress=0xYourWalletAddress&slippage=1"

Swap on BNB Chain (Native BNB to USDT)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:56&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0x55d398326f99059fF775485246999027B3197955&amount=0.01&walletAddress=0xYourWalletAddress&slippage=1"

Swap on Arbitrum (Native ETH to USDC)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:42161&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0xaf88d065e77c8cC2239327C5EDb3A432268e5831&amount=0.01&walletAddress=0xYourWalletAddress&slippage=1"

Swap on Polygon (Native MATIC to USDC)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:137&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359&amount=10&walletAddress=0xYourWalletAddress&slippage=1"

Swap on Avalanche (Native AVAX to USDC)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:43114&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E&amount=1&walletAddress=0xYourWalletAddress&slippage=1"

Swap on Optimism (Native ETH to USDC)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:10&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85&amount=0.01&walletAddress=0xYourWalletAddress&slippage=1"

Swap with Priority Fee (Solana - Preset)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=YourWalletAddress&slippage=1&priorityFee=high"

This example uses the high preset (500,000 microLamports/CU) to prioritize the transaction during network congestion.

Swap with Priority Fee (Solana - Custom Value)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=YourWalletAddress&slippage=1&priorityFee=250000"

This example uses a custom priority fee of 250,000 microLamports per compute unit.

Swap with Priority Fee (Solana - Auto)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=YourWalletAddress&slippage=1&priorityFee=auto"

This example lets the system automatically determine the optimal priority fee based on current network conditions.

Swap with Jito Tip (Solana)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=YourWalletAddress&slippage=1&jitoTipLamports=10000"

This example adds a Jito tip of 10,000 lamports (0.00001 SOL) to the transaction for block engine priority.

Swap with Jito Tip + Priority Fee (Solana - Recommended)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=YourWalletAddress&slippage=1&priorityFee=high&jitoTipLamports=100000"

This example combines both priority fee and Jito tip for maximum transaction priority during high network congestion.

Swap with Fee Abstraction / PayerAddress (Solana)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=UserWalletAddress&slippage=1&payerAddress=SponsorWalletAddress"

This example uses fee abstraction where:

walletAddress (UserWalletAddress) is the user who owns the tokens and executes the swap
payerAddress (SponsorWalletAddress) is the sponsor/service that pays the transaction fees (SOL rent/gas) and signs the transaction
The sponsor wallet needs to sign the transaction, but the swap is executed for the user wallet

Swap with Fee (EVM)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=evm:1&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&tokenOut=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&amount=1&walletAddress=0xYourWalletAddress&feePercentage=0.5"

This example charges a 0.5% fee on an EVM swap:

Fee is applied via MobulaRouter

Swap with Fee (Buy - SOL to Token)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=YourWalletAddress&slippage=1&feePercentage=1&feeWallet=FeeWalletAddressHere"

This example charges a 1% fee on SOL (quote token) for a buy order:

User inputs: 1 SOL (SOL is the quote token)
Fee sent to fee wallet: 0.01 SOL
Amount used for swap: 0.99 SOL
User receives: full swap output in USDC

Swap with Fee (Sell - Token to SOL)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&tokenOut=So11111111111111111111111111111111111111111&amount=100&walletAddress=YourWalletAddress&slippage=1&feePercentage=0.5&feeWallet=FeeWalletAddressHere"

This example charges a 0.5% fee on SOL (quote token) after the swap:

User inputs: 100 USDC (USDC is a stablecoin, but SOL is also a quote token)
If USDC is detected as the quote → Fee on input: 0.5 USDC → 99.5 USDC swapped
If SOL is detected as the quote → Fee on output: 0.5% of output SOL goes to fee wallet

Swap with Fee (Meme Token to SOL)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=MemeTokenAddress&tokenOut=So11111111111111111111111111111111111111111&amount=1000000&walletAddress=YourWalletAddress&slippage=5&feePercentage=1&feeWallet=FeeWalletAddressHere"

This example charges a 1% fee on SOL (quote token) after the swap:

User inputs: 1,000,000 MEME tokens (MEME is base token)
Full amount used for swap
Fee on output: 1% of output SOL (weighted by slippage) sent to fee wallet
User receives: remaining SOL after fee

Swap with Minimum Native Fee (Solana)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=MemeTokenAddress&amount=1&walletAddress=YourWalletAddress&slippage=5&feePercentage=0.1&feeWallet=FeeWalletAddressHere&minFeesNative=0.03"

Floors the SOL referral fee at 0.03 SOL: the effective referral fee is max(amountIn × 0.1% , 0.03 SOL). Honored on-chain by MobulaRouter because SOL is the fee asset (the quote side of the SOL ↔ meme pair). Requires feeWallet.

Swap with Flat Token Fee (Solana)

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=YourWalletAddress&slippage=1&feeWallet=FeeWalletAddressHere&feeToken=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&minFeesTokenRaw=1000000"

Charges a flat minimum fee of 1000000 raw units (1 USDC) of feeToken to feeWallet, via a dedicated instruction added next to the swap. Works regardless of the route — set feeToken to any SPL mint. The transaction reverts if the user does not hold enough of the fee token. Requires feeWallet.

TON Swap with Minimum Native Fee

curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=ton:mainnet&tokenIn=EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c&tokenOut=EQBL58cH_GfHhfdopPfcAW59dJmQPiZG-qokeJmL3V4cioTX&amount=1&walletAddress=YourTonWalletAddress&slippage=1&feePercentage=0.5&minFeesNative=0.1&feeWallet=FeeWalletAddressHere"

This example applies a caller referral fee with a 0.1 TON floor. The effective referral fee is the higher value between the percentage fee and minFeesNative.

Response Format

Supports Solana and 13 EVM chains. See Supported EVM Chains above for the full list.

EVM Response

{
  "data": {
    "evm": {
      "transaction": {
        "to": "0x0005ea38eb0a69d1253508ebdbdb9ea8cb26b5ef",
        "from": "0xYourWalletAddress",
        "data": "0xcc442db6...",
        "value": "1000000000000000000",
        "chainId": 8453
      }
    },
    "amountOutTokens": "2051.991234",
    "amountInUSD": 2060.50,
    "amountOutUSD": 2051.99,
    "marketImpactPercentage": 0.41,
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "details": {
      "route": [...],
      "aggregator": "KyberSwap"
    },
    "tokenIn": {
      "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "name": "Ether",
      "symbol": "ETH",
      "decimals": 18,
      "logo": "https://metadata.mobula.io/assets/logos/evm_8453_0x4200000000000000000000000000000000000006.webp"
    },
    "tokenOut": {
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "logo": "https://metadata.mobula.io/assets/logos/evm_8453_0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.webp"
    }
  }
}

EVM-specific fields:

evm.transaction.to — MobulaRouter contract address on the target chain
evm.transaction.from — Your wallet address
evm.transaction.data — Encoded calldata for the executeAggregatorSwap function
evm.transaction.value — Native token amount in wei (non-zero for native token input swaps, "0" for ERC-20 input)
evm.transaction.chainId — Numeric chain ID
details.aggregator — Name of the aggregator used for this swap (e.g., "KyberSwap")

Calling MobulaRouter directly from Solidity? See Smart Contract Integration: MobulaRouter for the canonical ABI, struct layout, custom error reference, fee model, slippage semantics, pause/upgrade policy and a Foundry test snippet.

Solana Response

{
  "data": {
    "solana": {
      "transaction": {
        "serialized": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDMzMzMzMzMzMzMzMzMzMzMzMzMzMz...",
        "variant": "versioned"
      },
      "lastValidBlockHeight": 305123456
    },
    "estimatedAmountOut": "99500000",
    "estimatedSlippage": 0.5,
    "requestId": "123e4567-e89b-12d3-a456-426614174000",
    "tokenIn": {
      "address": "So11111111111111111111111111111111111111111",
      "name": "Wrapped SOL",
      "symbol": "SOL",
      "decimals": 9,
      "logo": "https://metadata.mobula.io/assets/logos/solana_solana_So11111111111111111111111111111111111111111.webp"
    },
    "tokenOut": {
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "logo": "https://metadata.mobula.io/assets/logos/solana_solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.webp"
    }
  }
}

Response Fields

Data Object

For Solana:

solana (object, optional) — Solana transaction container
- transaction (object) — Transaction details
  - serialized (string) — Base64 encoded serialized transaction
  - variant (enum: legacy | versioned) — Transaction variant
- lastValidBlockHeight (number) — The last block height at which the blockhash used in this transaction is valid. Use this to check if the transaction has expired before sending.

Common Fields:

estimatedAmountOut (string, optional) — Estimated output amount in tokenOut’s base units
estimatedSlippage (number, optional) — Estimated slippage percentage
requestId (string) — Unique identifier for tracking this request. Keep this ID and provide it to the Mobula team if you encounter any issues.
fee (object, optional) — Fee details (only present if fee was applied)
- amount (string) — Fee amount in human-readable format
- percentage (number) — Fee percentage that was applied
- wallet (string) — Wallet address receiving the fee
- deductedFrom (enum: input | output) — Whether fee was deducted from input (buy) or output (sell)
tokenIn (object, optional) — Input token metadata
- address (string) — Token contract address
- name (string, optional) — Token name
- symbol (string, optional) — Token symbol
- decimals (number) — Token decimals
- logo (string | null, optional) — Token logo URL (resolved via CDN if available in storage, otherwise null)
tokenOut (object, optional) — Output token metadata
- address (string) — Token contract address
- name (string, optional) — Token name
- symbol (string, optional) — Token symbol
- decimals (number) — Token decimals
- logo (string | null, optional) — Token logo URL (resolved via CDN if available in storage, otherwise null)

Error Field

error (string, optional) — Error message if the quote failed. If you receive an error, please report it to the Mobula team along with the requestId for faster resolution.

Example Responses

Successful Solana Swap Quote

{
  "data": {
    "solana": {
      "transaction": {
        "serialized": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDMzMzMzMzMzMzMzMzMzMzMzMzMzMz...",
        "variant": "versioned"
      },
      "lastValidBlockHeight": 305123456
    },
    "estimatedAmountOut": "99750000",
    "estimatedSlippage": 0.25,
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "tokenIn": {
      "address": "So11111111111111111111111111111111111111111",
      "name": "Wrapped SOL",
      "symbol": "SOL",
      "decimals": 9,
      "logo": "https://metadata.mobula.io/assets/logos/solana_solana_So11111111111111111111111111111111111111111.webp"
    },
    "tokenOut": {
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "logo": "https://metadata.mobula.io/assets/logos/solana_solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.webp"
    }
  }
}

Successful Swap Quote with Fee (Buy)

{
  "data": {
    "solana": {
      "transaction": {
        "serialized": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDMzMzMzMzMzMzMzMzMzMzMzMzMzMz...",
        "variant": "versioned"
      },
      "lastValidBlockHeight": 305123456
    },
    "estimatedAmountOut": "148500000",
    "estimatedSlippage": 1.0,
    "requestId": "880e8400-e29b-41d4-a716-446655440003",
    "fee": {
      "amount": "0.01",
      "percentage": 1,
      "wallet": "FeeWalletAddress111111111111111111111111111",
      "deductedFrom": "input"
    },
    "tokenIn": {
      "address": "So11111111111111111111111111111111111111111",
      "name": "Wrapped SOL",
      "symbol": "SOL",
      "decimals": 9,
      "logo": "https://metadata.mobula.io/assets/logos/solana_solana_So11111111111111111111111111111111111111111.webp"
    },
    "tokenOut": {
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "logo": "https://metadata.mobula.io/assets/logos/solana_solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.webp"
    }
  }
}

Successful Swap Quote with Fee (Sell)

{
  "data": {
    "solana": {
      "transaction": {
        "serialized": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDMzMzMzMzMzMzMzMzMzMzMzMzMzMz...",
        "variant": "versioned"
      },
      "lastValidBlockHeight": 305123456
    },
    "estimatedAmountOut": "985050000",
    "estimatedSlippage": 1.0,
    "requestId": "990e8400-e29b-41d4-a716-446655440004",
    "fee": {
      "amount": "0.0049005",
      "percentage": 0.5,
      "wallet": "FeeWalletAddress111111111111111111111111111",
      "deductedFrom": "output"
    },
    "tokenIn": {
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "logo": "https://metadata.mobula.io/assets/logos/solana_solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.webp"
    },
    "tokenOut": {
      "address": "So11111111111111111111111111111111111111111",
      "name": "Wrapped SOL",
      "symbol": "SOL",
      "decimals": 9,
      "logo": "https://metadata.mobula.io/assets/logos/solana_solana_So11111111111111111111111111111111111111111.webp"
    }
  }
}

Quote with Error

{
  "data": {
    "estimatedAmountOut": "0",
    "estimatedSlippage": 5.0,
    "requestId": "770e8400-e29b-41d4-a716-446655440002"
  },
  "error": "Insufficient liquidity for the requested swap amount"
}

Important Notes

Native Token Address:
- EVM chains: Use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native tokens (ETH, BNB, MATIC, etc.)
- Solana:
  - Use So11111111111111111111111111111111111111111 for native SOL (ends with 1) - this is what users typically hold in their wallet
  - So11111111111111111111111111111111111111112 (ends with 2) is Wrapped SOL (WSOL) - only use this if you specifically hold WSOL tokens
  - Automatic wrap/unwrap: If you use the native SOL address, we automatically handle the wrapping and unwrapping internally. You don’t need to manage WSOL yourself
Amount Format:
- Use amount for human-readable amounts (e.g., "1.5" for 1.5 tokens). The API will automatically convert to raw units using the token’s decimals.
- Use amountRaw for raw amounts as a string (e.g., "1500000" for 1.5 USDC with 6 decimals). This avoids precision loss and is useful when you already have the raw amount.
- Either amount OR amountRaw must be provided, but not both.
Token Decimals: Each token has a decimals property (typically 18 for ETH, 6 for USDC, 8 for BTC). Raw amount = human-readable amount × 10^decimals. For example, 1.5 USDC (6 decimals) = 1,500,000 raw units.
Blockchain Support: Supports Solana and 14 EVM chains: Ethereum (evm:1), Optimism (evm:10), BNB Chain (evm:56), Gnosis (evm:100), Polygon (evm:137), Monad (evm:143), Mantle (evm:5000), MegaETH (evm:4326), Base (evm:8453), Arbitrum (evm:42161), Avalanche (evm:43114), Linea (evm:59144), Blast (evm:81457), and Scroll (evm:534352). All EVM swaps are routed through MobulaRouter for optimal aggregator pricing.
Solana Transactions: Base64 encoded and ready to be deserialized, signed, and sent
Slippage: Higher slippage increases success rate but may result in worse execution prices
Request ID: Always keep the requestId from the response. In case of any issues or errors, provide this ID to the Mobula team for faster troubleshooting and resolution.
onlyProtocols Behavior: This parameter only restricts routing to a subset of tradable pool types. Non-tradable pool types will be automatically filtered out. You cannot extend beyond the base set of tradable protocols.
excludedProtocols Behavior: You can specify any factory address to exclude from routing, regardless of whether it’s tradable or not.
onlyRouters Behavior: Restricts the swap routing to specific providers. Supported routers are: jupiter (Solana only), kyberswap (EVM chains), and lifi (EVM chains). You can specify multiple routers by separating them with commas. If not specified, all available routers for the chain will be used.
Fee Behavior:
- Fee percentage must be between 0.01% and 99%. Default is 0% (no fee).
- On EVM chains: Fee is applied via MobulaRouter
- On Solana: Both feePercentage and feeWallet must be provided together:
  - Fee is ALWAYS deducted from native SOL and transferred via SystemProgram.transfer
  - If tokenIn is native SOL → Fee is deducted from input SOL before the swap
  - If tokenOut is native SOL → Fee is deducted from output SOL after the swap (adjusted for slippage)
  - Note: At least one side of the swap must be native SOL for fees to apply
  - If neither token is SOL → Fallback to quote token logic (stablecoins first)
  - The fee transfer is included in the same transaction as the swap, so it’s atomic
Priority Fee (Solana):
- Use priority fees to increase transaction landing rate during network congestion
- Presets: low (10,000), medium (100,000), high (500,000), veryHigh (1,000,000) microLamports/CU
- auto mode dynamically estimates the optimal fee based on network conditions
- Alternatively, specify an exact value in microLamports per compute unit
- The estimated cost is: priorityFee * computeUnitLimit / 1,000,000 lamports
Jito Tip (Solana):
- Use Jito tips to prioritize your transaction via Jito’s block engine
- Tips are sent to one of Jito’s official tip accounts
- Specified in lamports (e.g., 10000 = 0.00001 SOL)
- Works independently from priorityFee - for best results, use both together
- Jito tips help ensure faster transaction inclusion during high congestion
Fee Abstraction / PayerAddress (Solana):
- Use the payerAddress parameter to specify a different wallet that pays transaction fees
- The payerAddress wallet will be the fee payer and signer of the transaction
- The swap is still executed for walletAddress (token transfers use this wallet)
- Useful for sponsoring user transactions or abstracting gas fees
- The payerAddress needs SOL to pay for rent/transaction fees

Next Steps

For Solana Transactions

After receiving a quote:

Save the requestId for troubleshooting purposes
Decode the base64 serialized transaction
Deserialize based on the variant field (legacy or versioned)
Sign it with your Solana wallet
Send to the network using your preferred RPC

Example:

const { solana, requestId } = response.data;

// Save requestId for support
console.log('Request ID:', requestId);

const txBuffer = Buffer.from(solana.transaction.serialized, 'base64');
const { lastValidBlockHeight } = solana;

if (solana.transaction.variant === 'versioned') {
  const tx = VersionedTransaction.deserialize(txBuffer);
  tx.sign([wallet]);
  
  // Send with confirmation using lastValidBlockHeight
  const signature = await connection.sendTransaction(tx);
  await connection.confirmTransaction({
    signature,
    blockhash: tx.message.recentBlockhash,
    lastValidBlockHeight,
  });
  console.log('Transaction confirmed:', signature);
} else {
  const tx = Transaction.from(txBuffer);
  tx.partialSign(wallet);
  
  // Send with confirmation using lastValidBlockHeight
  const signature = await connection.sendTransaction(tx);
  await connection.confirmTransaction({
    signature,
    blockhash: tx.recentBlockhash,
    lastValidBlockHeight,
  });
  console.log('Transaction confirmed:', signature);
}

For EVM Transactions

After receiving a quote:

Save the requestId for troubleshooting purposes
The response contains a ready-to-sign transaction in evm field
Sign and send it using your preferred web3 library (ethers.js, viem, web3.js)

Example:

const { evm, requestId } = response.data;

// Save requestId for support
console.log('Request ID:', requestId);

// Using ethers.js
const tx = await signer.sendTransaction({
  to: evm.transaction.to,     // MobulaRouter address
  from: evm.transaction.from,
  data: evm.transaction.data, // Encoded executeAggregatorSwap calldata
  value: evm.transaction.value,
  chainId: evm.transaction.chainId,
});

await tx.wait();
console.log('Transaction confirmed:', tx.hash);

Supported EVM chains: Ethereum (evm:1), Optimism (evm:10), BNB Chain (evm:56), Gnosis (evm:100), Polygon (evm:137), Monad (evm:143), Mantle (evm:5000), MegaETH (evm:4326), Base (evm:8453), Arbitrum (evm:42161), Avalanche (evm:43114), Linea (evm:59144), Blast (evm:81457), Scroll (evm:534352).

Use Cases

DEX Aggregation: Get the best swap rates across multiple DEXs
Trading Bots: Automated trading with optimal routing
DeFi Applications: Integrate swap functionality into your dApp
Price Comparison: Compare swap rates before execution

Batch Swap Quoting (POST)

For applications that need to fetch multiple swap quotes simultaneously, use the batch endpoint. This allows you to submit up to 30 swap quote requests in a single API call, significantly reducing latency compared to multiple individual requests.

Endpoint

POST /api/2/swap/quoting

Request Body

The request body must be a JSON object with a requests array containing between 1 and 30 swap quote items.

{
  "requests": [
    {
      "chainId": "solana",
      "tokenIn": "So11111111111111111111111111111111111111111",
      "tokenOut": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": 1,
      "walletAddress": "YourWalletAddress",
      "slippage": 1
    },
    {
      "chainId": "evm:1",
      "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "amountRaw": "1000000000000000000",
      "walletAddress": "0xYourWalletAddress",
      "slippage": 2
    }
  ]
}

Request Item Fields

Each item in the requests array supports the following fields:

Field	Type	Required	Description
`chainId`	string	Yes	Blockchain identifier (e.g., `solana`, `evm:1`, `ethereum`)
`tokenIn`	string	Yes	Address of the token to swap from
`tokenOut`	string	Yes	Address of the token to swap to
`amount`	number	Yes*	Human-readable amount (e.g., `1.5` for 1.5 tokens)
`amountRaw`	string	Yes*	Raw amount as string (e.g., `"1500000"` for 1.5 USDC)
`walletAddress`	string	Yes	Wallet address that will execute the swap
`slippage`	number	No	Maximum slippage percentage (0-100). Default: `1`
`excludedProtocols`	string[]	No	Array of factory addresses to exclude
`onlyProtocols`	string[]	No	Array of pool types to restrict routing
`poolAddress`	string	No	Specific pool address to use
`onlyRouters`	string[]	No	Array of routers (`jupiter`, `kyberswap`, `lifi`)
`onlyVerifiedTokens`	boolean	No	When `true`, rejects quotes where `tokenOut` is an unverified launchpad token. Default: `false`
`priorityFee`	string \| number \| object	No	Solana priority fee: `auto`, preset (`low`, `medium`, `high`, `veryHigh`), or number in microLamports/CU
`computeUnitLimit`	boolean \| number	No	Solana compute unit limit: `true` for dynamic or specific number
`payerAddress`	string	No	Solana fee abstraction: wallet address that pays transaction fees and signs (instead of `walletAddress`)

*Either amount OR amountRaw must be provided (but not both) for each request item.

Batch Usage Examples

Basic Batch Request

curl -X POST "https://api.mobula.io/api/2/swap/quoting" \
  -H "Content-Type: application/json" \
  -d '{
    "requests": [
      {
        "chainId": "solana",
        "tokenIn": "So11111111111111111111111111111111111111111",
        "tokenOut": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "amount": 1,
        "walletAddress": "YourSolanaWallet",
        "slippage": 1
      },
      {
        "chainId": "solana",
        "tokenIn": "So11111111111111111111111111111111111111111",
        "tokenOut": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
        "amount": 0.5,
        "walletAddress": "YourSolanaWallet",
        "slippage": 1
      }
    ]
  }'

Multi-Chain Batch Request

curl -X POST "https://api.mobula.io/api/2/swap/quoting" \
  -H "Content-Type: application/json" \
  -d '{
    "requests": [
      {
        "chainId": "solana",
        "tokenIn": "So11111111111111111111111111111111111111111",
        "tokenOut": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "amount": 1,
        "walletAddress": "YourSolanaWallet"
      },
      {
        "chainId": "evm:1",
        "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
        "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "amount": 0.1,
        "walletAddress": "0xYourEVMWallet"
      },
      {
        "chainId": "evm:42161",
        "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
        "tokenOut": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "amountRaw": "100000000000000000",
        "walletAddress": "0xYourEVMWallet",
        "slippage": 2
      }
    ]
  }'

Batch with Router Restrictions

curl -X POST "https://api.mobula.io/api/2/swap/quoting" \
  -H "Content-Type: application/json" \
  -d '{
    "requests": [
      {
        "chainId": "solana",
        "tokenIn": "So11111111111111111111111111111111111111111",
        "tokenOut": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "amount": 1,
        "walletAddress": "YourSolanaWallet",
        "onlyRouters": ["jupiter"]
      },
      {
        "chainId": "evm:1",
        "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
        "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "amount": 1,
        "walletAddress": "0xYourEVMWallet",
        "onlyRouters": ["kyberswap", "lifi"]
      }
    ]
  }'

Batch Response Format

{
  "results": [
    {
      "data": {
        "solana": {
          "transaction": {
            "serialized": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDMzMzMzMzMzMzMzMzMzMzMzMzMzMz...",
            "variant": "versioned"
          },
          "lastValidBlockHeight": 305123456
        },
        "amountOutTokens": "99500000",
        "slippagePercentage": 0.5,
        "amountInUSD": 150.25,
        "amountOutUSD": 149.50,
        "marketImpactPercentage": 0.1,
        "tokenIn": {
          "address": "So11111111111111111111111111111111111111111",
          "name": "Wrapped SOL",
          "symbol": "SOL",
          "decimals": 9
        },
        "tokenOut": {
          "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "name": "USD Coin",
          "symbol": "USDC",
          "decimals": 6
        },
        "requestId": "550e8400-e29b-41d4-a716-446655440000"
      },
      "index": 0
    },
    {
      "data": {
        "evm": {
          "transaction": {
            "to": "0x...",
            "from": "0x...",
            "data": "0x...",
            "value": "1000000000000000000",
            "chainId": 1
          }
        },
        "amountOutTokens": "99000000",
        "slippagePercentage": 1.0,
        "requestId": "660e8400-e29b-41d4-a716-446655440001"
      },
      "index": 1
    }
  ],
  "totalRequests": 2,
  "successCount": 2,
  "errorCount": 0
}

Batch Response Fields

Field	Type	Description
`results`	array	Array of quote results, one for each request
`results[].data`	object	Quote data (same format as single quote response)
`results[].error`	string	Error message if this specific quote failed
`results[].index`	number	Index of the request in the original batch (0-based)
`totalRequests`	number	Total number of requests in the batch
`successCount`	number	Number of successful quotes
`errorCount`	number	Number of failed quotes

Batch Error Handling

In batch mode, individual request failures don’t fail the entire batch. Each result includes its own error field if that specific quote failed:

{
  "results": [
    {
      "data": {
        "solana": { "..." },
        "amountOutTokens": "99500000",
        "requestId": "550e8400-e29b-41d4-a716-446655440000"
      },
      "index": 0
    },
    {
      "data": {
        "requestId": "660e8400-e29b-41d4-a716-446655440001"
      },
      "error": "Insufficient liquidity for the requested swap amount",
      "index": 1
    }
  ],
  "totalRequests": 2,
  "successCount": 1,
  "errorCount": 1
}

Batch Limitations

Maximum 30 requests per batch
Minimum 1 request per batch
All requests are processed in parallel for optimal performance
Each request is independent - failures don’t affect other requests

Batch Use Cases

Portfolio Rebalancing: Get quotes for multiple swaps needed to rebalance a portfolio
Price Comparison: Compare swap rates across different token pairs simultaneously
Multi-Chain Operations: Get quotes for the same swap on different chains
Trading Strategies: Pre-fetch multiple potential swap quotes for algorithmic trading
UI Pre-loading: Fetch multiple quotes in advance to improve user experience

Query Parameters

chainId

string

Mobula chain id. EVM: evm:<integer> (e.g. evm:1, evm:8453, evm:42161). Solana: solana:solana. TON: ton:mainnet or ton:testnet.

tokenIn

string

required

Sell token address. Native sentinels — EVM: 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (EIP-7528). Solana: So11111111111111111111111111111111111111112 (wSOL). TON: EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c.

Minimum string length: 1

tokenOut

string

required

Buy token address. Same sentinel rules as tokenIn.

Minimum string length: 1

amount

string

Human-readable amount (e.g. "1.5" for 1.5 tokens). Converted server-side: raw = amount × 10^decimals. Mutually exclusive with amountRaw.

amountRaw

string

Raw amount as a digit-only string (e.g. "1500000" for 1.5 USDC at 6 decimals). Use this when you already have the bigint to avoid float precision loss. Mutually exclusive with amount.

slippage

string

Slippage tolerance in % (0-100, default 1). Quote rejects if expected output drops below this threshold.

maxMarketImpactPercentage

Optional market impact guard in %. If the computed marketImpactPercentage is greater than this value, the quote is rejected with HTTP 400.

walletAddress

string

required

User wallet address — recipient of tokenOut, signer for the broadcast tx, fee context.

Minimum string length: 1

excludedProtocols

DEX-level deny list (CSV). Example: pump-amm,raydium.

onlyProtocols

DEX-level allow list (CSV). Example: uniswap-v3,uniswap-v4.

poolAddress

string

Pin routing to a single pool (e.g. when you want a specific Uniswap V3 fee tier).

onlyRouters

string

Aggregator filter (CSV) — jupiter, kyberswap, lifi, naos. Omit to let the API pick.

priorityFee

string

Solana only. auto, low, medium, high, veryHigh, or microLamports per CU as a number string.

computeUnitLimit

string

Solana only. true for dynamic CU limit, or a fixed integer (default 400 000).

jitoTipLamports

string

Solana only. Jito tip in lamports — adds a transfer to one of the Jito tip accounts for fast landing.

feePercentage

Caller referral fee in % (0-99). Mobula skims a 20% platform cut off the top. Requires feeWallet.

feeWallet

string

Wallet that receives the caller referral fee. Required when feePercentage > 0.

minFeesNative

Minimum caller referral fee in native-token units. Currently honored on TON native-input swaps; requires feeWallet.

feeToken

string

Solana only. Mint of a token in which to charge a flat MINIMUM fee (paired with minFeesTokenRaw). Charged via a separate transfer to feeWallet, independent of the swap route. Requires feeWallet.

minFeesTokenRaw

Solana only. Raw amount (smallest unit) of feeToken to charge as a flat minimum fee. The swap reverts if the user lacks balance.

payerAddress

string

Solana only. Fee abstraction — wallet that signs/pays for the tx (separate from walletAddress).

multiLander

string

Solana only. true returns N candidate transactions over a durable nonce — race them across landers (Jito, Nozomi, 0slot). Only one commits.

landerTipLamports

string

Per-lander tip when multiLander=true. Defaults to each lander's minimum.

Response

Swap quoting response

data

object

required

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

error

string

Set on routing failures (no route, slippage too tight, upstream timeout). The data block still carries requestId for support.

Smart Contract Integration Swap Instructions

⌘I

​Overview

​Supported EVM Chains

​Query Parameters

​Amount Specification

​Understanding Token Decimals

​Fees

​Usage Examples

​Basic Swap Quote with Native SOL (Human-readable Amount)

​Basic Swap Quote with Native SOL (Raw Amount)

​Swap with Excluded Protocols (Human-readable Amount)

​Swap with Excluded Protocols (Raw Amount)

​Swap with Specific Pool Type (Human-readable Amount)

​Swap with Specific Pool Type (Raw Amount)

​Swap with Specific Router (Solana - Jupiter)

​Swap with Specific Router (EVM - KyberSwap)

​Swap with Multiple Routers (EVM - KyberSwap and LiFi)

​Swap on Base (Native ETH to USDC)

​Swap on BNB Chain (Native BNB to USDT)

​Swap on Arbitrum (Native ETH to USDC)

​Swap on Polygon (Native MATIC to USDC)

​Swap on Avalanche (Native AVAX to USDC)

​Swap on Optimism (Native ETH to USDC)

​Swap with Priority Fee (Solana - Preset)

​Swap with Priority Fee (Solana - Custom Value)

​Swap with Priority Fee (Solana - Auto)

​Swap with Jito Tip (Solana)

​Swap with Jito Tip + Priority Fee (Solana - Recommended)

​Swap with Fee Abstraction / PayerAddress (Solana)

​Swap with Fee (EVM)

​Swap with Fee (Buy - SOL to Token)

​Swap with Fee (Sell - Token to SOL)

​Swap with Fee (Meme Token to SOL)

​Swap with Minimum Native Fee (Solana)

​Swap with Flat Token Fee (Solana)

​TON Swap with Minimum Native Fee

​Response Format

​EVM Response

​Solana Response

​Response Fields

​Data Object

​Error Field

​Example Responses

​Successful Solana Swap Quote

​Successful Swap Quote with Fee (Buy)

​Successful Swap Quote with Fee (Sell)

​Quote with Error

​Important Notes

​Next Steps

​For Solana Transactions

​For EVM Transactions

​Use Cases

​Batch Swap Quoting (POST)

​Endpoint

​Request Body

​Request Item Fields

​Batch Usage Examples

​Basic Batch Request

​Multi-Chain Batch Request

​Batch with Router Restrictions

​Batch Response Format

​Batch Response Fields

​Batch Error Handling

​Batch Limitations

​Batch Use Cases

Query Parameters

Response

Overview

Supported EVM Chains

Query Parameters

Amount Specification

Understanding Token Decimals

Fees

Usage Examples

Basic Swap Quote with Native SOL (Human-readable Amount)

Basic Swap Quote with Native SOL (Raw Amount)

Swap with Excluded Protocols (Human-readable Amount)

Swap with Excluded Protocols (Raw Amount)

Swap with Specific Pool Type (Human-readable Amount)

Swap with Specific Pool Type (Raw Amount)

Swap with Specific Router (Solana - Jupiter)

Swap with Specific Router (EVM - KyberSwap)

Swap with Multiple Routers (EVM - KyberSwap and LiFi)

Swap on Base (Native ETH to USDC)

Swap on BNB Chain (Native BNB to USDT)

Swap on Arbitrum (Native ETH to USDC)

Swap on Polygon (Native MATIC to USDC)

Swap on Avalanche (Native AVAX to USDC)

Swap on Optimism (Native ETH to USDC)

Swap with Priority Fee (Solana - Preset)

Swap with Priority Fee (Solana - Custom Value)

Swap with Priority Fee (Solana - Auto)

Swap with Jito Tip (Solana)

Swap with Jito Tip + Priority Fee (Solana - Recommended)

Swap with Fee Abstraction / PayerAddress (Solana)

Swap with Fee (EVM)

Swap with Fee (Buy - SOL to Token)

Swap with Fee (Sell - Token to SOL)

Swap with Fee (Meme Token to SOL)

Swap with Minimum Native Fee (Solana)

Swap with Flat Token Fee (Solana)

TON Swap with Minimum Native Fee

Response Format

EVM Response

Solana Response

Response Fields

Data Object

Error Field

Example Responses

Successful Solana Swap Quote

Successful Swap Quote with Fee (Buy)

Successful Swap Quote with Fee (Sell)

Quote with Error

Important Notes

Next Steps

For Solana Transactions

For EVM Transactions

Use Cases

Batch Swap Quoting (POST)

Endpoint

Request Body

Request Item Fields

Batch Usage Examples

Basic Batch Request

Multi-Chain Batch Request

Batch with Router Restrictions

Batch Response Format

Batch Response Fields

Batch Error Handling

Batch Limitations

Batch Use Cases