---
title: "Tokens"
method: GET
path: "/api/v1/tokens"
tags: ["Tokens"]
---

# Tokens

`GET /api/v1/tokens`

Returns tokens and their details. <Tip>This APi includes cursor-based pagination with default 1000 items per page.</Tip>

## Query parameters

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

## Response `200`

- object
  - `meta` PaginationMeta, required
    - `total` number, required — Total amount of pages
    - `lastPage` number, required — Last page number
    - `currentPage` number, required — Current page number
    - `perPage` number, required — Amount of elements per page
    - `prev` number, required — Previous page
    - `next` number, required — Next page
    - `cursor` number, required — 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, required — Token name
    - `name` string, nullable, required — Token symbol
    - `logosUri` string[], nullable, required — A list of logos for the token
    - `underlyingTokens` TokenModel[], nullable, required — 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, required — Token name
      - `name` string, nullable, required — Token symbol
      - `logosUri` string[], nullable, required — A list of logos for the token
    - `project` string, nullable, required — The overarching project or platform associated with the DeFi token, for example `aave`
    - `protocolSlug` string, nullable, required — The specific standard integration or version of the DeFi project, for example `aave-v2`
    - `apy` number, nullable, required — The defi position APY
    - `apyBase` number, nullable, required — The defi position base APY
    - `apyReward` number, nullable, required — The defi position reward APY
    - `borrowApyBase` number, nullable, required — The defi position base borrow APY
    - `borrowApyReward` number, nullable, required — The defi position reward borrow APY
    - `tvl` number, nullable, required — The defi position TVL
    - `primaryAddress` string, nullable, required — Ethereum address for contract interaction of defi token

---

[API](https://skmtc.dev/enso/apis/enso-api.md) · [All operations](https://skmtc.dev/enso/apis/enso-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/enso/enso-api/revisions/249f471fdafd/schema)