THthirdweb
Bridge

List Supported Routes

List supported bridge routes with simple pagination and optional chain or token filters.

Authentication: Pass x-client-id header for frontend usage from allowlisted origins or x-secret-key for backend usage.

get/v1/bridge/routes

Request

  • Base URL
    https://api.thirdweb.com
  • Auth
    API key in header x-client-id

Query parameters

limitinteger

Maximum number of routes to return (1-100).

pageinteger

Page number for pagination, starting at 1.

originChainIdinteger

Filter routes by the origin chain ID.

Example:1
destinationChainIdinteger

Filter routes by the destination chain ID.

Example:1
originTokenAddressstring

Filter routes by origin token address.

destinationTokenAddressstring

Filter routes by destination token address.

maxStepsinteger

Maximum number of bridge steps allowed in the route.

Response

Successfully retrieved supported bridge routes.

Example response

{
  "result": {
    "routes": [
      {
        "originToken": {
          "chainId": 1,
          "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
          "symbol": "ETH",
          "name": "Ether",
          "decimals": 18,
          "iconUri": "https://assets.relay.link/icons/1/light.png",
          "prices": {
            "USD": 3200.5,
            "EUR": 2950.75
          }
        },
        "destinationToken": {
          "chainId": 1,
          "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
          "symbol": "ETH",
          "name": "Ether",
          "decimals": 18,
          "iconUri": "https://assets.relay.link/icons/1/light.png",
          "prices": {
            "USD": 3200.5,
            "EUR": 2950.75
          }
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 5 revisions of this API.