Skip to main content
GET
/
quotes
/
single
Get quote from specific bridge
curl --request GET \
  --url https://api.chainrails.io/api/v1/quotes/single \
  --header 'Authorization: Bearer <token>'
{
  "bridgeFeeDetails": {
    "timestamp": 1702425683,
    "fillDeadline": 1702429283,
    "pctFee": 100000000000000,
    "flatFee": "5000"
  },
  "totalFee": "15500",
  "totalFeeFormatted": "0.0155",
  "route": {
    "tokenIn": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "tokenOut": "0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4",
    "sourceChain": "BASE_TESTNET",
    "destinationChain": "ARBITRUM_TESTNET",
    "amount": "10000000",
    "bridge": "ACROSS",
    "recipient": "0x742d35Cc6635C0532925a3b8D62A7fe7B58123D1"
  }
}

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 (denominated in amountSymbol if specified, otherwise USDC)

Example:

"10000000"

​
bridge
enum<string>
required

Bridge to use for the quote

Available options:
ACROSS,
CCTP,
GATEWAY,
RHINOFI
​
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, DAI, etc.

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

Response

Quote retrieved successfully

​
bridgeFeeDetails
object

Bridge-specific fee details (structure varies by bridge)

Example:
{
  "timestamp": 1702425683,
  "fillDeadline": 1702429283,
  "pctFee": 100000000000000,
  "flatFee": "5000"
}
​
totalFee
string

Total fee in token units (bridge fee + ChainRails fee)

Example:

"15500"

​
totalFeeFormatted
string

Human-readable formatted total fee

Example:

"0.0155"

​
route
object