Skip to main content
GET
/
router
/
optimal-route
Find optimal cross-chain transfer route
curl --request GET \
  --url https://api.chainrails.io/api/v1/router/optimal-route \
  --header 'Authorization: Bearer <token>'
{
  "sourceChain": "BASE_TESTNET",
  "destinationChain": "ARBITRUM_TESTNET",
  "tokenIn": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "tokenOut": "0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4",
  "originalAmount": "10000000",
  "totalFees": "18000",
  "bridgeToUse": "CCTP",
  "bridgeAddress": "0xa1c943058a631D5506eb7d96036eAbF6968e2338",
  "bridgeExtraData": "0x00000000000000000000000000000000000000000000000000000000000001f4",
  "supportedBridges": [
    "ACROSS",
    "CCTP"
  ],
  "bridgeFeeDetails": {
    "maxFee": "8000"
  }
}

Authorizations

​
Authorization
string
header
required

Enter your Chainrails API key as a Bearer token

Query Parameters

​
tokenIn
string
required

Input token contract address

Example:

"0xA0b86a33E6411192B1F4ec3eB801B21EB56"

​
tokenOut
string
required

Output token contract address

Example:

"0xA0b86a33E6411192B1F4ec3eB801B21EB56"

​
sourceChain
enum<string>
required

Source blockchain

Available options:
ARBITRUM_MAINNET,
ARBITRUM_TESTNET,
AVALANCHE_MAINNET,
AVALANCHE_TESTNET,
BASE_MAINNET,
BASE_TESTNET,
STARKNET_MAINNET,
STARKNET_TESTNET,
BSC_MAINNET,
ETHEREUM_MAINNET,
ETHEREUM_TESTNET,
OPTIMISM_MAINNET,
OPTIMISM_TESTNET,
MONAD_MAINNET,
MONAD_TESTNET,
POLYGON_MAINNET,
HYPEREVM_MAINNET,
LISK_MAINNET
Example:

"BASE_MAINNET"

​
destinationChain
enum<string>
required

Destination blockchain

Available options:
ARBITRUM_MAINNET,
ARBITRUM_TESTNET,
AVALANCHE_MAINNET,
AVALANCHE_TESTNET,
BASE_MAINNET,
BASE_TESTNET,
STARKNET_MAINNET,
STARKNET_TESTNET,
BSC_MAINNET,
ETHEREUM_MAINNET,
ETHEREUM_TESTNET,
OPTIMISM_MAINNET,
OPTIMISM_TESTNET,
MONAD_MAINNET,
MONAD_TESTNET,
POLYGON_MAINNET,
HYPEREVM_MAINNET,
LISK_MAINNET
Example:

"ARBITRUM_MAINNET"

​
amount
string
required

Transfer amount in token units (wei for ETH)

Example:

"1000000000000000000"

​
recipient
string

Recipient address for the cross-chain transfer (required for some bridges like RhinoFi)

Example:

"0x742d35cc6634c0532925a3b8d7389d8c5b7cf15b"

​
amountSymbol
string
required

Token symbol for amount denomination (e.g., USDC, USDT, ETH)

Example:

"USDC"

Response

Optimal route found successfully

​
sourceChain
string
Example:

"BASE_TESTNET"

​
destinationChain
string
Example:

"ARBITRUM_TESTNET"

​
tokenIn
string
Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

​
tokenOut
string
Example:

"0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4"

​
originalAmount
string

Original transfer amount

Example:

"10000000"

​
totalFees
string

Total fees (bridge fee + ChainRails fee)

Example:

"18000"

​
bridgeToUse
enum<string> | null
Available options:
ACROSS,
CCTP,
GATEWAY,
RHINOFI
Example:

"CCTP"

​
bridgeAddress
string
Example:

"0xa1c943058a631D5506eb7d96036eAbF6968e2338"

​
bridgeExtraData
string
Example:

"0x00000000000000000000000000000000000000000000000000000000000001f4"

​
supportedBridges
enum<string>[]
Available options:
ACROSS,
CCTP,
GATEWAY,
RHINOFI
Example:
["ACROSS", "CCTP"]
​
bridgeFeeDetails
object

Bridge-specific fee details (structure varies by bridge)

Example:
{ "maxFee": "8000" }