GetExactOutputRoutes

GetExactOutputRoutes will return a list of origin tokens, when given a destination chain and token,

curl --request POST \
  --url https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes \
  --header 'Content-Type: application/json' \
  --data '
{
  "destinationChainId": 123,
  "destinationTokenAddress": "<string>",
  "originChainId": 123,
  "originTokenAddress": "<string>",
  "ownerAddress": "<string>"
}
'

import requests

url = "https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes"

payload = {
    "destinationChainId": 123,
    "destinationTokenAddress": "<string>",
    "originChainId": 123,
    "originTokenAddress": "<string>",
    "ownerAddress": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    destinationChainId: 123,
    destinationTokenAddress: '<string>',
    originChainId: 123,
    originTokenAddress: '<string>',
    ownerAddress: '<string>'
  })
};

fetch('https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'destinationChainId' => 123,
    'destinationTokenAddress' => '<string>',
    'originChainId' => 123,
    'originTokenAddress' => '<string>',
    'ownerAddress' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes"

	payload := strings.NewReader("{\n  \"destinationChainId\": 123,\n  \"destinationTokenAddress\": \"<string>\",\n  \"originChainId\": 123,\n  \"originTokenAddress\": \"<string>\",\n  \"ownerAddress\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes")
  .header("Content-Type", "application/json")
  .body("{\n  \"destinationChainId\": 123,\n  \"destinationTokenAddress\": \"<string>\",\n  \"originChainId\": 123,\n  \"originTokenAddress\": \"<string>\",\n  \"ownerAddress\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"destinationChainId\": 123,\n  \"destinationTokenAddress\": \"<string>\",\n  \"originChainId\": 123,\n  \"originTokenAddress\": \"<string>\",\n  \"ownerAddress\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "tokens": [
    {
      "chainId": 123,
      "address": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "decimals": 123,
      "featured": true,
      "featureIndex": 123,
      "supportsBridging": true,
      "logoUri": "<string>"
    }
  ]
}

{
  "error": "WebrpcEndpoint",
  "code": 0,
  "msg": "endpoint error",
  "status": 400,
  "cause": "<string>"
}

{
  "error": "WebrpcBadResponse",
  "code": -5,
  "msg": "bad response",
  "status": 500,
  "cause": "<string>"
}

POST

rpc

Trails

GetExactOutputRoutes

GetExactOutputRoutes will return a list of origin tokens, when given a destination chain and token,

curl --request POST \
  --url https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes \
  --header 'Content-Type: application/json' \
  --data '
{
  "destinationChainId": 123,
  "destinationTokenAddress": "<string>",
  "originChainId": 123,
  "originTokenAddress": "<string>",
  "ownerAddress": "<string>"
}
'

import requests

url = "https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes"

payload = {
    "destinationChainId": 123,
    "destinationTokenAddress": "<string>",
    "originChainId": 123,
    "originTokenAddress": "<string>",
    "ownerAddress": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    destinationChainId: 123,
    destinationTokenAddress: '<string>',
    originChainId: 123,
    originTokenAddress: '<string>',
    ownerAddress: '<string>'
  })
};

fetch('https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'destinationChainId' => 123,
    'destinationTokenAddress' => '<string>',
    'originChainId' => 123,
    'originTokenAddress' => '<string>',
    'ownerAddress' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes"

	payload := strings.NewReader("{\n  \"destinationChainId\": 123,\n  \"destinationTokenAddress\": \"<string>\",\n  \"originChainId\": 123,\n  \"originTokenAddress\": \"<string>\",\n  \"ownerAddress\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes")
  .header("Content-Type", "application/json")
  .body("{\n  \"destinationChainId\": 123,\n  \"destinationTokenAddress\": \"<string>\",\n  \"originChainId\": 123,\n  \"originTokenAddress\": \"<string>\",\n  \"ownerAddress\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"destinationChainId\": 123,\n  \"destinationTokenAddress\": \"<string>\",\n  \"originChainId\": 123,\n  \"originTokenAddress\": \"<string>\",\n  \"ownerAddress\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "tokens": [
    {
      "chainId": 123,
      "address": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "decimals": 123,
      "featured": true,
      "featureIndex": 123,
      "supportsBridging": true,
      "logoUri": "<string>"
    }
  ]
}

{
  "error": "WebrpcEndpoint",
  "code": 0,
  "msg": "endpoint error",
  "status": 400,
  "cause": "<string>"
}

{
  "error": "WebrpcBadResponse",
  "code": -5,
  "msg": "bad response",
  "status": 500,
  "cause": "<string>"
}

Overview

The GetExactOutputRoutes endpoint retrieves available token routes for exact output swaps. Given a destination token, it returns all source tokens that can be swapped to achieve that exact output amount. This is essential for building UIs where users specify exactly how much they want to receive.

Use Cases

Build “I want to receive exactly X tokens” interfaces
Find which source tokens can route to a specific destination
Payment flows where exact amounts are required
Invoice payments requiring precise token amounts
DeFi integrations with fixed deposit amounts

Request Parameters

Required Fields

destinationChainId (number): The chain ID of the destination token
destinationTokenAddress (string): The token address to receive

Optional Fields

originChainId (number): Filter routes by source chain
originTokenAddress (string): Filter to routes from a specific token
ownerAddress (string): User’s wallet address (for balance-aware filtering)

Response

The response includes:

tokens (TokenInfo[]): Array of source tokens that can route to the destination

TokenInfo Object Structure

Each token object contains:

