---
title: "Returns tokens and their details"
method: GET
path: "/api/v1/tokens"
tags: ["metadata"]
---

# Returns tokens and their details

`GET /api/v1/tokens`

## Request

- Base URL: `https://api.enso.finance`
- URL: `https://api.enso.finance/api/v1/tokens`
- Auth: HTTP bearer

## Query parameters

- `project` string
- `protocolSlug` string
- `underlyingTokens` string[]
- `underlyingTokensExact` string[]
- `primaryAddress` string[]
- `address` string[]
- `name` string[]
- `symbol` string[]
- `chainId` number
- `type` 'defi' | 'base'
- `liquidityType` 'SingleToken' | 'MultiToken'
- `page` number
- `pageSize` number
- `cursor` number
- `includeMetadata` boolean
- `includeUnderlying` boolean
- `apyFrom` number
- `apyTo` number
- `tvlFrom` number
- `tvlTo` number

## Response `200`

- object
  - `meta` PaginationMeta, required
    - `total` number, required: Total amount of pages
    - `lastPage` number, nullable: Last page number
    - `currentPage` number, nullable: Current page number
    - `perPage` number, required: Amount of elements per page
    - `prev` number, nullable: Previous page
    - `next` number, nullable: Next page
    - `cursor` number, nullable: Cursor for pagination
  - `data` PositionModel[]: Returned data for current page
    - `address` string, required: Token address on its chain. Solana addresses are case-sensitive.
    - `chainId` number, required: Chain ID of the network of the token
    - `type` string, required: Type of token
    - `decimals` number, required: Token decimals
    - `symbol` string, nullable: Token name
    - `name` string, nullable: Token symbol
    - `logosUri` string[], nullable: A list of logos for the token
    - `underlyingTokens` TokenModel[], nullable: Underlying tokens of defi token
      - `address` string, required: Token address on its chain. Solana addresses are case-sensitive.
      - `chainId` number, required: Chain ID of the network of the token
      - `type` string, required: Type of token
      - `decimals` number, required: Token decimals
      - `symbol` string, nullable: Token name
      - `name` string, nullable: Token symbol
      - `logosUri` string[], nullable: A list of logos for the token
    - `project` string, nullable: The overarching project or platform associated with the DeFi token
    - `protocol` string, nullable: The specific standard integration or version of the DeFi project
    - `depositType` number: Type of liquidity for deposits
    - `redeemType` number: Type of liquidity for redeems
    - `apy` number, nullable: The defi position APY
    - `apyBase` number, nullable: The defi position base APY
    - `apyReward` number, nullable: The defi position reward APY
    - `borrowApyBase` number, nullable: The defi position base borrow APY
    - `borrowApyReward` number, nullable: The defi position reward borrow APY
    - `tvl` number, nullable: The defi position TVL
    - `primaryAddress` string, nullable: Ethereum address for contract interaction of defi token

---

[API](https://skmtc.dev/enso/apis/enso-api-2.md) - [All operations](https://skmtc.dev/enso/apis/enso-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/enso/apis/enso-api-2/revisions/d43e21a824af?raw)