Skip to main content
GET
/
quotes
/
best
Get best quote across all bridges
curl --request GET \
  --url https://api.chainrails.io/api/v1/quotes/best \
  --header 'Authorization: Bearer <token>'
{
  "bridgeFeeDetails": {
    "maxFee": "8000"
  },
  "totalFee": "18000",
  "totalFeeFormatted": "0.018",
  "route": {
    "tokenIn": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "tokenOut": "0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4",
    "sourceChain": "BASE_TESTNET",
    "destinationChain": "ARBITRUM_TESTNET",
    "amount": "10000000",
    "bridge": "CCTP",
    "recipient": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Enter your Chainrails API key as a Bearer token

Query Parameters

​
tokenIn
string
required

Input token address

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

​
tokenOut
string
required

Output token address

Example:

"0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4"

​
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
​
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
​
amount
string
required

Amount in token units

Example:

"10000000"

​
excludeBridges
string

Comma-separated bridges to exclude

Example:

"GATEWAY,CCTP"

​
recipient
string

Optional recipient address

Example:

"0x742d35Cc6635C0532925a3b8D62A7fe7B58123D1"

​
amountSymbol
enum<string>

Token symbol for amount denomination (defaults to USDC). Use this to specify amounts in other tokens like WETH, ETH, etc.

Available options:
USDC,
USDT,
DAI,
BUSD,
EURC,
ETH,
WETH,
STRK,
BNB,
LORDS

Response

Best quote retrieved successfully

​
bridgeFeeDetails
object

Bridge-specific fee details from the cheapest option

Example:
{ "maxFee": "8000" }
​
totalFee
string

Lowest total fee among all bridges

Example:

"18000"

​
totalFeeFormatted
string

Human-readable formatted total fee

Example:

"0.018"

​
route
object