GET
/
api
/
v1
/
tokens
curl --request GET \
  --url https://api.enso.finance/api/v1/tokens \
  --header 'Authorization: Bearer <token>'
{
  "meta": {
    "total": 123,
    "lastPage": 123,
    "currentPage": 123,
    "perPage": 123,
    "prev": 123,
    "next": 123,
    "cursor": 123
  },
  "data": [
    {
      "address": "<string>",
      "chainId": 123,
      "type": "<string>",
      "decimals": 123,
      "symbol": "<string>",
      "name": "<string>",
      "logosUri": [
        "<string>"
      ],
      "underlyingTokens": [
        {
          "address": "<string>",
          "chainId": 123,
          "type": "<string>",
          "decimals": 123,
          "symbol": "<string>",
          "name": "<string>",
          "logosUri": [
            "<string>"
          ]
        }
      ],
      "project": "aave",
      "protocolSlug": "<string>",
      "apy": 3.8,
      "apyBase": 2.6,
      "apyReward": 1.2,
      "tvl": 3001020.8,
      "primaryAddress": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
project
string

The overarching project or platform associated with the DeFi token, for example aave

Example:

"aave"

​
protocolSlug
string

The specific standard integration or version of the DeFi project, for example aave-v2

Example:

"aave-v2"

​
chainId
number

Chain ID of the network of the token

Example:

1

​
type
enum<string>

Type of token. If not provided, both types will be taken into account

Available options:
defi,
base
Example:

"defi"

​
address
string[]

Ethereum addresses of the tokens

Example:
[
  "0x030bA81f1c18d280636F32af80b9AAd02Cf0854e"
]
​
underlyingTokens
string[]

Underlying tokens of defi token

Example:
[
  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
]
​
underlyingTokensExact
string[]

Exact composition of underlying tokens of defi token

Example:
[
  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
]
​
primaryAddress
string[]

Ethereum addresses for contract interaction of defi tokens

Example:
[
  "0x7d2768dE32b0b80b7a3454c06BdAc94A69DDc7A9"
]
​
apyFrom
number

Only include tokens with APY over this value

Example:

1

​
apyTo
number

Only include tokens with APY below this value

Example:

10

​
tvlFrom
number

Only include tokens with TVL over this value

Example:

0

​
tvlTo
number

Only include tokens with TVL below this value

Example:

10000000

​
page
number

Pagination page number. Pages are of length 1000

Example:

"1"

​
cursor
number

Cursor for pagination. Pages are of length 1000

Example:

"1233456"

​
includeMetadata
boolean
default:false

Whether to include token metadata (symbol, name and logos)

Example:

false

Response

200 - application/json
​
meta
object
required

Metadata for pagination

​
data
object[]

Returned data for current page

Was this page helpful?