Making a deposit on Superform

This page will help you get started with Superform. You'll be up and running in a jiffy!

Authentication

You will need an API Key to use the Superform API. If you have not been provisioned one, please reach out to Vik. Once you have a key, simply include it in the SF-API-KEY header.



Conventions

  • This is a fully OpenAPI-compliant API. You can always view the most recent OpenAPI schema file here.
  • The API surface is standardized to camel_case. The only exception is route detail data that is proxied from LiFi in the execution endpoints.
  • The vault_statisticsobject may return a value of -1000000 for any of its float64 properties if that value cannot be computed. This is used in place of NaNs because the JSON spec does not natively support encoding the NaN value.



Execution

You can use the API to make deposits into and withdrawals from vaults listed on Superform. The flow in either direction is comprised of two steps:

  1. Send a request to /deposit/calculate with a set of options. This will return a set of possible routes.
  2. Select a route and send it, along with the rest of the response, to /deposit/start. This will return the encoded transaction data. You may then use this data to execute a transaction on-chain.

Making a deposit

Let's say you want to deposit into the Steakhouse USDC vault on Superform. You have some USDC on Optimism so you would like to use that to fund this deposit. Here is what the body of that deposit request would look like:


[
    {
        "user_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
        "from_chain_id": 10,
        "from_token_address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
        "amount_in": "40",
        "vault_id": "zcxnMoUkKUbMQ3uM_w3fq",
        "exclude_liquidity_providers": [],
        "route_type": "output",
        "bridge_slippage": 50,
        "swap_slippage": 50,
        "is_part_of_multi_vault": false,
        "refund_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552"
    }
]

We are depositing $40 worth of USDC, cross-chain from Optimism to the vault on Ethereum. You can read more about individual options in the API Reference.


Once we send the request, we will see a list of two possible routes in the liq.route.routes array:

