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

# Returns tokens and their details

`GET /api/v1/tokens`

## 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 — Ethereum address of the token
    - `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 — Ethereum address of the token
      - `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.net/enso/apis/untitled-api.md) · [All operations](https://skmtc.net/enso/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/enso/untitled-api/revisions/b70d36b7002b/schema)