Vault to Token

Exit vault positions and receive any token you want—on any chain. Biconomy handles the redemption, swap, and bridge in a single transaction.

The Problem It Solves

Without Biconomy, exiting a vault position requires:

Approve vault withdrawal (signature 1)
Redeem shares for underlying (signature 2)
Swap to desired token (signature 3)
If cross-chain: bridge to destination (more signatures, more waiting)

With Biconomy: One signature. Funds arrive as whatever token you want, wherever you want.

How It Works

User Initiates Withdrawal

User specifies vault shares to redeem and desired output token

API Calculates Best Route

Biconomy finds optimal path: redeem → swap (if needed) → bridge (if needed)

User Signs Once

Single signature authorizes the entire withdrawal flow

Lossless Redemption

Direct vault redemption—no slippage on the withdrawal step

Quick Example

Withdraw from an AAVE vault on Base, receive USDC on Optimism:

const quote = await fetch('https://api.biconomy.io/v1/quote', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    mode: 'eoa',
    ownerAddress: userAddress,
    composeFlows: [{
      type: '/instructions/intent-vault',
      data: {
        srcChainId: 8453,           // Base
        srcVault: '0x4e65fE4DbA92790696d040ac24Aa414708F5c0AB',  // AAVE vault
        dstChainId: 10,             // Optimism
        dstToken: '0x94b008aa00579c1307b0ef2c499ad98a8ce58e58',  // USDT
        amount: '1000000000000000000',  // Vault shares to redeem
        slippage: 0.01
      }
    }]
  })
}).then(r => r.json());

// Sign and execute
const signature = await wallet.signTypedData(quote.typedDataToSign);

const result = await fetch('https://api.biconomy.io/v1/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    signedQuote: quote,
    signature
  })
}).then(r => r.json());

console.log('Track at:', `https://meescan.biconomy.io/details/${result.supertxHash}`);

Same-Chain Withdrawal

Withdraw and swap to a different token on the same chain:

{
  type: '/instructions/intent-vault',
  data: {
    srcChainId: 8453,
    srcVault: YEARN_WETH_VAULT,    // Withdraw from Yearn WETH vault
    dstChainId: 8453,              // Same chain
    dstToken: USDC_BASE,           // Receive USDC
    amount: '5000000000000000000', // 5 vault shares
    slippage: 0.01
  }
}

Cross-Chain Exit

Exit a vault and receive tokens on a completely different chain:

{
  type: '/instructions/intent-vault',
  data: {
    srcChainId: 137,               // Polygon
    srcVault: AAVE_POLYGON_VAULT,  // AAVE position on Polygon
    dstChainId: 1,                 // Ethereum mainnet
    dstToken: ETH_MAINNET,         // Receive ETH
    amount: '10000000000000000000',
    slippage: 0.02,                // Higher slippage for volatile pair
    allowBridgeProviders: 'across' // Control bridge selection
  }
}

Understanding the Response

{
  "outputAmount": "985000000",
  "minOutputAmount": "975150000",
  "route": {
    "type": "vault-to-token",
    "summary": "vaultsfyi[aave-v3] => across => lifi[uniswap]",
    "steps": [
      {
        "type": "vault-redeem",
        "provider": "vaultsfyi",
        "protocol": "aave-v3",
        "vaultAddress": "0x...",
        "inputAmount": "1000000000000000000",
        "outputAmount": "1000000000"
      },
      {
        "type": "bridge",
        "provider": "across",
        "srcChainId": 8453,
        "dstChainId": 10
      },
      {
        "type": "swap",
        "provider": "lifi",
        "tool": "uniswap"
      }
    ],
    "totalGasFeesUsd": 0.15,
    "totalBridgeFeesUsd": 0.25,
    "estimatedTime": 120
  }
}

Field	Description
`route.type`	Always `vault-to-token` for withdrawals
`vault-redeem` step	Direct redemption from vault (lossless)
`bridge` step	Cross-chain transfer if needed
`swap` step	Token conversion if needed

Provider Control

Control which DEXs and bridges are used for the post-withdrawal steps:

{
  type: '/instructions/intent-vault',
  data: {
    srcChainId: 8453,
    srcVault: MORPHO_VAULT,
    dstChainId: 42161,
    dstToken: ARB_TOKEN,
    amount: '1000000000000000000',
    slippage: 0.01,
    
    // Route preferences
    allowSwapProviders: 'lifi,uniswap',
    allowBridgeProviders: 'across',
    denySwapProviders: 'gluex'
  }
}

Fee Structure

Scenario	Fee (BPS)
Same-chain, underlying token	0
Same-chain with swap	10
Cross-chain withdrawal	15

Withdrawing to the vault’s native underlying token on the same chain incurs zero protocol fees—only gas.

Error Handling

const quote = await fetch('https://api.biconomy.io/v1/quote', {...})
  .then(r => r.json());

// Check for errors
if (quote.error) {
  if (quote.error.includes('insufficient balance')) {
    console.log('Not enough vault shares');
  }
  if (quote.error.includes('No route found')) {
    console.log('Try a different destination token');
  }
  return;
}

// Validate output
const minOutput = BigInt(quote.returnedData[0].minOutputAmount);
if (minOutput < userMinimum) {
  console.log('Output too low—try reducing slippage or amount');
  return;
}

Getting Started

Tutorials

The Problem It Solves

How It Works

Quick Example

Same-Chain Withdrawal

Cross-Chain Exit

Understanding the Response

Provider Control

Fee Structure

Error Handling

Next Steps

Token to Vault

Vault to Vault

​The Problem It Solves

​How It Works

​Quick Example

​Same-Chain Withdrawal

​Cross-Chain Exit

​Understanding the Response

​Provider Control

​Fee Structure

​Error Handling

​Next Steps

Token to Vault

Vault to Vault

The Problem It Solves

How It Works

Quick Example

Same-Chain Withdrawal

Cross-Chain Exit

Understanding the Response

Provider Control

Fee Structure

Error Handling

Next Steps