Skip to main content
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.
{
  "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. 
{
  "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.
​
orderToken
object
required
The destination token for this route. Same structure as adToken.