Bridge Quote

​

Query parameters

​

Response

{
  "data": {
    "intentId": "a3b4ba1-e34523c-324",
    "deadline": 1764032100,
    "typedData": { /* EIP-712 payload to sign — see Signed-quote flow */ },
    "signatureRequired": true,
    "prediction": { "persisted": false },
    "estimatedAmountOut": "0.68421052",
    "estimatedAmountOutUsd": "1.99",
    "recommendedSlippage": 1.5,
    "fees": {
      "bridgeFeeBps": 5,
      "bridgeFeeUsd": "0.0010",
      "destFillGasUsd": "0.0800",
      "gasFeeUsd": "0.0800",
      "totalFeeUsd": "0.0810",
      "destActivationCostUsd": "0.0020"
    },
    "estimatedTimeMs": 1000,
    "maxTradeUsd": 400,
    "destinationType": "spot",
    "originType": "spot",
    "steps": [ /* optional, see below */ ],
    "deposit": { /* one of evm | solana | hl */ }
  }
}

• intentId is the user-facing handle, format xxxxxxx-xxxxxxx-xxx (lowercase hex). Pass it to GET /status/:id or /status/:id/wait. There is also an on-chain bytes32 intent ID emitted by MobulaBridge on EVM deposits — both resolve in /status/:id, so use whichever you have. You must echo this exact intentId back via the intentId query param when submitting the signature — the signed payload binds to it.
• deadline is Unix seconds. The server rejects signed calls past this point.
• typedData is the EIP-712 structured-data payload your wallet should sign (see Signed-quote flow for the full schema).
• signatureRequired: true for evm:* and hl:mainnet origins. false for solana:solana (the depositor-signed memo replaces the signature).
• prediction.persisted indicates whether the server has committed your signed intent. false on the unsigned preview call; true after a successful signed call.
• steps is present only when the deposit needs more than one transaction. Today that means EVM ERC-20 origins: [approve, bridgeToken | swapAndBridge]. Native EVM bridges and Solana/HL bridges omit steps.
• recommendedSlippage is the slippage % we suggest signing with — the route’s implied spread ((1 − outUsd/inUsd)×100) plus a 0.5% drift buffer, rounded up to 0.1, floored at 1, and capped at 50 (null when USD prices are unavailable). The solver refunds any fill below the signed minAmountOut (failure code slippage), so a tolerance under this value is a near-guaranteed refund. If your slippage is below it, re-quote at the recommendation before signing.
• fees are real, deducted amounts — there is no placeholder. bridgeFeeUsd is the Mobula protocol fee (bridgeFeeBps, currently 5); destFillGasUsd is what the solver pays to fill on the destination chain; gasFeeUsd equals destFillGasUsd. destActivationCostUsd appears only when the destination needs a one-off account-creation cost (e.g. Solana ATA rent for a first-time recipient) — it’s omitted otherwise. totalFeeUsd is the sum of all present fee fields. estimatedAmountOut / estimatedAmountOutUsd are already net of all of it; the user additionally pays only origin-chain gas to broadcast the deposit.
• destinationType / originType are echoed back only for HyperLiquid routes (spot or perps), reflecting the venue the funds land in / are pulled from.
• maxTradeUsd is $400. Amounts above that return "Amount $X exceeds maximum trade of $400".

​

deposit shapes

​

EVM origin (deposit.evm)

{
  "to": "0xa834E70303322D86E5DaE95ee47E9c6a073d9812",
  "data": "0x...",
  "value": "50000000000000000",
  "chainId": 8453,
  "approvalAddress": "0x...",      // present for ERC-20 origins
  "approvalToken": "0x...",        // present for ERC-20 origins
  "approvalAmount": "115792...255" // MAX_UINT256
}

• Native ETH/BNB/POL — single bridge() call on MobulaBridge. value is the raw amount in wei. No steps.
• Direct-bridge tokens — approve step to MobulaBridge, then bridgeToken(). value is "0". The set is USDC on all four chains, plus Base’s bridged USDbC and USDT on Arbitrum and Polygon (BSC is USDC-only).
• Any other ERC-20 — approve step to SwapBridgeHelper, then swapAndBridge() — atomic swap to native + bridge in one TX. The embedded swap calldata is validated server-side to start with the MobulaRouter.executeRoute selector (0xa564dfa4); if it doesn’t, the quote returns "Swap quote failed: invalid calldata selector".

​

Solana origin (deposit.solana)

