Get swap and bridge quotes

curl --request GET \
  --url https://api.zerion.io/v1/swap/quotes/ \
  --header 'Authorization: Basic <encoded-value>'

{
  "links": {
    "self": "https://api.zerion.io/v1/wallet/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/swap-list"
  },
  "data": [
    {
      "type": "swap_quotes",
      "id": "589a0095e2111df5276ebf073fff9a8bfb821f34",
      "attributes": {
        "liquidity_source": {
          "id": "relay",
          "name": "Relay",
          "icon": {
            "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
          }
        },
        "input_amount": {
          "quantity": "0.001",
          "value": 2.2830463441233997,
          "usd_value": 2.2830463441233997,
          "currency": "USD"
        },
        "output_amount": {
          "quantity": "0.001",
          "value": 2.2830463441233997,
          "usd_value": 2.2830463441233997,
          "currency": "USD"
        },
        "minimum_output_amount": {
          "quantity": "0.001",
          "value": 2.2830463441233997,
          "usd_value": 2.2830463441233997,
          "currency": "USD"
        },
        "output_amount_after_fees": {
          "quantity": "0.001",
          "value": 2.2830463441233997,
          "usd_value": 2.2830463441233997,
          "currency": "USD"
        },
        "slippage_percent": 2,
        "rate": [
          {
            "value": 1,
            "symbol": "WETH"
          }
        ],
        "protocol_fee": {
          "amount": {
            "quantity": "0.001",
            "value": 2.2830463441233997,
            "usd_value": 2.2830463441233997,
            "currency": "USD"
          },
          "base_percentage": 0.67,
          "percentage": 0,
          "included_in_rate": false,
          "fungible": {
            "type": "fungibles",
            "id": "eth"
          }
        },
        "bridge_fee": {
          "amount": {
            "quantity": "0.001",
            "value": 2.2830463441233997,
            "usd_value": 2.2830463441233997,
            "currency": "USD"
          },
          "included_in_rate": true,
          "fungible": {
            "type": "fungibles",
            "id": "eth"
          }
        },
        "network_fee": {
          "amount": {
            "quantity": "0.001",
            "value": 2.2830463441233997,
            "usd_value": 2.2830463441233997,
            "currency": "USD"
          },
          "free": true,
          "fungible": {
            "type": "fungibles",
            "id": "eth"
          }
        },
        "transaction_approve": {
          "evm": {
            "type": "0x2",
            "from": "0xbf9db3564c22fd22ff30a8db7f689d654bf5f1fd",
            "to": "0xb2be281e8b11b47fec825973fc8bb95332022a54",
            "nonce": "0x42",
            "chain_id": "0x1",
            "gas": "0x1c138",
            "value": "0x0",
            "data": "0xa9059cbb000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa9604500000000000000000000000000000000000000000000000000000000000003e8",
            "gas_price": "0x9502f900",
            "max_fee": "0xc6a17141",
            "max_priority_fee": "0x35aeb151",
            "custom_data": {
              "paymaster_params": {
                "paymaster": "<string>",
                "paymaster_input": "<string>"
              },
              "gas_per_pubdata_byte": "<string>"
            }
          },
          "solana": {
            "raw": "<string>"
          }
        },
        "transaction_swap": {
          "evm": {
            "type": "0x2",
            "from": "0xbf9db3564c22fd22ff30a8db7f689d654bf5f1fd",
            "to": "0xb2be281e8b11b47fec825973fc8bb95332022a54",
            "nonce": "0x42",
            "chain_id": "0x1",
            "gas": "0x1c138",
            "value": "0x0",
            "data": "0xa9059cbb000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa9604500000000000000000000000000000000000000000000000000000000000003e8",
            "gas_price": "0x9502f900",
            "max_fee": "0xc6a17141",
            "max_priority_fee": "0x35aeb151",
            "custom_data": {
              "paymaster_params": {
                "paymaster": "<string>",
                "paymaster_input": "<string>"
              },
              "gas_per_pubdata_byte": "<string>"
            }
          },
          "solana": {
            "raw": "<string>"
          }
        },
        "error": {
          "code": "not_enough_input_asset_balance",
          "hint": "topup",
          "message": "Input asset balance is not enough to execute a swap"
        },
        "estimated_time_seconds": 2
      },
      "relationships": {
        "input_chain": {
          "links": {
            "related": "https://api.zerion.io/v1/chains/polygon"
          },
          "data": {
            "type": "chains",
            "id": "polygon"
          }
        },
        "output_chain": {
          "links": {
            "related": "https://api.zerion.io/v1/chains/polygon"
          },
          "data": {
            "type": "chains",
            "id": "polygon"
          }
        },
        "input_fungible": {
          "links": {
            "related": "https://api.zerion.io/v1/fungibles/eth"
          },
          "data": {
            "type": "fungibles",
            "id": "eth"
          }
        },
        "output_fungible": {
          "links": {
            "related": "https://api.zerion.io/v1/fungibles/eth"
          },
          "data": {
            "type": "fungibles",
            "id": "eth"
          }
        }
      }
    }
  ]
}

