Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mobula.io/llms.txt

Use this file to discover all available pages before exploring further.

TL;DR: minFeesNative now works on Solana — it floors the caller referral fee in SOL and is enforced on-chain by MobulaRouter. Two new params, feeToken + minFeesTokenRaw, let you charge a flat minimum fee in any SPL token, independent of the swap route.

​
minFeesNative on Solana

minFeesNative sets a floor on the caller referral fee, previously honored only on TON. It now also applies to Solana swaps where the fee asset is native SOL (i.e. the quote side of the pair is SOL).
  • Effective referral fee = max(amountIn × feePercentage / 100, minFeesNative)
  • Enforced on-chain by MobulaRouter — not just computed off-chain
  • Honored when the fee is taken in native SOL; ignored for SPL-token fees
  • Requires feeWallet
curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=MemeTokenAddress&amount=1&walletAddress=YourWalletAddress&feePercentage=0.1&feeWallet=YourFeeWallet&minFeesNative=0.03"

​
feeToken & minFeesTokenRaw (Solana)

Charge a flat minimum fee in any SPL token, regardless of what is being swapped.
  • feeToken — mint of the token to charge in
  • minFeesTokenRaw — raw amount (smallest unit) to charge
  • Collected via a dedicated instruction added next to the swap, transferred to feeWallet
  • Independent of the swap route — the fee token does not need to be tokenIn or tokenOut
  • The transaction reverts if the user’s balance is insufficient
  • Requires feeWallet
Example — charge at least 1 USDC per swap, regardless of size or pair: 
curl -X GET "https://api.mobula.io/api/2/swap/quoting?chainId=solana&tokenIn=So11111111111111111111111111111111111111111&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1&walletAddress=YourWalletAddress&feeWallet=YourFeeWallet&feeToken=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&minFeesTokenRaw=1000000"