Routes API: Browse Supported Cross-Chain Token Pairs

Query ProofBridge cross-chain routes — the directional token pair mappings that define which tokens can be bridged between which chains.

A route defines a directional link between two tokens on two different chains: a source token (referred to as the ad token) and a destination token (referred to as the order token). When a Maker creates a liquidity ad, they select a route that determines which tokens they are providing liquidity for. When a Bridger creates a trade, they select an ad whose route matches their desired transfer.

Routes are read-only through the public API. Only administrators can register new routes.

Use routes to populate your token-pair selection UI. Filter by adChainId and orderChainId to show the routes available between two specific chains.

---

GET /v1/routes

List available cross-chain routes with optional filters. Returns a paginated list.

Query parameters

adTokenId · string

Filter by source token UUID. Returns only routes where the ad token matches.

orderTokenId · string

Filter by destination token UUID. Returns only routes where the order token matches.

adChainId · string

Filter by the source chain ID (e.g., "11155111" for Ethereum Sepolia, "1000001" for Stellar Testnet).

orderChainId · string

Filter by the destination chain ID (e.g., "11155111" for Ethereum Sepolia).

symbol · string

Filter by token symbol. Returns routes where either token matches the symbol (e.g., "USDC").

cursor · string

Pagination cursor from a previous response’s nextCursor field.

limit · number · default: "25"

Number of results per page. Between 1 and 100.

Response fields

data · Route[] · required

Array of route objects. See Route object fields below.

nextCursor · string | null · required

Cursor for the next page. null when you have reached the last page.

Response

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "metadata": {},
      "createdAt": "2026-01-10T00:00:00.000Z",
      "updatedAt": "2026-01-10T00:00:00.000Z",
      "adToken": {
        "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "symbol": "wETH",
        "name": "Wrapped ETH",
        "address": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "decimals": 18,
        "kind": "SEP41",
        "chain": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "name": "Stellar Testnet",
          "chainId": "1000001"
        }
      },
      "orderToken": {
        "id": "d290f1ee-6c54-4b01-90e6-d701748f0852",
        "symbol": "ETH",
        "name": "Ethereum",
        "address": "0x0000000000000000000000000000000000000000",
        "decimals": 18,
        "kind": "NATIVE",
        "chain": {
          "id": "a3bb189e-8bf9-3888-9b8c-4c2e38a29afc",
          "name": "Ethereum Sepolia",
          "chainId": "11155111"
        }
      }
    }
  ],
  "nextCursor": null
}

---

GET /v1/routes/:id

Retrieve full details for a single route by its UUID.

Path parameters

id · string · required

UUID of the route to retrieve.

Returns a single Route object.

Response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "metadata": {},
  "createdAt": "2026-01-10T00:00:00.000Z",
  "updatedAt": "2026-01-10T00:00:00.000Z",
  "adToken": {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "symbol": "wETH",
    "name": "Wrapped ETH",
    "address": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "decimals": 18,
    "kind": "SEP41",
    "chain": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "name": "Stellar Testnet",
      "chainId": "0"
    }
  },
  "orderToken": {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0852",
    "symbol": "ETH",
    "name": "Ethereum",
    "address": "0x0000000000000000000000000000000000000000",
    "decimals": 18,
    "kind": "NATIVE",
    "chain": {
      "id": "a3bb189e-8bf9-3888-9b8c-4c2e38a29afc",
      "name": "Ethereum Sepolia",
      "chainId": "11155111"
    }
  }
}

---

Route object fields

id · string · required

UUID of the route.

metadata · object · required

Arbitrary metadata associated with the route (may be an empty object).

createdAt · string · required

ISO 8601 timestamp of when the route was registered.

updatedAt · string · required

ISO 8601 timestamp of the last update.

adToken · object · required

The source token for this route.

Show Token fields

id · string · required

UUID of the token.

symbol · string · required

Token symbol (e.g., "USDC").

name · string · required

Full token name (e.g., "USD Coin").

address · string · required

Token contract address on its chain.

decimals · number · required

Number of decimal places (e.g., 6 for USDC, 18 for ETH).

kind · string · required

Token standard: "ERC20", "NATIVE", "SAC", or "SEP41".

chain · object · required

Chain information: id (UUID), name (display name), chainId (numeric chain ID string).

orderToken · object · required

The destination token for this route. Same structure as adToken.