The Bundle API supports a variety of actions to build complex DeFi strategies. This reference guide explains all available actions and their parameters.

To get the up-to date list of available actions and parameters, use the Metadata API endpoint: GET /standards/actions.

​
Chaining Actions

Bundle API allows using output of one action as the input for another. To reference outputs from previous actions use the useOutputOfCallAt syntax, specifying the index of the action in the bundle.

{
  "amountIn": {
    "useOutputOfCallAt": 0 // Use the output amount from the action at index 0
  }
}

​
Core Actions

​
route

The route action determines the optimal path to swap one token for another across multiple DeFi protocols supported by Enso.

{
  "protocol": "enso",
  "action": "route",
  "args": {
    "tokenIn": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", // ETH address
    "tokenOut": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84", // stETH address
    "amountIn": "1000000000000000000", // Amount in wei
    "slippage": "300" // 3% slippage tolerance (in basis points)
  }
}
ParameterDescription
tokenInAddress of the token to send. For ETH, use 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
tokenOutAddress of the token to receive
amountInAmount of tokenIn to send in wei
slippage(Optional) Slippage tolerance in basis points (100 = 1%)

​
deposit

Deposits tokens into a protocol to receive a position token or add liquidity.

{
  "protocol": "aave-v3",
  "action": "deposit",
  "args": {
    "tokenIn": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", // WETH address
    "tokenOut": "0x4d5F47FA6A74757f35C14fD3a6Ef8E3C9BC514E8", // aWETH address
    "amountIn": "1000000000000000000", // Amount in wei
    "primaryAddress": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2" // Aave V3 pool
  }
}
ParameterDescription
tokenInAddress of token to deposit. Can be an array for multiple tokens
tokenOutAddress of token to receive. Can be an array for multiple tokens
amountInAmount of tokenIn to deposit in wei
primaryAddressAddress of the protocol contract to interact with
recipient(Optional) Address to receive the output tokens if not the caller

​
withdraw

Withdraws tokens from a DeFi position.

{
  "protocol": "erc4626",
  "action": "withdraw",
  "args": {
    "primaryAddress": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0", // Vault address
    "tokenIn": "0x6b175474e89094c44da98b954eedeac495271d0f", // Token to withdraw (e.g. yvDAI)
    "tokenOut": "0x6b175474e89094c44da98b954eedeac495271d0f", // Output token (e.g. DAI)
    "amountOut": "1000000000000000000" // Amount to withdraw in wei
  }
}
ParameterDescription
primaryAddressAddress of the protocol contract to interact with
tokenInAddress of the token to withdraw from
tokenOutAddress of the token to receive
amountOutAmount to withdraw in wei

​
borrow

Borrows a token from a lending protocol using a deposited token as collateral.

{
  "protocol": "aave-v3",
  "action": "borrow",
  "args": {
    "collateral": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", // WETH address (collateral)
    "tokenOut": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", // USDC address (to borrow)
    "amountOut": "1000000000", // Amount to borrow in wei (6 decimals for USDC)
    "primaryAddress": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2" // Aave V3 pool
  }
}
ParameterDescription
collateralAddress of the token used as collateral
tokenOutAddress of the token to borrow
amountOutAmount to borrow in wei
primaryAddressAddress of the lending pool

​
repay

Repays a loan on a lending protocol.

{
  "protocol": "aave-v3",
  "action": "repay",
  "args": {
    "tokenIn": "0xdac17f958d2ee523a2206206994597c13d831ec7", // USDT address
    "amountIn": "100000000", // Amount to repay in wei
    "primaryAddress": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2" // Aave V3 pool
  }
}
ParameterDescription
tokenInAddress of token to repay
amountInAmount to repay in wei
primaryAddressAddress of the lending pool

​
harvest

Harvests rewards from yield-generating positions.

{
  "protocol": "curve-gauge",
  "action": "harvest",
  "args": {
    "token": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0", // Token address
    "primaryAddress": "0x182B723a58739a9c974cFDB385ceaDb237453c28" // Curve gauge address
  }
}
ParameterDescription
tokenAddress of token to harvest rewards for
primaryAddressAddress of the contract to interact with (e.g., gauge)

​
redeem

Redeems underlying assets from a protocol by exchanging shares or tokens. Use it to exit a position and retrieve the desired tokens.

{
  "protocol": "erc4626",
  "action": "redeem",
  "args": {
    "tokenOut": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", // USDC address
    "amountIn": "1000000000000000000", // Amount of shares to redeem
    "primaryAddress": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0" // ERC4626 vault address
  }
}
ParameterDescription
tokenOutAddress of token to receive upon redemption
amountInAmount of shares/tokens to redeem
primaryAddressAddress of the contract to interact with
recipient(Optional) Address to receive the output tokens if not the caller

​
Token Management Actions

​
transfer

Transfers tokens to a specified address.

