​
Integration

​
What netowrks does Enso support?

Enso supports multiple EVM-compatible networks. Check the Supported Networks page for the latest list.

​
What protocols does Enso support?

Enso supports 140+ protocols across various categories. Use the GET /projects/protocols endpoint to get the latest list.

Here’s a complete list of supported protocols:

​
What’s the difference between route and nontokenized endpoints?

  • The POST /shortcuts/route API endpoint is used for tokenized positions where you receive a token representing your position (like aTokens in Aave).
  • The GET /shortcuts/route/nontokenized endpoint is for non-tokenized positions, which are stored directly in a smart contract (usually a Smart Wallet).

​
What is the difference between router and delegate routing strategies?

  • router: Standard routing strategy for EOAs (Externally Owned Accounts).
  • delegate: Routing strategy for smart wallets, allowing for delegate calls.

Learn more about routing strategies.

​
API Basics

​
What is the default rate limit for the API?

The default rate limit is 10 requests per second (RPS). It can be increased on demand. When the limit is exceeded, you’ll receive a 429 Too Many Requests error.

​
How do I authenticate API requests?

API requests require an authentication token in the Authorization header:

-H 'Authorization: Bearer YOUR_API_KEY'

​
What parameters are required for API calls?

Core parameters for the POST route API endpoint include:

  • chainId - The blockchain network ID
  • fromAddress - The address initiating the transaction
  • routingStrategy - Usually “router” for standard routing
  • receiver - Address receiving the output tokens
  • spender - Address approved to spend the input tokens
  • amountIn - Amount of input token in base units
  • slippage - Acceptable slippage in basis points (e.g., 300 = 3%)
  • fee - Optional fee in basis points
  • feeReceiver - Address receiving the fee
  • tokenIn - Input token address
  • tokenOut - Output token address

​
How do I get and use the returned calldata?

The API returns transaction calldata that should be sent to the EnsoShortcutRouter contract.

​
Routing Mechanics

​
How does the routing work behind the scenes?

Enso’s router functions as a configurable multicall that can execute multiple actions in a single transaction on a specific chain. It optimizes the route based on current market conditions to find the best path for your transaction, whether it’s a swap, zap, deposit and so on.

​
Does Enso support cross-chain transactions?

As of March 2025, Enso supports single-chain transactions only, with cross-chain functionality in development. Current routes execute on a single blockchain network at a time.

​
What contract does the calldata interact with?

The calldata should be sent to the EnsoShortcutRouter contract on the respective chain.

​
How does Enso handle wallet types?

Enso recognizes two different routing strategies.

  • The standard route routing strategy is designed for EOAs (Externally Owned Accounts). - To use a smart wallet, use delegate routing strategy.

​
What happens if the user doesn’t have sufficient funds?

The API will return a route, but transaction execution will fail if sufficient funds aren’t available.

​
Error Handling

​
How can I test transactions before executing them?

You can simulate transactions using Tenderly before executing them on-chain.

​
Integration Patterns

​
How should I implement recurring transactions?

Since routes are dynamic and market conditions change, the best approach for recurring transactions is to use an off-chain actor that calls the API periodically to get the latest optimal route.

​
How can I integrate Enso with a custom smart contract?

You can create a custom contract that calls the EnsoShortcutRouter with the data returned from the API.

​
Can I integrate Enso with a bot?

Yes, Enso’s API is suitable for bot integration, such as for dutch auction fills, liquidation bots, or automated trading strategies.

​
What types of DeFi operations does Enso support?

Enso supports a wide range of DeFi operations including swaps, deposits, lending, borrowing, staking into LSTs, and complex compositions of these actions.

​
Performance and Security

​
How does the API handle high load or traffic spikes?

Enso monitors traffic and can increase rate limits if needed.

​
How is slippage handled in routes?

Slippage is specified in basis points as a parameter in API calls (e.g., 300 = 3%).

​
Common Errors and Solutions

​
”Could not build shortcuts for route” Error

This error indicates that Enso couldn’t find a valid route between the specified tokens on the specified network.

Possible solutions:

  • Verify token addresses are correct
  • Check if the token pair is supported on the specified chain
  • Verify the protocol integration is working