---
title: "Token List v4"
method: GET
path: "/v4/token/list"
tags: ["Token List"]
---

# Token List v4

`GET /v4/token/list`

Get list of all tokens. v4 includes informations about fundraising rounds, burns, and buybacks.

## Response `200`

Successful response

- object
  - `metadata` Metadata
    - `queryDate` string, date-time — Timestamp of the query
    - `credit` Credit — Optional quota state for the calling account, returned on most authenticated responses (both success and error). Treat it as optional: it may be absent on unauthenticated requests, demo/playground responses, and briefly right after a monthly reset. `used` is near-real-time and may lag the true count by a request or two.
      - `used` integer — Requests counted in the current window (approximate / eventually consistent).
      - `limit` integer — The plan's request quota for the window.
      - `resetAt` string, date-time — When the quota resets (RFC3339 UTC). Present for monthly plans; absent for lifetime-quota plans.
  - `status` boolean
  - `data` TokenListV4Item[]
    - `id` string — Identifier to call for a dataset
    - `name` string — Token Name
    - `symbol` string — Token Symbol
    - `listedMethod` 'INTERNAL' | 'AI' | 'EXTERNAL' — Method of listing
    - `circulatingSupply` number, nullable — Circulating supply of the token provided by external source (Will be null if no data present)
    - `marketCap` number, nullable — Market cap of the token provided by external source (Will be null if no data present)
    - `maxSupply` number, nullable — Max. Supply (Will be null if no data is present)
    - `totalLockedAmount` number — Total current locked token amount
    - `tbdLockedAmount` number — Total current TBD locked token amount
    - `unlockedAmount` number — Total current unlocked token amount
    - `untrackedAmount` number — Total current untracked token amount
    - `hasStandardAllocation` boolean — Data set identifier for standard allocation dataset
    - `hasFundraising` boolean — Data set identifier for fundraising
    - `latestFundraisingRound` string, nullable — The latest round raised
    - `hasBurn` boolean — Data set identifier for burn
    - `hasBuyback` boolean — Data set identifier for buyback
    - `websiteUrl` string — Link to Tokenomist token page
    - `lastUpdatedDate` string, date-time — Last updated date of token

---

[API](https://skmtc.net/tokenomist/apis/tokenomist-api.md) · [All operations](https://skmtc.net/tokenomist/apis/tokenomist-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tokenomist/tokenomist-api/revisions/1d812f25c55a/schema)