{
  "protocol": "erc20",
  "action": "transfer",
  "args": {
    "token": "0xd26114cd6EE289AccF82350c8d8487fedB8A0C07", // OMG token address
    "receiver": "0x80eba3855878739f4710233a8a19d89bdd2ffb8e", // Recipient address
    "amount": "1000000000000000000" // Amount to transfer in wei
  }
}
ParameterDescription
tokenAddress of the token to transfer
receiverAddress of the recipient
amountAmount to transfer in wei

​
transferFrom

Transfers tokens from a specified address to another address.

{
  "protocol": "erc20",
  "action": "transferfrom",
  "args": {
    "token": "0xd26114cd6EE289AccF82350c8d8487fedB8A0C07", // OMG token address
    "sender": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", // Sender address
    "receiver": "0x93621DCA56fE26Cdee86e4F6B18E116e9758Ff11", // Recipient address
    "amount": "1000000000000000000" // Amount to transfer in wei
  }
}
ParameterDescription
tokenAddress of the token to transfer
senderAddress of the sender
receiverAddress of the recipient
amountAmount to transfer in wei

​
approve

Approves a spender to use tokens.

{
  "protocol": "erc20",
  "action": "approve",
  "args": {
    "token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", // WETH address
    "spender": "0xe592427a0aece92de3edee1f18e0157c05861564", // Spender address (e.g., Uniswap router)
    "amount": "1000000000000000000000000" // Amount to approve in wei
  }
}
ParameterDescription
tokenAddress of the token to approve
spenderAddress of the spender
amountAmount to approve in wei

​
permitTransferFrom

Approves and transfers a token that supports permit in a single step using a signature. A permit signature needs to be generated offchain and passed to the API.

{
  "protocol": "permit2",
  "action": "permittransferfrom",
  "args": {
    "token": "0xd26114cd6EE289AccF82350c8d8487fedB8A0C07", // Token address
    "amount": "1000000000000000000", // Amount in wei
    "sender": "0xb67f3CE46bB9E1a1127796c27f38DbaB9f643ec0", // Sender address
    "receiver": "0x35a2839b617F7da6534d636f22945f6Cb6137130", // Receiver address
    "nonce": "1", // Nonce to prevent replay attacks
    "deadline": "1710150268", // Timestamp deadline for signature validity
    "signature": "0x..." // Permit signature
  }
}
ParameterDescription
tokenAddress of the token to transfer
amountAmount to transfer in wei
senderAddress of the sender
receiverAddress of the recipient
nonceNonce value to prevent signature replay
deadlineTimestamp after which the signature is invalid
signatureThe EIP-2612 permit signature

​
Advanced Actions

​
call

Makes an arbitrary call to any contract, allowing for custom interactions. This is useful for executing complex logic or interacting with contracts that are not directly supported by the Enso API.

ParameterDescription
addressAddress of the contract to call
methodName of the method to call
abiABI signature of the method
argsArray of arguments to pass to the method

The sample below routes USDC to ETH and then calls a custom method on a contract to calculate a 70% (7000) of the output amount before transfering to the first receiver, and then does the same for the remaining 30% (3000).

[
  {
    "protocol": "enso",
    "action": "route",
    "args": {
      "tokenIn": [
        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
      ],
      "tokenOut": [
        "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
      ],
      "amountIn": "100000000"
    }
  },
  {
    "protocol": "enso",
    "action": "call",
    "args": {
      "address": "0xD0aF6F692bFa10d6a535A3A321Dc8377F4EeEF12",
      "method": "percentMul",
      "abi": "function percentMul(uint256,uint256) external",
      "args": [
        { "useOutputOfCallAt": 0 },
        "7000"
      ]
    }
  },
  {
    "protocol": "erc20",
    "action": "transfer",
    "args": {
      "token": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
      "amount": { "useOutputOfCallAt": 1 },
      "receiver": "0xdf9244945366060ae8ad8907cd08288ecb490b52"
    }
  },
  {
    "protocol": "enso",
    "action": "call",
    "args": {
      "address": "0xD0aF6F692bFa10d6a535A3A321Dc8377F4EeEF12",
      "method": "percentMul",
      "abi": "function percentMul(uint256,uint256) external",
      "args": [
        { "useOutputOfCallAt": 0 },
        "3000"
      ]
    }
  },
  {
    "protocol": "erc20",
    "action": "transfer",
    "args": {
      "token": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
      "amount": { "useOutputOfCallAt": 3 },
      "receiver": "0x123456789abcdef0123456789abcdef012345678"
    }
  }
]

​
Protocol Support

The Bundle API supports a wide range of protocols. Some common ones include:

  • aave-v2, aave-v3: Aave lending/borrowing
  • balancer-v2: Balancer liquidity pools
  • curve: Curve Finance stable swaps and gauges
  • curve-gauge: Curve gauges for staking
  • erc20: Standard token operations
  • erc4626: ERC4626 vaults
  • enso: General Enso operations including route and arbitrary calls
  • permit2: Uniswap’s Permit2 operations

For a complete list of supported protocols, use the Projects API endpoint: GET /projects/protocols.

Updated

Was this page helpful?