Skip to main content
POST
/
swap
/
quote
Error
A valid request URL is required to generate request examples
{
  "input": {
    "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "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",
    "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.coinvoyage.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-KEY
string
header
required

Headers

​
X-API-KEY
string
required

API key for authentication

Body

application/json
​
intent
object
required
Example:
{
  "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
object
Example:
{
  "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

​
input
object
required
Example:
{
  "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "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
object
required
Example:
{
  "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "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"
}
​
swap_mode
enum<string>
required
Available options:
ExactIn,
ExactOut
​
price_impact
number
required
​
providers
string[]
​
slippage_bps
integer | null