2025-05-09
API improvements & DevX

This week, we’re relasing several enhancements to Enso’s APIs:

  • clearer link between projects and protocols
  • additional filters available on /tokens
  • possibility to get prices for several tokens in a single request.

The GET /projects API recognizes overarching DeFi projects behind specific protocols.

The API now returns:

  • projectId - the ID of the project, e.g. aave,
  • protocols - the list of aave protocols, e.g. aave-v3, aave-static-atokens, and aave-v2
  • chains - the list of chain IDs the protocol is supported on by Enso.

The /tokens filters

The GET /tokens endpoint is useful for filtering through 2,292,738 tokens recognized by Enso. The new filters are:

  • symbol, e.g. BERA or mooBeraswapBerachainUSDC.e/HONEY
  • name, e.g. EVK Vault eUSDC.e-1

Examples:

curl --request GET \
  --url 'https://api.enso.finance/api/v1/tokens?chainId=146&name=EVK%20Vault%20eUSDC'

curl --request GET \
  --url 'https://api.enso.finance/api/v1/tokens?symbol=escETH-1&type=defi'

Fetching token prices

The GET /prices endpoint now has an option to fetch prices for multiple tokens in a single batch:

curl --request GET \
--url 'https://api.enso.finance/api/v1/prices/10?addresses=0x4200000000000000000000000000000000000006&addresses=0x8700dAec35aF8Ff88c16BdF0418774CB3D7599B4'
2025-05-01
Unichain Migrator Released

Unichain Migrator Widget

Enso’s released the Unichain Migrator widget in collaboration with Layer0 and Stargate.

This widget allows users to migrate assets from major chains to Unichain using Stargate’s cross-chain capabilities and Layer0’s infrastructure, together with Enso’s routing. The Unichain Migrator widget can be used as a standalone app or as a React component ready for integration into your dapp.

2025-04-15
Enso V2 Contract addresses

V2 EnsoRouter and DelegateEnsoShortcuts

We released V2 of EnsoRouter and DelegateEnsoShortcuts contract addresses on supported chains. This change affects you only if you’ve hard-coded the contract addresses in your code. Check the Deployments page for the latest addresses on each supported chain.

Don’t hardcode the addresses. We recommend using tx.to from /route and /bundle endpoints to send the transaction to the correct contract address. This way, you won’t need to update your code with future upgrades.

2025-04-10
Routing to nontokenized positions

Nontokenized Routing

The new GET /route/nontokenized endpoint enables automatic routing when entering non-tokenized positions. For these transactions, a smart wallet is necessary, and routingStrategy: "delegate" is necessary. Explore:

2025-03-31
March API updates

Tokens Pagination

The /tokens API now implements cursor-based pagination for the GET /tokens API endpoint, enabling more efficient retrieval of token data.