chainId (number): Chain where the token exists
address (string): Token contract address
name (string): Token name
symbol (string): Token symbol
decimals (number): Token decimals
supportsBridging (boolean, optional): Whether the token supports cross-chain bridging
logoUri (string, optional): URL to token logo
featured (boolean): Whether this is a featured/popular token
featureIndex (number): Sort order for featured tokens

Examples

Find Source Tokens for USDC on Base

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Access-Key': 'YOUR_ACCESS_KEY'
  },
  body: JSON.stringify({
    destinationChainId: 8453, // Base
    destinationTokenAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' // USDC on Base
  })
});

const { tokens } = await response.json();

console.log('Tokens that can swap to USDC on Base:');
tokens.forEach(token => {
  console.log(`- ${token.symbol} on chain ${token.chainId}`);
});

Filter by Source Chain

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Access-Key': 'YOUR_ACCESS_KEY'
  },
  body: JSON.stringify({
    destinationChainId: 8453, // Base
    destinationTokenAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC
    originChainId: 1 // Only show routes from Ethereum mainnet
  })
});

const { tokens } = await response.json();

console.log('Ethereum tokens that can swap to USDC on Base:');
tokens.forEach(token => {
  console.log(`- ${token.symbol}: ${token.address}`);
});

Build Payment Source Selector

import { useEffect, useState } from 'react';

interface TokenInfo {
  chainId: number;
  address: string;
  name: string;
  symbol: string;
  decimals: number;
  logoUri?: string;
  featured: boolean;
}

interface PaymentSourceSelectorProps {
  targetChainId: number;
  targetTokenAddress: string;
  userAddress: string;
  onSelect: (token: TokenInfo) => void;
}

export const PaymentSourceSelector = ({
  targetChainId,
  targetTokenAddress,
  userAddress,
  onSelect
}: PaymentSourceSelectorProps) => {
  const [tokens, setTokens] = useState<TokenInfo[]>([]);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    fetch('https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-Access-Key': 'YOUR_ACCESS_KEY'
      },
      body: JSON.stringify({
        destinationChainId: targetChainId,
        destinationTokenAddress: targetTokenAddress,
        ownerAddress: userAddress
      })
    })
      .then(res => res.json())
      .then(({ tokens }) => {
        // Sort featured tokens first
        const sorted = tokens.sort((a: TokenInfo, b: TokenInfo) => {
          if (a.featured && !b.featured) return -1;
          if (!a.featured && b.featured) return 1;
          return 0;
        });
        setTokens(sorted);
        setLoading(false);
      });
  }, [targetChainId, targetTokenAddress, userAddress]);

  if (loading) return <div>Loading payment options...</div>;

  return (
    <div>
      <h3>Pay with:</h3>
      {tokens.map(token => (
        <button
          key={`${token.chainId}-${token.address}`}
          onClick={() => onSelect(token)}
        >
          {token.logoUri && <img src={token.logoUri} alt={token.symbol} />}
          {token.symbol} (Chain {token.chainId})
        </button>
      ))}
    </div>
  );
};

Check Specific Route Availability

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/GetExactOutputRoutes', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Access-Key': 'YOUR_ACCESS_KEY'
  },
  body: JSON.stringify({
    destinationChainId: 8453,
    destinationTokenAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
    originChainId: 42161, // Arbitrum
    originTokenAddress: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831' // USDC on Arbitrum
  })
});

const { tokens } = await response.json();

if (tokens.length > 0) {
  console.log('Route is available!');
} else {
  console.log('No direct route found');
}

When to Use Exact Output

Use GetExactOutputRoutes when:

User needs to receive a specific amount (e.g., paying a $100 invoice)
Protocol requires exact deposit amounts
NFT purchases with fixed prices
Subscription payments with fixed amounts

Use GetExactInputRoutes when:

User wants to spend a specific amount
“Swap all” functionality
User specifies how much to send

For the best UX, combine this with GetTokenPrices to show users the estimated cost in USD for each source token option.

Next Steps

GetExactInputRoutes

Find routes based on input amount

QuoteIntent

Get a quote with EXACT_OUTPUT trade type

Body

application/json

destinationChainId

number

required

destinationTokenAddress

string

required

originChainId

number

originTokenAddress

string

ownerAddress

string

Response

tokens

object[]

required

[]TokenInfo

Show child attributes

GetExactInputRoutes GetTokenList

Overview

Intents

Routes & Tokens

Chains & Discovery

Earn

Intents (Advanced)

GetExactOutputRoutes

Overview

Use Cases

Request Parameters

Required Fields

Optional Fields

Response

TokenInfo Object Structure

Examples

Find Source Tokens for USDC on Base

Filter by Source Chain

Build Payment Source Selector

Check Specific Route Availability

When to Use Exact Output

Next Steps

GetExactInputRoutes

QuoteIntent

Body

Response

​Overview

​Use Cases

​Request Parameters

​Required Fields

​Optional Fields

​Response

​TokenInfo Object Structure

​Examples

​Find Source Tokens for USDC on Base

​Filter by Source Chain

​Build Payment Source Selector

​Check Specific Route Availability

​When to Use Exact Output

​Next Steps

GetExactInputRoutes

QuoteIntent

Body

Response

Overview

Use Cases

Request Parameters

Required Fields

Optional Fields

Response

TokenInfo Object Structure

Examples

Find Source Tokens for USDC on Base

Filter by Source Chain

Build Payment Source Selector

Check Specific Route Availability

When to Use Exact Output

Next Steps