• Native SOL — { to, amount, memo }. Build a SystemProgram.transfer for amount lamports to to (the solver address), then add a memo instruction (program MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr) whose data is the memo string. The memo is a JSON blob the solver parses to recover intentId, destinationChainId, recipient, destinationToken, and minAmountOut.
• SPL — { type: "spl-transfer", serializedTx }. The server has already built the full versioned transaction (SPL transfer + ATA creation if missing + memo). Just VersionedTransaction.deserialize, sign, and send.

​

HyperLiquid origin (deposit.hl)

{
  "type": "usdSend",
  "to": "0x74CfC17edF89aD6134c04c446c3Be6dD288F0B8d",
  "amount": "1.0"
}

​

Same-chain quotes

​

Signed-quote flow

1. Preview call — GET /quote?... with no signature. Server returns the quote, the deposit calldata, and a typedData payload. Nothing is committed yet.
2. Sign — your wallet signs typedData (e.g. eth_signTypedData_v4 for injected wallets, walletClient.signTypedData with viem). The signer’s address must equal typedData.message.sender.
3. Commit call — GET /quote?...&signature=<sig>&intentId=<id>&deadline=<ts>&minAmountOut=<raw> with the same input params as call 1. Server reconstructs the typedData from the query params, recovers the signer, and commits your signed intent if everything lines up. Returns the same response shape with prediction.persisted: true.
4. Broadcast — submit deposit.evm (or deposit.hl) on chain.

​

EIP-712 schema

Domain:
  name:    "Mobula Bridge"
  version: "1"
  chainId: <numeric origin chain id>   // 8453, 56, 42161, 137 — and 1 (NOT 999) for hl:mainnet

BridgeIntent:
  intentId           string    — same as `data.intentId` (dashed hex, signed as a string)
  sender             address   — depositor EVM key (HL origin: HL spot wallet; EVM: walletAddress)
  originChainId      string    — e.g. "evm:8453"
  originToken        string    — "0x000…0" for native, or token address / HL token id
  amountIn           uint256   — raw origin-token units
  destinationChainId string
  destinationToken   string
  recipient          bytes32   — EVM dest: address left-padded; Solana dest: bs58-decoded
  minAmountOut       uint256   — raw destination-token units, echoed back as the `minAmountOut` query param
  deadline           uint64    — Unix seconds, echoed back as the `deadline` query param

​

Failure modes on the commit call

• 400 Invalid bridge intent signature: ... — signature did not recover to the depositor address. Re-check typedData.message.sender and the signer.
• 400 Signature deadline has expired or is invalid — deadline is past now. Re-quote.
• 400 Signed-mode quote requires intentId, deadline, minAmountOut, and signature — one of the four signed-mode params is missing.

​

Side effects

​

Example

import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount("0xYourPrivKey");
const client = createWalletClient({ account, chain: base, transport: http() });

// 1. Preview call (no signature, nothing committed).
const baseParams = new URLSearchParams({
  originChainId: "evm:8453",
  destinationChainId: "evm:56",
  originToken: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", // USDC on Base
  destinationToken: "0x55d398326f99059fF775485246999027B3197955", // USDT on BSC
  amount: "100",
  walletAddress: account.address,
  senderAddress: account.address,
  apiKey: "YOUR_API_KEY",
});

const preview = await fetch(`https://api.mobula.io/api/2/bridge/quote?${baseParams}`)
  .then((r) => r.json());
if (preview.error) throw new Error(preview.error);
const { intentId, deadline, typedData, estimatedAmountOut } = preview.data;

// 2. Sign the typed data.
const signature = await client.signTypedData({
  account,
  domain: typedData.domain,
  types: typedData.types,
  primaryType: typedData.primaryType,
  message: typedData.message,
});

// 3. Commit call (server verifies + commits your signed intent).
const commitParams = new URLSearchParams(baseParams);
commitParams.set("intentId", intentId);
commitParams.set("deadline", String(deadline));
commitParams.set("minAmountOut", typedData.message.minAmountOut);
commitParams.set("signature", signature);

const committed = await fetch(`https://api.mobula.io/api/2/bridge/quote?${commitParams}`)
  .then((r) => r.json());
if (committed.error) throw new Error(committed.error);

// 4. Broadcast the on-chain deposit.
const tx = committed.data.deposit.evm; // approve+bridgeToken steps in committed.data.steps
const hash = await client.sendTransaction({
  to: tx.to,
  data: tx.data,
  value: BigInt(tx.value),
});
console.log("Deposit tx:", hash);
console.log("Poll status with:", intentId);