> ## 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.

# EVM Swap Quoting

> Quote and execute swaps on Ethereum, Base, Arbitrum, BNB Chain, Polygon, Optimism, Avalanche and 30+ EVM chains via MobulaRouter — best-route across Uniswap V2/V3/V4, Curve, Balancer, PancakeSwap, Aerodrome, Velodrome, Sushi and 200+ DEXs.

Single endpoint, same shape as Solana / TON. The EVM-specific calldata sits under `data.evm`. See the [Swap Quoting](./swap-quoting) page for the full input parameters.

## Native sentinel

```
0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
```

Standard EIP-7528 placeholder — use this `tokenIn` / `tokenOut` for the chain's native token (ETH on Ethereum/L2s, BNB on BNB Chain, MATIC on Polygon, AVAX on Avalanche, …). The router wraps/unwraps automatically.

## Supported chains

| Chain                                                                                                                                                                                                                              | `chainId`   | Native |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------ |
| Ethereum                                                                                                                                                                                                                           | `evm:1`     | ETH    |
| Optimism                                                                                                                                                                                                                           | `evm:10`    | ETH    |
| BNB Chain                                                                                                                                                                                                                          | `evm:56`    | BNB    |
| Polygon                                                                                                                                                                                                                            | `evm:137`   | POL    |
| Base                                                                                                                                                                                                                               | `evm:8453`  | ETH    |
| Arbitrum                                                                                                                                                                                                                           | `evm:42161` | ETH    |
| Avalanche                                                                                                                                                                                                                          | `evm:43114` | AVAX   |
| Linea, zkSync, Scroll, Mantle, Blast, Mode, Manta, Taiko, Sei, Cronos, Fantom, Gnosis, Celo, Moonbeam, Kava, Metis, opBNB, Polygon zkEVM, Merlin, BOB, Cyber, Fuse, IoTeX, Conflux, Astar zkEVM, ZKFair, XLayer, ZetaChain, Klaytn | `evm:N`     | varies |

Full list of integer chain IDs: see [`MOBULA_CHAIN_MAP`](https://github.com/MobulaFi/mobula-monorepo/blob/main/packages/chains/src/index.ts) in the chains package.

## Request

```http theme={null}
GET /api/2/swap/quoting?chainId=evm:8453
  &tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
  &tokenOut=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
  &amount=0.1
  &walletAddress=0x…
  &slippage=1
  &feePercentage=0.5
  &feeWallet=0x…
```

| Param                                 | Required | Notes                                                                 |
| ------------------------------------- | -------- | --------------------------------------------------------------------- |
| `chainId`                             | ✓        | `evm:<integer>` (e.g. `evm:8453` for Base)                            |
| `tokenIn` / `tokenOut`                | ✓        | Token contract address (lowercased OR checksummed). Native = `0xEee…` |
| `amount` *or* `amountRaw`             | ✓        | Human (`"0.1"`) or raw wei (`"100000000000000000"`)                   |
| `walletAddress`                       | ✓        | User's EVM address (`0x…`)                                            |
| `slippage`                            | –        | % (0-100, default 1)                                                  |
| `feePercentage`                       | –        | Caller referral fee 0-99%                                             |
| `feeWallet`                           | –        | Required when `feePercentage > 0`                                     |
| `onlyRouters`                         | –        | Comma-list of `kyberswap,lifi,naos`                                   |
| `excludedProtocols` / `onlyProtocols` | –        | DEX-level filter                                                      |

## Response — `data.evm`

```json theme={null}
{
  "data": {
    "amountOutTokens": "245.123",
    "amountInUSD": 250.45,
    "amountOutUSD": 249.87,
    "slippagePercentage": 1,
    "marketImpactPercentage": 0.04,
    "poolFeesPercentage": 0.3,
    "tokenIn":  { "address": "0xEee…EEeE", "symbol": "ETH",  "decimals": 18 },
    "tokenOut": { "address": "0x8335…",    "symbol": "USDC", "decimals": 6  },
    "requestId": "f8b2…",
    "details": {
      "route": {
        "hops": [
          { "poolAddress": "0x4C36…", "exchange": "Uniswap V3", "poolType": "v3", "feeBps": 5 }
        ],
        "totalFeePercentage": 0.05,
        "aggregator": "kyberswap"
      }
    },
    "fee": { "amount": "0.0005", "percentage": 0.5, "wallet": "0x…", "deductedFrom": "input" },
    "evm": {
      "transaction": {
        "to":       "0xMobulaRouter…",
        "from":     "0xUserWallet…",
        "data":     "0xCALLDATA…",
        "value":    "100000000000000000",
        "gasLimit": "350000",
        "chainId":  8453,
        "approvalAddress": "0xMobulaRouter…",
        "approvals": [{ "token": "0xUSDC…", "spender": "0xMobulaRouter…" }]
      }
    },
    "solana": null,
    "ton": null
  }
}
```

### `data.evm.transaction` fields

| Field                                                | Type                  | Description                                                           |
| ---------------------------------------------------- | --------------------- | --------------------------------------------------------------------- |
| `to`                                                 | `0x…`                 | MobulaRouter contract on the target chain                             |
| `from`                                               | `0x…`                 | Echo of `walletAddress`                                               |
| `data`                                               | `0x…`                 | Encoded call to MobulaRouter — pass through verbatim to your wallet   |
| `value`                                              | string wei            | Native token to attach (= `amountIn` for native-in swaps, else `0`)   |
| `gasLimit`                                           | string?               | Suggested gas (your wallet may simulate to refine)                    |
| `gasPrice` / `maxFeePerGas` / `maxPriorityFeePerGas` | string? wei           | Filled per chain (legacy or EIP-1559)                                 |
| `nonce`                                              | number?               | Optional — wallet picks if omitted                                    |
| `chainId`                                            | number                | EIP-155 chain id matching `chainId` query param                       |
| `approvalAddress`                                    | `0x…`?                | Where the user must `approve()` the sell token (defaults to `to`)     |
| `approvals`                                          | `{token, spender}[]`? | Pre-flight approval list — execute these before `eth_sendTransaction` |

## Signing

```ts theme={null}
// 1. Execute pre-flight approvals if any (one approve() per (token,spender)).
for (const { token, spender } of quote.data.evm.transaction.approvals ?? []) {
  await wallet.writeContract({ address: token, abi: ERC20, functionName: 'approve', args: [spender, MAX] });
}

// 2. Send the swap tx.
const txHash = await wallet.request({
  method: 'eth_sendTransaction',
  params: [{
    to:    quote.data.evm.transaction.to,
    data:  quote.data.evm.transaction.data,
    value: quote.data.evm.transaction.value,
    gas:   quote.data.evm.transaction.gasLimit,
  }],
});
```

The wallet broadcasts directly — **no `/swap/send` call needed for EVM** (the call goes straight from the user's wallet to their RPC).

## Routing

All EVM swaps go through **MobulaRouter**, deployed identically on each supported chain. Under the hood it dispatches to the best aggregator (KyberSwap, NAOS, Li.Fi) — pick one explicitly via `onlyRouters` or let the API choose. DEX filtering (Uniswap V2/V3/V4, Curve, Balancer, PancakeSwap, Aerodrome, Velodrome, Sushi, …) via `onlyProtocols` / `excludedProtocols`.

## Limits

* **Approvals required** for any non-native sell token. Always check `approvals[]` and execute first.
* **Gas estimation** — `gasLimit` is a router-level upper bound. Wallets typically simulate to tighten.
* **Address case** — both lowercased and EIP-55 checksummed accepted on input.