API-Reference
Tokens

Tokens

GET /v1/tokens

Get the Enso supported tokens.

This endpoint includes defi tokens and base, swappable tokens. For more details, see the position types.

Example:

curl -X 'GET' \
  'https://api.enso.finance/api/v1/tokens?chainId=1&page=1' \
  -H 'accept: */*'

👉 Try it on swagger (opens in a new tab)

Optional Query Parameters:

Query ParamDescription
chainIdThe chainId of the positions to return
addressAddress of the token to search for
protocolSlugProtocol slug of the defi token, e.g. aave-v2
typeToken type, baseToken or defiToken
primayAddressContract entrypoint for this positions/token. It can be used in the bundler endpoint
underlyingTokensAddress of the underlying tokens to search for
pagePage, used for pagination

Response example:

{
  "data": [
    {
      "chainId": 1,
      "address": "0x030bA81f1c18d280636F32af80b9AAd02Cf0854e",
      "decimals": 18,
      "type": "defi",
      "protocolSlug": "aave-v2",
      "underlyingTokens": [
        {
          "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
          "chainId": 1,
          "type": "base",
          "decimals": 18
        },
        {
          "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
          "chainId": 1,
          "type": "defi",
          "decimals": 18
        }
      ],
      "primaryAddress": "0x7d2768dE32b0b80b7a3454c06BdAc94A69DDc7A9",
      "apy": 0.23924
    }
  ],
  "meta": {
    "total": 1,
    "lastPage": 1,
    "currentPage": 1,
    "perPage": 1000,
    "prev": null,
    "next": null
  }
}