Routes and discovery

Use these endpoints to discover what networks, tokens, and routes are available before building a quote. They are read-only and require no active intent. For authentication and base URL, see the API overview.

GetChains

List all supported networks. Endpoint: POST /GetChains No request parameters required.

Response fields

Field	Description
`chains`	Array of supported network objects
`chains[].chainId`	Numeric chain ID
`chains[].name`	Human-readable network name

Example

const { chains } = await trails.getChains({});

chains.forEach((chain) => {
  console.log(chain.chainId, chain.name);
});
// 1 Ethereum
// 137 Polygon
// 8453 Base
// 42161 Arbitrum One

GetTokenList

List supported tokens on a specific network. Endpoint: POST /GetTokenList

Request parameters

Field	Type	Required	Description
`chainId`	number	Yes	The network to list tokens for

Response fields

Field	Description
`tokens`	Array of token objects on the specified chain
`tokens[].address`	Token contract address
`tokens[].symbol`	Token symbol (e.g. `USDC`)
`tokens[].decimals`	Token decimal precision

Example

const { tokens } = await trails.getTokenList({ chainId: 137 });

tokens.forEach((token) => {
  console.log(token.symbol, token.address, token.decimals);
});

GetExactInputRoutes

Get all available destination options for a given source token and amount. Use this to show customers what they can receive given what they have. Endpoint: POST /GetExactInputRoutes

Request parameters

Field	Type	Required	Description
`originChainId`	number	Yes	Source network chain ID
`originTokenAddress`	string	Yes	Source token contract address
`originTokenAmount`	string	Yes	Amount to send, in the token’s smallest unit

Example

const routes = await trails.getExactInputRoutes({
  originChainId: 1,
  originTokenAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  originTokenAmount: "1000000",
});

GetExactOutputRoutes

Get all available source options for a desired destination token and amount. Use this when the customer specifies how much they want to receive. Endpoint: POST /GetExactOutputRoutes

Request parameters

Field	Type	Required	Description
`destinationChainId`	number	Yes	Destination network chain ID
`destinationTokenAddress`	string	Yes	Destination token contract address
`destinationTokenAmount`	string	Yes	Desired receive amount, in the token’s smallest unit

Example

const routes = await trails.getExactOutputRoutes({
  destinationChainId: 137,
  destinationTokenAddress: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
  destinationTokenAmount: "100000000", // 100 USDC
});

GetTokenPrices

Get current USD prices for one or more tokens. Endpoint: POST /GetTokenPrices

Request parameters

Field	Type	Required	Description
`tokenAddresses`	string[]	Yes	Array of token contract addresses to price

Example

const prices = await trails.getTokenPrices({
  tokenAddresses: [
    "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC on Ethereum
    "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", // USDC on Polygon
  ],
});

prices.forEach((p) => {
  console.log(p.address, p.priceUsd);
});

GetExchangeRate

Get a fiat-to-fiat or fiat-to-crypto exchange rate for display and quoting purposes. Endpoint: POST /GetExchangeRate

Request parameters

Field	Type	Required	Description
`fromCurrency`	string	Yes	Source currency code (ISO 4217, e.g. `USD`)
`toCurrency`	string	Yes	Target currency code (ISO 4217, e.g. `EUR`)
`amount`	number	Yes	Amount in the source currency

Example

const rate = await trails.getExchangeRate({
  fromCurrency: "USD",
  toCurrency: "EUR",
  amount: 100,
});

console.log(`100 USD = ${rate.convertedAmount} EUR`);

GetFiatCurrencyList

List all fiat currencies supported for on-ramp and off-ramp funding. Endpoint: POST /GetFiatCurrencyList No request parameters required.

Example

const { currencies } = await trails.getFiatCurrencyList({});

currencies.forEach((c) => {
  console.log(c.code, c.name); // USD United States Dollar
});

Cross-chain

SDK

Trails API Reference

GetChains

Response fields

Example

GetTokenList

Request parameters

Response fields

Example

GetExactInputRoutes

Request parameters

Example

GetExactOutputRoutes

Request parameters

Example

GetTokenPrices

Request parameters

Example

GetExchangeRate

Request parameters

Example

GetFiatCurrencyList

Example

​GetChains

​Response fields

​Example

​GetTokenList

​Request parameters

​Response fields

​Example

​GetExactInputRoutes

​Request parameters

​Example

​GetExactOutputRoutes

​Request parameters

​Example

​GetTokenPrices

​Request parameters

​Example

​GetExchangeRate

​Request parameters

​Example

​GetFiatCurrencyList

​Example

GetChains

Response fields

Example

GetTokenList

Request parameters

Response fields

Example

GetExactInputRoutes

Request parameters

Example

GetExactOutputRoutes

Request parameters

Example

GetTokenPrices

Request parameters

Example

GetExchangeRate

Request parameters

Example

GetFiatCurrencyList

Example