[
    {
        "in": {
            "user_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
            "from_chain_id": 10,
            "to_chain_id": 1,
            "from_token_address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
            "to_token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "amount_in": "40",
            "superpositions_amount_in": "",
            "superpositions_chain_id": 0,
            "vault_id": "zcxnMoUkKUbMQ3uM_w3fq",
            "superform_id": "6277101737206669028000504059097845015423773220595131737620",
            "route_type": "output",
            "exclude_bridges": null,
            "exclude_dexes": null,
            "exclude_ambs": null,
            "exclude_liquidity_providers": [],
            "bridge_slippage": 50,
            "swap_slippage": 50,
            "positive_slippage": 100,
            "is_part_of_multi_vault": false,
            "refund_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
            "need_insurance": false,
            "filter_swap_routes": false,
            "retain_4626": false,
            "is_erc20": false,
            "adjusted_amount": "40000000",
            "max_slippage": 198,
            "permit2": "",
            "vault_decimals": 18,
            "vault_token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "contract_address": "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB",
            "from_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
            "from_amount": "",
            "form_implementation_id": "1",
            "superform_address": "0x3ecB18A7B8a113Cd386A6120005737979073E614",
            "liquidity_token": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
            "destination": "0x3721B0E122768CedDfB3Dec810E64c361177f826",
            "method": "",
            "is_same_route": false,
            "is_x_chain": true,
            "transaction_type": "deposit",
            "has_dst_swap": false,
            "output_amount_for_withdraw": "",
            "output_amount_normalized": "",
            "super_positions": null,
            "gas_estimate": {
                "gas_price_usd": "0.0000000032",
                "estimated_seconds": 10
            }
        },
        "liq": {
            "ok": true,
            "vault_id": "zcxnMoUkKUbMQ3uM_w3fq",
            "route": {
                "routes": [
                    {
                        "route_id": "572da129-7f77-498b-8100-268bf108237c",
                        "is_erc20": false,
                        "bridge_id": 5,
                        "from_chain_id": 10,
                        "from_amount": "40000000",
                        "from_token": {
                            "address": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
                            "symbol": "USDC",
                            "decimals": 6,
                            "chain_id": 10,
                            "name": "USD Coin",
                            "logo_uri": "https://static.debank.com/image/coin/logo_url/usdc/e87790bfe0b3f2ea855dc29069b38818.png"
                        },
                        "from_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
                        "to_chain_id": 1,
                        "to_amount": "38196788",
                        "to_amount_usd": "38.18816",
                        "to_amount_min": "38196788",
                        "to_token": {
                            "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                            "symbol": "USDC",
                            "decimals": 6,
                            "chain_id": 1,
                            "name": "USD Coin",
                            "logo_uri": "https://static.debank.com/image/coin/logo_url/usdc/e87790bfe0b3f2ea855dc29069b38818.png"
                        },
                        "to_address": "0x3721B0E122768CedDfB3Dec810E64c361177f826",
                        "gas_cost_usd": "0.0",
                        "cross_chain_fee": 1.7708187045060002,
                        "has_swap": false,
                        "insurable_route": false,
                        "interim_token": "",
                        "interim_token_amount": "",
                        "erc20_route_approval_target": "",
                        "super_position": {
                            "amount": "36662678880277131264",
                            "symbol": "sp-steakUSDC",
                            "usd_value": 38.18742645248569
                        },
                        "service": {
                            "name": "Debridge",
                            "logo": "https://debridge.finance/blog/content/images/max/1200/1-ZYXa61adSl_QWrC9ftzEWg.png"
                        },
                        "bridge": null,
                        "dex": null,
                        "estimate_time": 12,
                        "lifi_route_first_step": null
                    },
                    {
                        "route_id": "b5cd9c6c-7d4c-457c-ac80-333dbf1079e2",
                        "is_erc20": false,
                        "bridge_id": 101,
                        "from_chain_id": 10,
                        "from_amount": "40000000",
                        "from_token": {
                            "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
                            "symbol": "USDC",
                            "decimals": 6,
                            "chain_id": 10,
                            "name": "USD Coin",
                            "logo_uri": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                        },
                        "from_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
                        "to_chain_id": 1,
                        "to_amount": "39967029",
                        "to_amount_usd": "39.97",
                        "to_amount_min": "39568357",
                        "to_token": {
                            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
                            "symbol": "USDC",
                            "decimals": 6,
                            "chain_id": 1,
                            "name": "USD Coin",
                            "logo_uri": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                        },
                        "to_address": "0x3721B0E122768CedDfB3Dec810E64c361177f826",
                        "gas_cost_usd": "0.01",
                        "cross_chain_fee": 4.1499999999999995,
                        "has_swap": false,
                        "insurable_route": false,
                        "interim_token": "",
                        "interim_token_amount": "",
                        "erc20_route_approval_target": "",
                        "super_position": {
                            "amount": "38361821156944494592",
                            "symbol": "sp-steakUSDC",
                            "usd_value": 39.95723358890445
                        },
                        "service": {
                            "name": "LiFi",
                            "logo": "https://li.fi/logo192.png"
                        },
                        "bridge": {
                            "name": "Stargate Via LiFi",
                            "logo": "https://raw.githubusercontent.com/lifinance/types/5685c638772f533edad80fcb210b4bb89e30a50f/src/assets/icons/bridges/stargate.png"
                        },
                        "dex": null,
                        "estimate_time": 70,
                        "lifi_route_first_step": {
                            "type": "lifi",
                            "id": "78683619-5198-4e64-8481-ec5fca67540c:0",
                            "tool": "stargate",
                            "toolDetails": {
                                "key": "stargate",
                                "name": "Stargate",
                                "logoURI": "https://raw.githubusercontent.com/lifinance/types/5685c638772f533edad80fcb210b4bb89e30a50f/src/assets/icons/bridges/stargate.png"
                            },
                            "action": {
                                "fromToken": {
                                    "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
                                    "symbol": "USDC",
                                    "decimals": 6,
                                    "chainId": 10,
                                    "name": "USD Coin",
                                    "coinKey": "USDC",
                                    "priceUSD": "1.000100010001",
                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                },
                                "fromAmount": "40000000",
                                "toToken": {
                                    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
                                    "symbol": "USDC",
                                    "decimals": 6,
                                    "chainId": 1,
                                    "name": "USD Coin",
                                    "coinKey": "USDC",
                                    "priceUSD": "1.000100010001",
                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                },
                                "fromChainId": 10,
                                "toChainId": 1,
                                "slippage": 0.005,
                                "fromAddress": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
                                "toAddress": "0x3721B0E122768CedDfB3Dec810E64c361177f826"
                            },
                            "estimate": {
                                "tool": "stargate",
                                "approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
                                "toAmountMin": "39568357",
                                "toAmount": "39967029",
                                "fromAmount": "40000000",
                                "feeCosts": [
                                    {
                                        "name": "LayerZero fees",
                                        "description": "Infrastructure fee paid in native token",
                                        "token": {
                                            "address": "0x0000000000000000000000000000000000000000",
                                            "symbol": "ETH",
                                            "decimals": 18,
                                            "chainId": 10,
                                            "name": "ETH",
                                            "coinKey": "ETH",
                                            "priceUSD": "2515.92",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
                                        },
                                        "amount": "1640190996980938",
                                        "amountUSD": "4.13",
                                        "percentage": "0.1031",
                                        "included": false
                                    },
                                    {
                                        "name": "Equilibrium fees",
                                        "description": "The fee paid to users who rebalance tokens for the stargate protocol",
                                        "token": {
                                            "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                            "symbol": "USDC.e",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "Bridged USD Coin",
                                            "coinKey": "USDCe",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "amount": "11718",
                                        "amountUSD": "0.01",
                                        "percentage": "0.0003",
                                        "included": true
                                    },
                                    {
                                        "name": "Liquidity provider fees",
                                        "description": "The fee paid to liquidity providers for the stargate protocol",
                                        "token": {
                                            "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                            "symbol": "USDC.e",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "Bridged USD Coin",
                                            "coinKey": "USDCe",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "amount": "0",
                                        "amountUSD": "0.00",
                                        "percentage": "0.0000",
                                        "included": true
                                    },
                                    {
                                        "name": "Protocol fees",
                                        "description": "The fee paid to the stargate protocol",
                                        "token": {
                                            "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                            "symbol": "USDC.e",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "Bridged USD Coin",
                                            "coinKey": "USDCe",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "amount": "11718",
                                        "amountUSD": "0.01",
                                        "percentage": "0.0006",
                                        "included": true
                                    }
                                ],
                                "gasCosts": [
                                    {
                                        "type": "SEND",
                                        "price": "1276405",
                                        "estimate": "858962",
                                        "limit": "1101962",
                                        "amount": "1096383391610",
                                        "amountUSD": "0.01",
                                        "token": {
                                            "address": "0x0000000000000000000000000000000000000000",
                                            "symbol": "ETH",
                                            "decimals": 18,
                                            "chainId": 10,
                                            "name": "ETH",
                                            "coinKey": "ETH",
                                            "priceUSD": "2515.92",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
                                        }
                                    }
                                ],
                                "toolData": {
                                    "fromToken": {
                                        "address": "",
                                        "symbol": "",
                                        "decimals": 0,
                                        "chainId": 0,
                                        "name": "",
                                        "coinKey": ""
                                    },
                                    "toToken": {
                                        "address": "",
                                        "symbol": "",
                                        "decimals": 0,
                                        "chainId": 0,
                                        "name": "",
                                        "coinKey": ""
                                    },
                                    "toTokenAmount": "",
                                    "fromTokenAmount": "",
                                    "estimatedGas": 0
                                },
                                "executionDuration": 70,
                                "fromAmountUSD": "40.00",
                                "toAmountUSD": "39.97"
                            },
                            "includedSteps": [
                                {
                                    "id": "13f7c733-5ab9-4ac0-8eb1-adcb5246e0d4",
                                    "type": "swap",
                                    "action": {
                                        "fromToken": {
                                            "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
                                            "symbol": "USDC",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "USD Coin",
                                            "coinKey": "USDC",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "fromAmount": "40000000",
                                        "toToken": {
                                            "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                            "symbol": "USDC.e",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "Bridged USD Coin",
                                            "coinKey": "USDCe",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "fromChainId": 10,
                                        "toChainId": 10,
                                        "slippage": 0.005,
                                        "fromAddress": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552"
                                    },
                                    "estimate": {
                                        "tool": "1inch",
                                        "approvalAddress": "0x111111125421ca6dc452d289314280a0f8842a65",
                                        "toAmountMin": "39802734",
                                        "toAmount": "40002748",
                                        "fromAmount": "40000000",
                                        "gasCosts": [
                                            {
                                                "type": "SEND",
                                                "price": "1276405",
                                                "estimate": "333962",
                                                "limit": "1000943",
                                                "amount": "426270766610",
                                                "amountUSD": "0.01",
                                                "token": {
                                                    "address": "0x0000000000000000000000000000000000000000",
                                                    "symbol": "ETH",
                                                    "decimals": 18,
                                                    "chainId": 10,
                                                    "name": "ETH",
                                                    "coinKey": "ETH",
                                                    "priceUSD": "2515.92",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
                                                }
                                            }
                                        ],
                                        "toolData": {
                                            "fromToken": {
                                                "address": "",
                                                "symbol": "",
                                                "decimals": 0,
                                                "chainId": 0,
                                                "name": "",
                                                "coinKey": ""
                                            },
                                            "toToken": {
                                                "address": "",
                                                "symbol": "",
                                                "decimals": 0,
                                                "chainId": 0,
                                                "name": "",
                                                "coinKey": ""
                                            },
                                            "toTokenAmount": "",
                                            "fromTokenAmount": "",
                                            "estimatedGas": 0
                                        },
                                        "executionDuration": 30,
                                        "fromAmountUSD": "",
                                        "toAmountUSD": ""
                                    },
                                    "tool": "1inch",
                                    "toolDetails": {
                                        "key": "1inch",
                                        "name": "1inch",
                                        "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/exchanges/oneinch.png"
                                    }
                                },
                                {
                                    "id": "5172da21-7a8c-4424-b19c-06d0ce3b70ef",
                                    "type": "cross",
                                    "action": {
                                        "fromToken": {
                                            "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                            "symbol": "USDC.e",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "Bridged USD Coin",
                                            "coinKey": "USDCe",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "fromAmount": "40002748",
                                        "toToken": {
                                            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
                                            "symbol": "USDC",
                                            "decimals": 6,
                                            "chainId": 1,
                                            "name": "USD Coin",
                                            "coinKey": "USDC",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "fromChainId": 10,
                                        "toChainId": 1,
                                        "slippage": 0.005,
                                        "fromAddress": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552"
                                    },
                                    "estimate": {
                                        "tool": "stargate",
                                        "approvalAddress": "0xB0D502E938ed5f4df2E681fE6E419ff29631d62b",
                                        "toAmountMin": "39767194",
                                        "toAmount": "39967029",
                                        "fromAmount": "40002748",
                                        "feeCosts": [
                                            {
                                                "name": "LayerZero fees",
                                                "description": "Infrastructure fee paid in native token",
                                                "token": {
                                                    "address": "0x0000000000000000000000000000000000000000",
                                                    "symbol": "ETH",
                                                    "decimals": 18,
                                                    "chainId": 10,
                                                    "name": "ETH",
                                                    "coinKey": "ETH",
                                                    "priceUSD": "2515.92",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
                                                },
                                                "amount": "1640190996980938",
                                                "amountUSD": "4.13",
                                                "percentage": "0.1031",
                                                "included": false
                                            },
                                            {
                                                "name": "Equilibrium fees",
                                                "description": "The fee paid to users who rebalance tokens for the stargate protocol",
                                                "token": {
                                                    "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                                    "symbol": "USDC.e",
                                                    "decimals": 6,
                                                    "chainId": 10,
                                                    "name": "Bridged USD Coin",
                                                    "coinKey": "USDCe",
                                                    "priceUSD": "1.000100010001",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                                },
                                                "amount": "11718",
                                                "amountUSD": "0.01",
                                                "percentage": "0.0003",
                                                "included": true
                                            },
                                            {
                                                "name": "Liquidity provider fees",
                                                "description": "The fee paid to liquidity providers for the stargate protocol",
                                                "token": {
                                                    "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                                    "symbol": "USDC.e",
                                                    "decimals": 6,
                                                    "chainId": 10,
                                                    "name": "Bridged USD Coin",
                                                    "coinKey": "USDCe",
                                                    "priceUSD": "1.000100010001",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                                },
                                                "amount": "0",
                                                "amountUSD": "0.00",
                                                "percentage": "0.0000",
                                                "included": true
                                            },
                                            {
                                                "name": "Protocol fees",
                                                "description": "The fee paid to the stargate protocol",
                                                "token": {
                                                    "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                                    "symbol": "USDC.e",
                                                    "decimals": 6,
                                                    "chainId": 10,
                                                    "name": "Bridged USD Coin",
                                                    "coinKey": "USDCe",
                                                    "priceUSD": "1.000100010001",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                                },
                                                "amount": "11718",
                                                "amountUSD": "0.01",
                                                "percentage": "0.0006",
                                                "included": true
                                            }
                                        ],
                                        "gasCosts": [
                                            {
                                                "type": "SEND",
                                                "price": "1276405",
                                                "estimate": "525000",
                                                "limit": "1287500",
                                                "amount": "670112625000",
                                                "amountUSD": "0.01",
                                                "token": {
                                                    "address": "0x0000000000000000000000000000000000000000",
                                                    "symbol": "ETH",
                                                    "decimals": 18,
                                                    "chainId": 10,
                                                    "name": "ETH",
                                                    "coinKey": "ETH",
                                                    "priceUSD": "2515.92",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
                                                }
                                            }
                                        ],
                                        "toolData": {
                                            "fromToken": {
                                                "address": "",
                                                "symbol": "",
                                                "decimals": 0,
                                                "chainId": 0,
                                                "name": "",
                                                "coinKey": ""
                                            },
                                            "toToken": {
                                                "address": "",
                                                "symbol": "",
                                                "decimals": 0,
                                                "chainId": 0,
                                                "name": "",
                                                "coinKey": ""
                                            },
                                            "toTokenAmount": "",
                                            "fromTokenAmount": "",
                                            "estimatedGas": 0
                                        },
                                        "executionDuration": 40,
                                        "fromAmountUSD": "",
                                        "toAmountUSD": ""
                                    },
                                    "tool": "stargate",
                                    "toolDetails": {
                                        "key": "stargate",
                                        "name": "Stargate",
                                        "logoURI": "https://raw.githubusercontent.com/lifinance/types/5685c638772f533edad80fcb210b4bb89e30a50f/src/assets/icons/bridges/stargate.png"
                                    }
                                }
                            ],
                            "integrator": "superform.xyz",
                            "routesRequestId": ""
                        }
                    }
                ]
            }
        }
    }
]

If you wish to select the first route, you can simply copy and paste this entire object into the input of the next endpoint. If you wish to use the second (or any n-th) route, make sure it is the first route in the liq.route.routes array that is passed as part of the request input.

Let's say we select the second route. This is what the request body to /deposit/start will look like:

[
    {
        "in": {
            "user_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
            "from_chain_id": 10,
            "to_chain_id": 1,
            "from_token_address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
            "to_token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "amount_in": "40",
            "superpositions_amount_in": "",
            "superpositions_chain_id": 0,
            "vault_id": "zcxnMoUkKUbMQ3uM_w3fq",
            "superform_id": "6277101737206669028000504059097845015423773220595131737620",
            "route_type": "output",
            "exclude_bridges": null,
            "exclude_dexes": null,
            "exclude_ambs": null,
            "exclude_liquidity_providers": [],
            "bridge_slippage": 50,
            "swap_slippage": 50,
            "positive_slippage": 100,
            "is_part_of_multi_vault": false,
            "refund_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
            "need_insurance": false,
            "filter_swap_routes": false,
            "retain_4626": false,
            "is_erc20": false,
            "adjusted_amount": "40000000",
            "max_slippage": 198,
            "permit2": "",
            "vault_decimals": 18,
            "vault_token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "contract_address": "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB",
            "from_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
            "from_amount": "",
            "form_implementation_id": "1",
            "superform_address": "0x3ecB18A7B8a113Cd386A6120005737979073E614",
            "liquidity_token": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
            "destination": "0x3721B0E122768CedDfB3Dec810E64c361177f826",
            "method": "",
            "is_same_route": false,
            "is_x_chain": true,
            "transaction_type": "deposit",
            "has_dst_swap": false,
            "output_amount_for_withdraw": "",
            "output_amount_normalized": "",
            "super_positions": null,
            "gas_estimate": {
                "gas_price_usd": "0.0000000032",
                "estimated_seconds": 10
            }
        },
        "liq": {
            "ok": true,
            "vault_id": "zcxnMoUkKUbMQ3uM_w3fq",
            "route": {
                "routes": [
                    {
                        "route_id": "b5cd9c6c-7d4c-457c-ac80-333dbf1079e2",
                        "is_erc20": false,
                        "bridge_id": 101,
                        "from_chain_id": 10,
                        "from_amount": "40000000",
                        "from_token": {
                            "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
                            "symbol": "USDC",
                            "decimals": 6,
                            "chain_id": 10,
                            "name": "USD Coin",
                            "logo_uri": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                        },
                        "from_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
                        "to_chain_id": 1,
                        "to_amount": "39967029",
                        "to_amount_usd": "39.97",
                        "to_amount_min": "39568357",
                        "to_token": {
                            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
                            "symbol": "USDC",
                            "decimals": 6,
                            "chain_id": 1,
                            "name": "USD Coin",
                            "logo_uri": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                        },
                        "to_address": "0x3721B0E122768CedDfB3Dec810E64c361177f826",
                        "gas_cost_usd": "0.01",
                        "cross_chain_fee": 4.1499999999999995,
                        "has_swap": false,
                        "insurable_route": false,
                        "interim_token": "",
                        "interim_token_amount": "",
                        "erc20_route_approval_target": "",
                        "super_position": {
                            "amount": "38361821156944494592",
                            "symbol": "sp-steakUSDC",
                            "usd_value": 39.95723358890445
                        },
                        "service": {
                            "name": "LiFi",
                            "logo": "https://li.fi/logo192.png"
                        },
                        "bridge": {
                            "name": "Stargate Via LiFi",
                            "logo": "https://raw.githubusercontent.com/lifinance/types/5685c638772f533edad80fcb210b4bb89e30a50f/src/assets/icons/bridges/stargate.png"
                        },
                        "dex": null,
                        "estimate_time": 70,
                        "lifi_route_first_step": {
                            "type": "lifi",
                            "id": "78683619-5198-4e64-8481-ec5fca67540c:0",
                            "tool": "stargate",
                            "toolDetails": {
                                "key": "stargate",
                                "name": "Stargate",
                                "logoURI": "https://raw.githubusercontent.com/lifinance/types/5685c638772f533edad80fcb210b4bb89e30a50f/src/assets/icons/bridges/stargate.png"
                            },
                            "action": {
                                "fromToken": {
                                    "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
                                    "symbol": "USDC",
                                    "decimals": 6,
                                    "chainId": 10,
                                    "name": "USD Coin",
                                    "coinKey": "USDC",
                                    "priceUSD": "1.000100010001",
                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                },
                                "fromAmount": "40000000",
                                "toToken": {
                                    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
                                    "symbol": "USDC",
                                    "decimals": 6,
                                    "chainId": 1,
                                    "name": "USD Coin",
                                    "coinKey": "USDC",
                                    "priceUSD": "1.000100010001",
                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                },
                                "fromChainId": 10,
                                "toChainId": 1,
                                "slippage": 0.005,
                                "fromAddress": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
                                "toAddress": "0x3721B0E122768CedDfB3Dec810E64c361177f826"
                            },
                            "estimate": {
                                "tool": "stargate",
                                "approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
                                "toAmountMin": "39568357",
                                "toAmount": "39967029",
                                "fromAmount": "40000000",
                                "feeCosts": [
                                    {
                                        "name": "LayerZero fees",
                                        "description": "Infrastructure fee paid in native token",
                                        "token": {
                                            "address": "0x0000000000000000000000000000000000000000",
                                            "symbol": "ETH",
                                            "decimals": 18,
                                            "chainId": 10,
                                            "name": "ETH",
                                            "coinKey": "ETH",
                                            "priceUSD": "2515.92",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
                                        },
                                        "amount": "1640190996980938",
                                        "amountUSD": "4.13",
                                        "percentage": "0.1031",
                                        "included": false
                                    },
                                    {
                                        "name": "Equilibrium fees",
                                        "description": "The fee paid to users who rebalance tokens for the stargate protocol",
                                        "token": {
                                            "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                            "symbol": "USDC.e",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "Bridged USD Coin",
                                            "coinKey": "USDCe",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "amount": "11718",
                                        "amountUSD": "0.01",
                                        "percentage": "0.0003",
                                        "included": true
                                    },
                                    {
                                        "name": "Liquidity provider fees",
                                        "description": "The fee paid to liquidity providers for the stargate protocol",
                                        "token": {
                                            "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                            "symbol": "USDC.e",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "Bridged USD Coin",
                                            "coinKey": "USDCe",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "amount": "0",
                                        "amountUSD": "0.00",
                                        "percentage": "0.0000",
                                        "included": true
                                    },
                                    {
                                        "name": "Protocol fees",
                                        "description": "The fee paid to the stargate protocol",
                                        "token": {
                                            "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                            "symbol": "USDC.e",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "Bridged USD Coin",
                                            "coinKey": "USDCe",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "amount": "11718",
                                        "amountUSD": "0.01",
                                        "percentage": "0.0006",
                                        "included": true
                                    }
                                ],
                                "gasCosts": [
                                    {
                                        "type": "SEND",
                                        "price": "1276405",
                                        "estimate": "858962",
                                        "limit": "1101962",
                                        "amount": "1096383391610",
                                        "amountUSD": "0.01",
                                        "token": {
                                            "address": "0x0000000000000000000000000000000000000000",
                                            "symbol": "ETH",
                                            "decimals": 18,
                                            "chainId": 10,
                                            "name": "ETH",
                                            "coinKey": "ETH",
                                            "priceUSD": "2515.92",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
                                        }
                                    }
                                ],
                                "toolData": {
                                    "fromToken": {
                                        "address": "",
                                        "symbol": "",
                                        "decimals": 0,
                                        "chainId": 0,
                                        "name": "",
                                        "coinKey": ""
                                    },
                                    "toToken": {
                                        "address": "",
                                        "symbol": "",
                                        "decimals": 0,
                                        "chainId": 0,
                                        "name": "",
                                        "coinKey": ""
                                    },
                                    "toTokenAmount": "",
                                    "fromTokenAmount": "",
                                    "estimatedGas": 0
                                },
                                "executionDuration": 70,
                                "fromAmountUSD": "40.00",
                                "toAmountUSD": "39.97"
                            },
                            "includedSteps": [
                                {
                                    "id": "13f7c733-5ab9-4ac0-8eb1-adcb5246e0d4",
                                    "type": "swap",
                                    "action": {
                                        "fromToken": {
                                            "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
                                            "symbol": "USDC",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "USD Coin",
                                            "coinKey": "USDC",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "fromAmount": "40000000",
                                        "toToken": {
                                            "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                            "symbol": "USDC.e",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "Bridged USD Coin",
                                            "coinKey": "USDCe",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "fromChainId": 10,
                                        "toChainId": 10,
                                        "slippage": 0.005,
                                        "fromAddress": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552"
                                    },
                                    "estimate": {
                                        "tool": "1inch",
                                        "approvalAddress": "0x111111125421ca6dc452d289314280a0f8842a65",
                                        "toAmountMin": "39802734",
                                        "toAmount": "40002748",
                                        "fromAmount": "40000000",
                                        "gasCosts": [
                                            {
                                                "type": "SEND",
                                                "price": "1276405",
                                                "estimate": "333962",
                                                "limit": "1000943",
                                                "amount": "426270766610",
                                                "amountUSD": "0.01",
                                                "token": {
                                                    "address": "0x0000000000000000000000000000000000000000",
                                                    "symbol": "ETH",
                                                    "decimals": 18,
                                                    "chainId": 10,
                                                    "name": "ETH",
                                                    "coinKey": "ETH",
                                                    "priceUSD": "2515.92",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
                                                }
                                            }
                                        ],
                                        "toolData": {
                                            "fromToken": {
                                                "address": "",
                                                "symbol": "",
                                                "decimals": 0,
                                                "chainId": 0,
                                                "name": "",
                                                "coinKey": ""
                                            },
                                            "toToken": {
                                                "address": "",
                                                "symbol": "",
                                                "decimals": 0,
                                                "chainId": 0,
                                                "name": "",
                                                "coinKey": ""
                                            },
                                            "toTokenAmount": "",
                                            "fromTokenAmount": "",
                                            "estimatedGas": 0
                                        },
                                        "executionDuration": 30,
                                        "fromAmountUSD": "",
                                        "toAmountUSD": ""
                                    },
                                    "tool": "1inch",
                                    "toolDetails": {
                                        "key": "1inch",
                                        "name": "1inch",
                                        "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/exchanges/oneinch.png"
                                    }
                                },
                                {
                                    "id": "5172da21-7a8c-4424-b19c-06d0ce3b70ef",
                                    "type": "cross",
                                    "action": {
                                        "fromToken": {
                                            "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                            "symbol": "USDC.e",
                                            "decimals": 6,
                                            "chainId": 10,
                                            "name": "Bridged USD Coin",
                                            "coinKey": "USDCe",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "fromAmount": "40002748",
                                        "toToken": {
                                            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
                                            "symbol": "USDC",
                                            "decimals": 6,
                                            "chainId": 1,
                                            "name": "USD Coin",
                                            "coinKey": "USDC",
                                            "priceUSD": "1.000100010001",
                                            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                        },
                                        "fromChainId": 10,
                                        "toChainId": 1,
                                        "slippage": 0.005,
                                        "fromAddress": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552"
                                    },
                                    "estimate": {
                                        "tool": "stargate",
                                        "approvalAddress": "0xB0D502E938ed5f4df2E681fE6E419ff29631d62b",
                                        "toAmountMin": "39767194",
                                        "toAmount": "39967029",
                                        "fromAmount": "40002748",
                                        "feeCosts": [
                                            {
                                                "name": "LayerZero fees",
                                                "description": "Infrastructure fee paid in native token",
                                                "token": {
                                                    "address": "0x0000000000000000000000000000000000000000",
                                                    "symbol": "ETH",
                                                    "decimals": 18,
                                                    "chainId": 10,
                                                    "name": "ETH",
                                                    "coinKey": "ETH",
                                                    "priceUSD": "2515.92",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
                                                },
                                                "amount": "1640190996980938",
                                                "amountUSD": "4.13",
                                                "percentage": "0.1031",
                                                "included": false
                                            },
                                            {
                                                "name": "Equilibrium fees",
                                                "description": "The fee paid to users who rebalance tokens for the stargate protocol",
                                                "token": {
                                                    "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                                    "symbol": "USDC.e",
                                                    "decimals": 6,
                                                    "chainId": 10,
                                                    "name": "Bridged USD Coin",
                                                    "coinKey": "USDCe",
                                                    "priceUSD": "1.000100010001",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                                },
                                                "amount": "11718",
                                                "amountUSD": "0.01",
                                                "percentage": "0.0003",
                                                "included": true
                                            },
                                            {
                                                "name": "Liquidity provider fees",
                                                "description": "The fee paid to liquidity providers for the stargate protocol",
                                                "token": {
                                                    "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                                    "symbol": "USDC.e",
                                                    "decimals": 6,
                                                    "chainId": 10,
                                                    "name": "Bridged USD Coin",
                                                    "coinKey": "USDCe",
                                                    "priceUSD": "1.000100010001",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                                },
                                                "amount": "0",
                                                "amountUSD": "0.00",
                                                "percentage": "0.0000",
                                                "included": true
                                            },
                                            {
                                                "name": "Protocol fees",
                                                "description": "The fee paid to the stargate protocol",
                                                "token": {
                                                    "address": "0x7F5c764cBc14f9669B88837ca1490cCa17c31607",
                                                    "symbol": "USDC.e",
                                                    "decimals": 6,
                                                    "chainId": 10,
                                                    "name": "Bridged USD Coin",
                                                    "coinKey": "USDCe",
                                                    "priceUSD": "1.000100010001",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"
                                                },
                                                "amount": "11718",
                                                "amountUSD": "0.01",
                                                "percentage": "0.0006",
                                                "included": true
                                            }
                                        ],
                                        "gasCosts": [
                                            {
                                                "type": "SEND",
                                                "price": "1276405",
                                                "estimate": "525000",
                                                "limit": "1287500",
                                                "amount": "670112625000",
                                                "amountUSD": "0.01",
                                                "token": {
                                                    "address": "0x0000000000000000000000000000000000000000",
                                                    "symbol": "ETH",
                                                    "decimals": 18,
                                                    "chainId": 10,
                                                    "name": "ETH",
                                                    "coinKey": "ETH",
                                                    "priceUSD": "2515.92",
                                                    "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
                                                }
                                            }
                                        ],
                                        "toolData": {
                                            "fromToken": {
                                                "address": "",
                                                "symbol": "",
                                                "decimals": 0,
                                                "chainId": 0,
                                                "name": "",
                                                "coinKey": ""
                                            },
                                            "toToken": {
                                                "address": "",
                                                "symbol": "",
                                                "decimals": 0,
                                                "chainId": 0,
                                                "name": "",
                                                "coinKey": ""
                                            },
                                            "toTokenAmount": "",
                                            "fromTokenAmount": "",
                                            "estimatedGas": 0
                                        },
                                        "executionDuration": 40,
                                        "fromAmountUSD": "",
                                        "toAmountUSD": ""
                                    },
                                    "tool": "stargate",
                                    "toolDetails": {
                                        "key": "stargate",
                                        "name": "Stargate",
                                        "logoURI": "https://raw.githubusercontent.com/lifinance/types/5685c638772f533edad80fcb210b4bb89e30a50f/src/assets/icons/bridges/stargate.png"
                                    }
                                }
                            ],
                            "integrator": "superform.xyz",
                            "routesRequestId": ""
                        }
                    }
                ]
            }
        }
    }
]

The response from /deposit/start will be:

{
    "$schema": "http://api.superform.xyz/schemas/DepositResponse.json",
    "to": "0xa195608C2306A26f727d5199D5A382a4508308DA",
    "method": "singleXChainSingleVaultDeposit",
    "data": "0xe5672e2300000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000500000000000000000000000000000000000000000000000000000000000000010000000000000001000000013ecb18a7b8a113cd386a6120005737979073e614000000000000000000000000000000000000000000000000000000000264de0100000000000000000000000000000000000000000000000211b713106aa0545f00000000000000000000000000000000000000000000000000000000000000c6000000000000000000000000000000000000000000000000000000000000016000000000000000000000000000000000000000000000000000000000000009a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000093ab0cd091dc8dd513ebfd11972e64a2ac55855200000000000000000000000093ab0cd091dc8dd513ebfd11972e64a2ac55855200000000000000000000000000000000000000000000000000000000000009c000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000b2c639c533813f4aa9d7837caf62653d097ff850000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006500000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000005d3beb9bd24ca0000000000000000000000000000000000000000000000000000000000000744ed1786190000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000005e0ea9417708fa03f17b771434a75f5bdf71c2ec6253d3557a8e3e81f7c5d2b8aa90000000000000000000000000000000000000000000000000000000000000140000000000000000000000000000000000000000000000000000000000000018000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007f5c764cbc14f9669b88837ca1490cca17c316070000000000000000000000003721b0e122768ceddfb3dec810e64c361177f82600000000000000000000000000000000000000000000000000000000025f576e00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000087374617267617465000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000d7375706572666f726d2e78797a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000111111125421ca6dc452d289314280a0f8842a65000000000000000000000000111111125421ca6dc452d289314280a0f8842a650000000000000000000000000b2c639c533813f4aa9d7837caf62653d097ff850000000000000000000000007f5c764cbc14f9669b88837ca1490cca17c316070000000000000000000000000000000000000000000000000000000002625a0000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000026807ed2379000000000000000000000000b63aae6c353636d66df13b89ba4425cfe13d10ba0000000000000000000000000b2c639c533813f4aa9d7837caf62653d097ff850000000000000000000000007f5c764cbc14f9669b88837ca1490cca17c31607000000000000000000000000b63aae6c353636d66df13b89ba4425cfe13d10ba0000000000000000000000001231deb6f5749ef6ce6943a275a1d3e7486f4eae0000000000000000000000000000000000000000000000000000000002625a0000000000000000000000000000000000000000000000000000000000025f576e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000010e0000000000000000000000000000000000000000000000000000000000f051322b6b093a6c2aba51e078540ad89ed76a0c6716fa0b2c639c533813f4aa9d7837caf62653d097ff85004475d39ecb000000000000000000000000111111125421ca6dc452d289314280a0f8842a650000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000276a400000000000000000000000000000000000000000000000000000000025c4a200000000000000000000000000000000000000000000000000000000066dd9e3d0000000000000000000000000000000000002a94d1140000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000025bc3e600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005d3beb9bd24ca00000000000000000000000093ab0cd091dc8dd513ebfd11972e64a2ac5585520000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000014000000000000000000000000000000000000000000000000000000000000000143721b0e122768ceddfb3dec810e64c361177f82600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "value": "10294985606419393",
    "value_usd": "25.8902416024",
    "discount_usd": "0.0000000000",
    "original_fee_usd": "21.7654236756",
    "discount_percent": "",
    "fees_estimate": {
        "liq_amount": 1675490330279830,
        "src_amount": 7646730940752529,
        "dst_amount": 1288268810124854,
        "total_amount": 10610490081157213
    },
    "approval_data": null
}

🚧

Note - the quotes that we get from the liquidity aggregators expire after a few minutes. Make sure to get a fresh quote using the calculate endpoints before using it in the start endpoints.


Making a withdrawal

The flow to make a withdrawal is almost identical to the deposit flow outlined above. To withdraw from Steakhouse USDC to native Eth on Avalanche, send the following request to /withdraw/calculate:

[
    {
        "user_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
        "refund_address": "0x93AB0CD091DC8Dd513eBFd11972e64A2AC558552",
        "vault_id": "zcxnMoUkKUbMQ3uM_w3fq",
        "bridge_slippage": 50,
        "swap_slippage": 50,
        "route_type": "output",
        "exclude_ambs": [],
        "exclude_dexes": [],
        "exclude_bridges": [],
        "to_token_address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
        "to_chain_id": 42161,
        "superpositions_amount_in": "3881289106529881",
        "superpositions_chain_id": 10,
        "is_erc20": false,
        "retain_4626": false
    }
]

Then select a route, and send it to /deposit/start. In addition to transaction data, you will see approval_data object with the data necessary for user to approve the transaction on-chain before executing the withdrawal.


Making a multi-vault deposit

You may have noticed that we've been sending an array to the /deposit/calculate and /deposit/withdraw endpoints. In our initial example, that array contained only one object representing one vault that the user wants to deposit into. We can deposit into multiple vaults just as easily. Here is a request to deposit into a PoolTogether vault on Base and a Sturdy vault on Optimism using ZRO on Arbitrum as the funding token:

[
    {
        "user_address": "0x14eBD125201ADA1F94A8270d24d03A3f87146e77",
        "from_token_address": "0x6985884C4392D348587B19cb9eAAf157F13271cd",
        "from_chain_id": 42161,
        "amount_in": "9.206843004750000503",
        "refund_address": "0x14eBD125201ADA1F94A8270d24d03A3f87146e77",
        "vault_id": "GQ-edWKmiKTM6iF0Xz3LB",
        "bridge_slippage": 50,
        "swap_slippage": 50,
        "route_type": "output",
        "exclude_ambs": [],
        "exclude_liquidity_providers": [],
        "exclude_dexes": [],
        "exclude_bridges": []
    },
    {
        "user_address": "0x14eBD125201ADA1F94A8270d24d03A3f87146e77",
        "from_token_address": "0x6985884C4392D348587B19cb9eAAf157F13271cd",
        "from_chain_id": 42161,
        "amount_in": "9.206843004750000503",
        "refund_address": "0x14eBD125201ADA1F94A8270d24d03A3f87146e77",
        "vault_id": "agKh8y1aPQ9e452ZdpnMC",
        "bridge_slippage": 50,
        "swap_slippage": 50,
        "route_type": "output",
        "exclude_ambs": [],
        "exclude_liquidity_providers": [],
        "exclude_dexes": [],
        "exclude_bridges": []
    }
]

After selecting a route and starting it, you will be minted SuperPositions on Arbitrum representing vault shares in these two vaults.

📘

Note - if the funding token is a non-native token, you will need to approve spending that token by calling the approvemethod on the token contract with the SuperformRouter address as the spender. You can get this and other deployed contract addresses from the/supported endpoint.


What’s Next