swap

Get swap and bridge quotes

Returns quotes from multiple liquidity sources for a same-chain swap or a cross-chain bridge between two fungible assets. Supports EVM chains and Solana, including EVM ↔ Solana bridges.

Quotes are returned best-first: sorted in descending order by the fiat value of output_amount_after_fees (output amount minus network, protocol and bridge fees that are not already included in the rate). Quotes with the same score are tied-broken alphabetically by liquidity_source.id, so identical requests always return quotes in the same order.

The input and output parameters are objects encoded with bracket notation in the URL — the request is sent as a flat query string. For example:

GET /v1/swap/quotes/?currency=usd&input[chain_id]=base&input[fungible_id]=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&input[amount]=0.001&output[fungible_id]=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&from=0xd8da6bf26964af9d7eed9e03e53415d37aa96045&to=0xd8da6bf26964af9d7eed9e03e53415d37aa96045

GET

swap

quotes

Get swap and bridge quotes

curl --request GET \
  --url https://api.zerion.io/v1/swap/quotes/ \
  --header 'Authorization: Basic <encoded-value>'

{
  "links": {
    "self": "https://api.zerion.io/v1/wallet/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/swap-list"
  },
  "data": [
    {
      "type": "swap_quotes",
      "id": "589a0095e2111df5276ebf073fff9a8bfb821f34",
      "attributes": {
        "liquidity_source": {
          "id": "relay",
          "name": "Relay",
          "icon": {
            "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
          }
        },
        "input_amount": {
          "quantity": "0.001",
          "value": 2.2830463441233997,
          "usd_value": 2.2830463441233997,
          "currency": "USD"
        },
        "output_amount": {
          "quantity": "0.001",
          "value": 2.2830463441233997,
          "usd_value": 2.2830463441233997,
          "currency": "USD"
        },
        "minimum_output_amount": {
          "quantity": "0.001",
          "value": 2.2830463441233997,
          "usd_value": 2.2830463441233997,
          "currency": "USD"
        },
        "output_amount_after_fees": {
          "quantity": "0.001",
          "value": 2.2830463441233997,
          "usd_value": 2.2830463441233997,
          "currency": "USD"
        },
        "slippage_percent": 2,
        "rate": [
          {
            "value": 1,
            "symbol": "WETH"
          }
        ],
        "protocol_fee": {
          "amount": {
            "quantity": "0.001",
            "value": 2.2830463441233997,
            "usd_value": 2.2830463441233997,
            "currency": "USD"
          },
          "base_percentage": 0.67,
          "percentage": 0,
          "included_in_rate": false,
          "fungible": {
            "type": "fungibles",
            "id": "eth"
          }
        },
        "bridge_fee": {
          "amount": {
            "quantity": "0.001",
            "value": 2.2830463441233997,
            "usd_value": 2.2830463441233997,
            "currency": "USD"
          },
          "included_in_rate": true,
          "fungible": {
            "type": "fungibles",
            "id": "eth"
          }
        },
        "network_fee": {
          "amount": {
            "quantity": "0.001",
            "value": 2.2830463441233997,
            "usd_value": 2.2830463441233997,
            "currency": "USD"
          },
          "free": true,
          "fungible": {
            "type": "fungibles",
            "id": "eth"
          }
        },
        "transaction_approve": {
          "evm": {
            "type": "0x2",
            "from": "0xbf9db3564c22fd22ff30a8db7f689d654bf5f1fd",
            "to": "0xb2be281e8b11b47fec825973fc8bb95332022a54",
            "nonce": "0x42",
            "chain_id": "0x1",
            "gas": "0x1c138",
            "value": "0x0",
            "data": "0xa9059cbb000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa9604500000000000000000000000000000000000000000000000000000000000003e8",
            "gas_price": "0x9502f900",
            "max_fee": "0xc6a17141",
            "max_priority_fee": "0x35aeb151",
            "custom_data": {
              "paymaster_params": {
                "paymaster": "<string>",
                "paymaster_input": "<string>"
              },
              "gas_per_pubdata_byte": "<string>"
            }
          },
          "solana": {
            "raw": "<string>"
          }
        },
        "transaction_swap": {
          "evm": {
            "type": "0x2",
            "from": "0xbf9db3564c22fd22ff30a8db7f689d654bf5f1fd",
            "to": "0xb2be281e8b11b47fec825973fc8bb95332022a54",
            "nonce": "0x42",
            "chain_id": "0x1",
            "gas": "0x1c138",
            "value": "0x0",
            "data": "0xa9059cbb000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa9604500000000000000000000000000000000000000000000000000000000000003e8",
            "gas_price": "0x9502f900",
            "max_fee": "0xc6a17141",
            "max_priority_fee": "0x35aeb151",
            "custom_data": {
              "paymaster_params": {
                "paymaster": "<string>",
                "paymaster_input": "<string>"
              },
              "gas_per_pubdata_byte": "<string>"
            }
          },
          "solana": {
            "raw": "<string>"
          }
        },
        "error": {
          "code": "not_enough_input_asset_balance",
          "hint": "topup",
          "message": "Input asset balance is not enough to execute a swap"
        },
        "estimated_time_seconds": 2
      },
      "relationships": {
        "input_chain": {
          "links": {
            "related": "https://api.zerion.io/v1/chains/polygon"
          },
          "data": {
            "type": "chains",
            "id": "polygon"
          }
        },
        "output_chain": {
          "links": {
            "related": "https://api.zerion.io/v1/chains/polygon"
          },
          "data": {
            "type": "chains",
            "id": "polygon"
          }
        },
        "input_fungible": {
          "links": {
            "related": "https://api.zerion.io/v1/fungibles/eth"
          },
          "data": {
            "type": "fungibles",
            "id": "eth"
          }
        },
        "output_fungible": {
          "links": {
            "related": "https://api.zerion.io/v1/fungibles/eth"
          },
          "data": {
            "type": "fungibles",
            "id": "eth"
          }
        }
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

To test endpoints here, paste your API key from the dashboard into the username field and leave the password empty.

Query Parameters

currency

string

default:usd

Currency in which fiat values of amounts and fees in the response are expressed.

from

string

required

Address of the wallet performing the swap. Must match the chain type of input[chain_id] (EVM hex or Solana base58).

string

required

Recipient of the output asset. Must match the chain type of output[chain_id]. For a same-chain swap to the same wallet, set to equal to from.

input

object

required

The asset being sent.

Show child attributes

output

object

required

The asset being received.

Show child attributes

slippage_percent

number<float>

Maximum acceptable slippage in percent. When omitted, an auto-slippage value is chosen.

Required range: x >= 0

Response

Response for the requested swap quotes.

links

object

required

Show child attributes

data

object[]

required

Show child attributes

Get chain by ID List fungibles available for bridging

⌘I