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.

Alpha Preview — This endpoint is in alpha and may change without notice. The API surface, response format, and supported chains may evolve.

​
Overview

The Bridge Quote endpoint returns a ready-to-sign deposit transaction for cross-chain token transfers. The Mobula solver detects deposits in real-time (via flash blocks on Base, gRPC on Solana) and fills on the destination chain. Typical latency: ~500ms for Base and Solana, ~1-3s for other chains.

​
Supported Chains

ChainChain IDBridge Contract
Baseevm:84530x867A784039D4842A32Ddd1277729Ad1373301458
BSCevm:560x7C57e0c67dE10cF1697326795326f5c8b073072c
Arbitrumevm:421610x7A0B2640E20a2e21c00E12925BEBD4a791082826
Polygonevm:1370xA28B4FFA97E475a1c584B388351092f4554C0DCC
Solanasolana:solanaSolver address (memo-based)
HyperLiquidhl:mainnetL1 bridge protocol

​
Token Support

  • Native tokens: ETH, BNB, SOL, MATIC, USDH — use 0x0000000000000000000000000000000000000000 or omit originToken/destinationToken
  • ERC-20 / SPL tokens: Any token with liquidity. For ERC-20 origins on Base, the quote uses an atomic swap+bridge via SwapBridgeHelper (single TX after approval)

​
Limits

  • Max trade: $10,000 USD per transaction
  • Slippage: Default 1%, configurable up to 50%

​
Integration Flow

  1. Call GET /2/bridge/quote with origin/destination chains, token, amount, and wallet
  2. If steps contains an approve step, send the approval TX first
  3. Send the deposit transaction from deposit.evm or deposit.solana
  4. Poll GET /2/bridge/status/{txHash} until status is filled or settled

​
SDK Usage

import { Mobula } from "@mobula/sdk";

const mobula = new Mobula({ apiKey: "YOUR_API_KEY" });

// Get bridge quote: 0.1 ETH from Base to Solana
const quote = await mobula.rest.fetchBridgeQuote({
  originChainId: "evm:8453",
  destinationChainId: "solana:solana",
  amount: "0.1",
  walletAddress: "YourSolanaAddress...",
});

console.log(quote.data.estimatedAmountOut); // e.g. "0.68421052"
console.log(quote.data.fees.totalFeeUsd);   // e.g. "0.25"
console.log(quote.data.deposit);            // ready-to-sign TX data