Fetching Quotes
Flow of a transaction starts with fetching quotes for it.
Endpoint: GET /quotes
GET /quotes
/quotes
?fromChainId=
&fromAssetAddress=
&toChainId=
&toAssetAddress=
&inputAmountDisplay=
&userWalletAddress=
&recipient=
Query params
fromChainId*
string
Source blockchain identifier
fromAssetAddress*
string
Token address on source chain
toChainId*
string
Destination blockchain identifier
toAssetAddress*
string
Token address on destination chain
inputAmountDisplay*
string
Human-readable input amount (e.g., “1.5”) Note: Either inputAmountDisplay or inputAmount should be passed
inputAmount*
string
Input amount in decimals units Note: Either inputAmountDisplay or inputAmount should be passed
userWalletAddress*
string
User’s wallet address
recipient
string
Final recipient of the tokens. If not provided userWalletAddress is used by default
slippage
number
Slippage tolerance in basis points (100 = 1%)
solanaOptions
SolanaOptions
Solana-specific parameters
evmOptions
EvmOptions
EVM-specific parameters
skipChecks
boolean
Skip validation checks
include
string
Comma-separated list of providers to include
exclude
string
Comma-separated list of providers to exclude
recommendedProvider
boolean
Use only recommended providers
Solana Options
solanaPriorityFee
number | PriorityLevel
Priority fee in micro lamports or priority level
solanaJitoTip
number | PriorityLevel
Jito MEV tip in lamports or priority level
Evm Options
evmPriorityFee
number | PriorityLevel
Priority fee in wei or priority level
PriorityLevel = 'low' | 'medium' | 'high' | 'ultra' | 'degen'
Response
A Route represents a complete path for token transfer, including all necessary steps and fee information.
requestId
string
Unique identifier for the quote request
routeId
string
Unique identifier for this specific route
from
Asset
Source token details including chain and token information
to
Asset
Destination token details
steps
Steps[]
Array of execution steps (approval, swap, bridge, etc.)
fee
Fee[]
Breakdown of all fees involved
provider
Providers
Liquidity provider identifier
providerDetails
ProviderDetails
Additional provider information
protocolsUsed
string[]
List of protocols used in this route
inputAmount
string
Input amount in wei/native units
inputAmountDisplay
string
Human-readable input amount
outputAmount
string
Expected output in wei/native units
outputAmountDisplay
string
Human-readable output amount
minOutputAmount
string
Minimum output amount after slippage
minOutputAmountDisplay
string
Human-readable minimum output
slippage
number
Applied slippage tolerance in basis points
userWalletAddress
string
User's wallet address
recipient
string
Final recipient address
createdAt
number
Unix timestamp of quote creation
deadline
number
Unix timestamp when quote expires
estimatedTimeInSeconds
number
Estimated execution time
tags
string[]
Route classification tags
Example
The following example shows how to get quotes for a cross-chain swap transaction from Ethereum to Solana. We'll be fetching quotes for ETH on Ethereum to USDC on Solana.
Request:
https://api2.blockend.com/v1/quotes
?fromChainId=1
&fromAssetAddress=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
&toChainId=sol
&toAssetAddress=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
&inputAmountDisplay=0.420
&userWalletAddress=0x17e7c3DD600529F34eFA1310f00996709FfA8d5c
&recipient=7zSa114U45nJ8b8ALsuhszS2Kxto8grgedh65Q7xJYii
Response:
{
"status": "success",
"data": {
"quotes": [
{
"routeId": "01J2WB1NY6MD3F25CJTTB01D8F",
"from": {
"networkType": "evm",
"chainId": "1",
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"decimals": 18,
"name": "Ethereum",
"symbol": "ETH",
"isNative": true,
"isPopular": true,
"image": "https://assets.coingecko.com/coins/images/279/standard/ethereum.png?1595348880",
"priceId": "ethereum",
"blockchain": "Ethereum",
"lastPrice": 3480.62
},
"to": {
"symbol": "USDC",
"image": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"priceId": "usd-coin",
"blockchain": "Solana",
"decimals": 6,
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"networkType": "sol",
"isNative": false,
"isPopular": false,
"chainId": "sol",
"name": "USDC",
"lastPrice": 1.002
},
"steps": [
{
"stepId": "01J2WB1NY64MKVCM8FM994WMZV",
"stepType": "bridge",
"protocolsUsed": [
"Auction"
],
"provider": "mayan",
"from": {
"networkType": "evm",
"chainId": "1",
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"decimals": 18,
"name": "Ethereum",
"symbol": "ETH",
"isNative": true,
"isPopular": true,
"image": "https://assets.coingecko.com/coins/images/279/standard/ethereum.png?1595348880",
"priceId": "ethereum",
"blockchain": "Ethereum",
"lastPrice": 3480.62
},
"to": {
"symbol": "USDC",
"image": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"priceId": "usd-coin",
"blockchain": "Solana",
"decimals": 6,
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"networkType": "sol",
"isNative": false,
"isPopular": false,
"chainId": "sol",
"name": "USDC",
"lastPrice": 1.002
},
"fee": [
{
"token": {
"networkType": "evm",
"chainId": "1",
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"decimals": 18,
"name": "Ethereum",
"symbol": "ETH",
"isNative": true,
"isPopular": true,
"image": "https://assets.coingecko.com/coins/images/279/standard/ethereum.png?1595348880",
"priceId": "ethereum",
"blockchain": "Ethereum",
"lastPrice": 3480.62
},
"amount": "1380475027400000",
"amountInEther": "1380475027400000",
"amountInUSD": "4.804908989868988",
"type": "network"
}
],
"inputAmount": "420000000000000000",
"outputAmount": "1459244847",
"estimatedTimeInSeconds": 900
}
],
"fee": [
{
"token": {
"networkType": "evm",
"chainId": "1",
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"decimals": 18,
"name": "Ethereum",
"symbol": "ETH",
"isNative": true,
"isPopular": true,
"image": "https://assets.coingecko.com/coins/images/279/standard/ethereum.png?1595348880",
"priceId": "ethereum",
"blockchain": "Ethereum",
"lastPrice": 3480.62
},
"amount": "1380475027400000",
"amountInEther": "1380475027400000",
"amountInUSD": "4.804908989868988",
"type": "network"
}
],
"provider": "mayan",
"providerDetails": {
"id": "mayan",
"name": "Mayan",
"logoUrl": "https://blockend-widget.s3.ap-south-1.amazonaws.com/mayan.svg",
"websiteUrl": "https://mayan.finance/"
},
"protocolsUsed": [
"Auction"
],
"inputAmount": "420000000000000000",
"inputAmountDisplay": "0.420",
"outputAmount": "1459244847",
"outputAmountDisplay": "1459.244847",
"minOutputAmount": "1459.098923",
"minOutputAmountDisplay": "1459.098923",
"slippage": 0,
"recipient": "7zSa114U45nJ8b8ALsuhszS2Kxto8grgedh65Q7xJYii",
"createdAt": 1721085515718,
"deadline": 60,
"estimatedTimeInSeconds": 900,
"requestId": "01J2WB1K2D769PJRBMPNX1SKJT",
"score": {
"outputScore": 1,
"speedScore": 0.0011111111111111111,
"feeScore": 1,
"slipparageScore": 0,
"stepScore": 1,
"outputDiffPercent": 0
},
"tags": [
"BEST_OUTPUT",
"CHEAP"
]
},
{
"routeId": "01J2WB1MX7ZDHNB71GH3R52189",
"from": {
"networkType": "evm",
"chainId": "1",
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"decimals": 18,
"name": "Ethereum",
"symbol": "ETH",
"isNative": true,
"isPopular": true,
"image": "https://assets.coingecko.com/coins/images/279/standard/ethereum.png?1595348880",
"priceId": "ethereum",
"blockchain": "Ethereum",
"lastPrice": 3480.62
},
"to": {
"symbol": "USDC",
"image": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"priceId": "usd-coin",
"blockchain": "Solana",
"decimals": 6,
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"networkType": "sol",
"isNative": false,
"isPopular": false,
"chainId": "sol",
"name": "USDC",
"lastPrice": 1.002
},
"steps": [
{
"stepId": "01J2WB1MX7BJA7ZSN8K4KXF1VA",
"stepType": "bridge",
"protocolsUsed": [
"deBridge"
],
"provider": "dln",
"from": {
"networkType": "evm",
"chainId": "1",
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"decimals": 18,
"name": "Ethereum",
"symbol": "ETH",
"isNative": true,
"isPopular": true,
"image": "https://assets.coingecko.com/coins/images/279/standard/ethereum.png?1595348880",
"priceId": "ethereum",
"blockchain": "Ethereum",
"lastPrice": 3480.62
},
"to": {
"symbol": "USDC",
"image": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"priceId": "usd-coin",
"blockchain": "Solana",
"decimals": 6,
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"networkType": "sol",
"isNative": false,
"isPopular": false,
"chainId": "sol",
"name": "USDC",
"lastPrice": 1.002
},
"fee": [
{
"type": "network",
"token": {
"networkType": "evm",
"chainId": "1",
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"decimals": 18,
"name": "Ethereum",
"symbol": "ETH",
"isNative": true,
"isPopular": true,
"image": "https://assets.coingecko.com/coins/images/279/standard/ethereum.png?1595348880",
"priceId": "ethereum",
"blockchain": "Ethereum",
"lastPrice": 3480.62
},
"amount": "5141425082200000",
"amountInEther": "5141425082200000",
"amountInUSD": "17.895346969606965"
}
],
"inputAmount": "420000000000000000",
"outputAmount": "1449243299",
"estimatedTimeInSeconds": 1
}
],
"fee": [
{
"type": "network",
"token": {
"networkType": "evm",
"chainId": "1",
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"decimals": 18,
"name": "Ethereum",
"symbol": "ETH",
"isNative": true,
"isPopular": true,
"image": "https://assets.coingecko.com/coins/images/279/standard/ethereum.png?1595348880",
"priceId": "ethereum",
"blockchain": "Ethereum",
"lastPrice": 3480.62
},
"amount": "5141425082200000",
"amountInEther": "5141425082200000",
"amountInUSD": "17.895346969606965"
}
],
"provider": "dln",
"providerDetails": {
"id": "dln",
"name": "DLN",
"logoUrl": "https://dln.trade/assets/images/favicon/apple-touch-icon.png",
"websiteUrl": "https://dln.trade/"
},
"protocolsUsed": [
"deBridge"
],
"inputAmount": "420000000000000000",
"inputAmountDisplay": "0.420",
"outputAmount": "1449243299",
"outputAmountDisplay": "1449.243299",
"minOutputAmount": "1449.243299",
"minOutputAmountDisplay": "1449.243299",
"slippage": 0.3,
"recipient": "7zSa114U45nJ8b8ALsuhszS2Kxto8grgedh65Q7xJYii",
"createdAt": 1721085514664,
"deadline": 30,
"estimatedTimeInSeconds": 1,
"requestId": "01J2WB1K2D769PJRBMPNX1SKJT",
"score": {
"outputScore": 0.9932454038279075,
"speedScore": 1,
"feeScore": 0.26850046540195793,
"slipparageScore": 0,
"stepScore": 1,
"outputDiffPercent": 0.00677748576178394
},
"tags": [
"BEST",
"FAST"
]
}
]
}
}
Last updated
Was this helpful?