GET
/
v2
/
evm
/
swaps
/
quote
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/evm/swaps/quote
{
  "blockNumber": "17038723",
  "toAmount": "1000000000000000000",
  "toToken": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
  "fees": {
    "gasFee": {
      "amount": "1000000000000000000",
      "token": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"
    },
    "protocolFee": {
      "amount": "1000000000000000000",
      "token": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"
    }
  },
  "issues": {
    "allowance": {
      "currentAllowance": "1000000000",
      "spender": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
    },
    "balance": {
      "token": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "currentBalance": "1000000000000000000",
      "requiredBalance": "1000000000000000000"
    },
    "simulationIncomplete": false
  },
  "liquidityAvailable": true,
  "minToAmount": "900000000000000000",
  "fromAmount": "1000000000000000000",
  "fromToken": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
  "gas": "100000",
  "gasPrice": "1000000000"
}

Query Parameters

​
network
enum<string>
required

The network on which to perform the swap.

Available options:
base,
ethereum
Example:

"base"

​
toToken
string
required

The 0x-prefixed contract address of the token to receive.

Example:

"0x7F5c764cBc14f9669B88837ca1490cCa17c31607"

​
fromToken
string
required

The 0x-prefixed contract address of the token to send.

Example:

"0x6B175474E89094C44Da98b954EedeAC495271d0F"

​
fromAmount
string
required

The amount of the fromToken to send in atomic units of the token. For example, 1000000000000000000 when sending ETH equates to 1 ETH, 1000000 when sending USDC equates to 1 USDC, etc.

Example:

"1000000000000000000"

​
taker
string
required

The 0x-prefixed address that holds the fromToken balance and has the Permit2 allowance set for the swap.

Example:

"0xAc0974bec39a17e36ba4a6b4d238ff944bacb478"

​
signerAddress
string

The 0x-prefixed Externally Owned Account (EOA) address that will sign the Permit2 EIP-712 permit message. This is only needed if taker is a smart contract.

Example:

"0x922f49447d8a07e3bd95bd0d56f35241523fbab8"

​
gasPrice
string

The target gas price for the swap transaction, in Wei. For EIP-1559 transactions, this value should be seen as the maxFeePerGas value. If not provided, the API will use an estimate based on the current network conditions.

Example:

"1000000000"

​
slippageBps
integer
default:100

The maximum acceptable slippage of the toToken in basis points. If this parameter is set to 0, no slippage will be tolerated. If not provided, the default slippage tolerance is 100 bps (i.e., 1%).

Required range: 0 <= x <= 10000
Example:

100

Response

200
application/json

A price estimate for the swap.

A wrapper for the response of a swap price operation.