v1
latestOpenAPI 3.1.02026-07-1325128129.5 KBswap
Get Swap Quote
Get a quote for swapping between two currencies
post/swap/quote
Headers
X-API-KEYstring required
API key for authentication
Request body
Example request
{
"intent": {
"amount": "100.0",
"crypto": {
"sender_address": "0x1234...abcd",
"slippage_bps": 50,
"source_currency": {
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"chain_id": 30000000000001
}
},
"destination_currency": {
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"chain_id": 30000000000001
},
"payment_rail": "CRYPTO",
"receiving_address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"source_currency": {
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"chain_id": 30000000000001
},
"swap_mode": "ExactIn"
},
"metadata": {
"items": [
{
"currency": "USD",
"description": "High-quality widget with extra features",
"image": "https://example.com/images/widget.png",
"name": "Premium Widget",
"quantity": 2,
"unit_price": 49.99
}
],
"refund": {
"additional_info": "Item was never shipped",
"currency": "USD",
"name": "Order Cancellation",
"reason": "Customer requested refund",
"refund_amount": 99.98
}
}
}Response
Swap quote retrieved successfully
Example response
{
"input": {
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount_out_minimum": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
},
"balance": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
},
"base": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
},
"chain_id": 30000000000001,
"currency_amount": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
},
"decimals": 6,
"fees": {
"custom_fee": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
},
"protocol_fee": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
},
"relayer_fee": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
},
"total_fee": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
}
},
"gas": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
},
"id": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"image_uri": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png",
"name": "USD Coin",
"price_usd": 1,
"ticker": "USDC",
"total": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
}
},
"output": {
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount_out_minimum": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
},
"chain_id": 30000000000001,
"currency_amount": {
"raw_amount": "2400000",
"ui_amount": 2.4,
"ui_amount_display": "2.4",
"value_usd": 123.45
},
"decimals": 6,
"id": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"image_uri": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png",
"name": "USD Coin",
"price_usd": 1,
"ticker": "USDC"
}
}