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

# Bridge Routes

> [Alpha Preview] List all supported cross-chain bridge routes with estimated latency and trade limits.

<Warning>
  **Alpha Preview** — Endpoints, response shape, and supported routes may change
  without notice.
</Warning>

`GET /api/2/bridge/routes` returns the static all-to-all matrix of supported
routes. Useful for building a chain selector or validating a pair before
calling `/quote`. No query parameters.

## Supported chains

| Chain ID        | Chain          | Estimated fill latency |
| --------------- | -------------- | ---------------------- |
| `evm:8453`      | Base           | \~500 ms               |
| `evm:56`        | BSC            | \~3000 ms              |
| `evm:42161`     | Arbitrum       | \~1000 ms              |
| `evm:137`       | Polygon        | \~2000 ms              |
| `solana:solana` | Solana         | \~500 ms               |
| `hl:mainnet`    | HyperLiquid L1 | \~1000 ms              |

The route list is all-to-all across these 6 chains excluding same-chain
pairs — 30 entries. Same-chain "bridges" are not in this list; calling
`/quote` with `originChainId === destinationChainId` short-circuits to the
Swap API instead.

## Response

```json theme={null}
{
  "data": {
    "routes": [
      {
        "originChainId": "evm:8453",
        "destinationChainId": "solana:solana",
        "estimatedTimeMs": 1000,
        "maxTradeUsd": 400,
        "feeBps": 5,
        "supportedTokens": "any"
      }
    ]
  }
}
```

Per-route fields:

* `estimatedTimeMs` — sum of origin and destination chain latencies
  from the table above (e.g. Base → Solana = 500 + 500 = 1000).
* `maxTradeUsd` — hard cap per intent. Currently `400` on every route.
  Amounts above this in `/quote` return `"Amount $X exceeds maximum trade of $400"`.
* `feeBps` — the Mobula protocol fee in basis points (currently `5`), the same
  value surfaced as `fees.bridgeFeeBps` on `/quote`. The full fee breakdown
  (including destination gas) is folded into `/quote`'s `estimatedAmountOut` —
  always read the deducted amounts from `/quote`, not this endpoint.
* `supportedTokens` — `"any"` on every route. The token-level support
  matrix lives in `/quote` (it picks the right code path — native bridge,
  direct-bridge token, swap-and-bridge, or SPL transfer — based on the
  token you pass).

## Example

```typescript theme={null}
const res = await fetch(
  "https://api.mobula.io/api/2/bridge/routes?apiKey=YOUR_API_KEY",
);
const { data } = await res.json();

const supportedSet = new Set(
  data.routes.map((r: any) => `${r.originChainId}->${r.destinationChainId}`),
);

// Validate a pair before quoting
if (!supportedSet.has(`${origin}->${dest}`)) {
  throw new Error(`Route ${origin} -> ${dest} not supported`);
}
```


## OpenAPI

````yaml get /2/bridge/routes
openapi: 3.0.0
info:
  version: 1.0.0
  title: Mobula API
  description: >-
    Documentation of the Mobula API


    **Demo API**: The default server (demo-api.mobula.io) is a demo API with
    rate limits.

    For production use, please use api.mobula.io with an API key from
    https://admin.mobula.io
servers:
  - url: https://demo-api.mobula.io/api/
    description: Demo API (rate limited, for testing only)
  - url: https://api.mobula.io/api/
    description: Production API (requires API key)
security: []
tags:
  - name: V2 - Token
    description: Token details, price, security, ATH, and holder data
  - name: V2 - Market Data
    description: Market details, OHLCV history, and lighthouse metrics
  - name: V2 - Trades
    description: Token trades, enriched trades, and trade filters
  - name: V2 - Wallet
    description: Wallet positions, activity, trades, analysis, and labels
  - name: V2 - Assets
    description: Cross-chain asset details and price history
  - name: V2 - Swap
    description: Swap quoting and execution
  - name: V2 - Perps
    description: Perpetual futures quoting, execution, and positions
  - name: V2 - Bridge
    description: Cross-chain bridge quoting and intent status (Alpha Preview)
  - name: V2 - DeFi
    description: Bonding pools and pulse data
  - name: V2 - Search
    description: Universal fast search
  - name: V2 - Blockchains
    description: System metadata and chain listings
  - name: V1 - Market Data
    description: Market prices, history, sparklines, pairs, and multi-data
  - name: V1 - Wallet
    description: Wallet portfolio, transactions, history, and NFTs
  - name: V1 - Token
    description: First buyers
  - name: V1 - Trades
    description: Market trades by pair
  - name: V1 - Metadata
    description: Token metadata, categories, trendings, and news
  - name: V1 - Assets
    description: List all assets
  - name: V1 - Search
    description: Search for assets, tokens, and pairs
  - name: V1 - DeFi
    description: Bonding pool pulse data
  - name: V1 - Blockchains
    description: Blockchain listings, pairs, and stats
  - name: V1 - Webhooks
    description: Webhook management
  - name: V1 - Feed
    description: Custom feed creation
paths:
  /2/bridge/routes:
    get:
      tags:
        - V2 - Bridge
      summary: List supported bridge routes
      description: >-
        [Alpha Preview] Returns all supported cross-chain bridge routes. Routes
        are all-to-all between the 6 supported chains (excluding same-chain
        transfers).
      responses:
        '200':
          description: List of supported routes.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      routes:
                        type: array
                        items:
                          type: object
                          properties:
                            originChainId:
                              type: string
                            destinationChainId:
                              type: string
                            estimatedTimeMs:
                              type: number
                              description: >-
                                Estimated end-to-end fill latency in
                                milliseconds.
                            maxTradeUsd:
                              type: number
                              description: Max trade size in USD per transaction.
                            feeBps:
                              type: number
                              description: Mobula bridge fee in basis points.
                            supportedTokens:
                              type: string
                              description: >-
                                "any" — native tokens and any ERC-20/SPL with
                                available pricing.
                          required:
                            - originChainId
                            - destinationChainId
                            - estimatedTimeMs
                            - maxTradeUsd
                            - feeBps
                            - supportedTokens
                    required:
                      - routes
                required:
                  - data

````