Bridge Routes API

Introduces a new GET /v1/bridge/routes endpoint to list supported bridge routes with pagination and optional filters for source/destination chains and tokens.

Added

• GET /v1/bridge/routes — list all supported bridge routes
• Supports filters:
  • by origin/destination chain
  • by token address
  • by max steps (e.g. single-hop routes)
• Pagination with limit, page, and hasMore

Examples

# Basic
curl -X GET "https://api.thirdweb.com/v1/bridge/routes?limit=10&page=1" \
  -H "x-secret-key: YOUR_SECRET_KEY"

# From Ethereum → Base
curl -X GET "https://api.thirdweb.com/v1/bridge/routes?originChainId=1&destinationChainId=8453" \
  -H "x-secret-key: YOUR_SECRET_KEY"

# Single-hop
curl -X GET "https://api.thirdweb.com/v1/bridge/routes?maxSteps=1" \
  -H "x-secret-key: YOUR_SECRET_KEY"

# Filter by token
curl -X GET "https://api.thirdweb.com/v1/bridge/routes?originChainId=1&originTokenAddress=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" \
  -H "x-secret-key: YOUR_SECRET_KEY"

# Combined filters
curl -X GET "https://api.thirdweb.com/v1/bridge/routes?originChainId=1&destinationChainId=8453&originTokenAddress=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&maxSteps=2" \
  -H "x-secret-key: YOUR_SECRET_KEY"

Response Format

{
  "result": {
    "routes": [
      {
        "originToken": {
          "chainId": 1,
          "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
          "symbol": "USDC",
          "name": "USD Coin",
          "decimals": 6,
          "iconUri": "https://coin-images.coingecko.com/coins/images/6319/large/usdc.png?1696506694"
        },
        "destinationToken": {
          "chainId": 8453,
          "address": "0xfA980cEd6895AC314E7dE34Ef1bFAE90a5AdD21b",
          "symbol": "PRIME",
          "name": "Prime",
          "decimals": 18,
          "iconUri": "https://coin-images.coingecko.com/coins/images/29053/large/prime-logo-small-border_%282%29.png?1696528020"
        }
      }
    ],
    "pagination": {
      "limit": 1,
      "page": 1,
      "hasMore": true
    }
  }
}