# About Us

Learn more about who we are

**Tokenomist.ai** is built by the team behind **DAOSURV**, one of the winning projects at DAOHACKS, hosted by ETHGlobal.

Our mission began with a simple goal: to bring structure, clarity, and trust to tokenomics data; a space filled with fragmentation and opacity.

We build analytics tools to track token unlocks, on-chain activity, and token supply dynamics. Our platform empowers teams and investors to see the full picture and make better decisions with confidence.

## Why we exist

We play multiple roles to help the industry grow with integrity:

* The **Bloomberg of crypto economics:** delivering the structured intelligence layer powering better investment and design decisions.
* The **PwC of tokenomics:** auditing projects with the rigor of public markets.
* The **Moody’s of crypto assets:** scoring and ranking tokens with data, not hype.
* The **curator’s magazine** for token collectors:  spotlighting projects worth watching.
* The **detective journalist:** chasing facts, exposing red flags, and telling stories the charts alone can’t.

## Vision

*Our vision is to become the infrastructure powering capital allocation in crypto, and the single source of tokenomics truth for the next trillion in digital assets.*

## Mission

* Make crypto **transparent**, **verifiable**, and **trustworthy**
* Deliver effortless answers to essential token questions
* Remove uncertainty around tokenomics to unlock broader adoption

**Learn more:** [**https://www.daosurv.com/**](https://www.daosurv.com/)


# Contact Us

Get in touch with the team behind Tokenomist

## Telegram

We generally respond fastest through Telegram. You can reach out to us here for

* Bug reports
* Incorrect or missing token data
* Token listing requests
* General support or quick questions

Join at [this link](https://t.me/daosurv).

## **X (Twitter)**

For updates, announcements, and light support, you can reach us on X. Follow and message us at [@tokenomist\_ai](https://x.com/tokenomist_ai).

## Email

Use email if you need help with

* Account or login issues
* Pro account & billing support
* Business or partnership inquiries
* General support and product questions

Reach out at <support@tokenomist.ai>.


# Tokenomist Team Verification

This page is for public team verification

This page helps you confirm who’s really part of the Tokenomist.ai team.

We list official team members with their verified Twitter and Telegram links so you can avoid scammers and impersonators.

If you’re ever unsure, check here first.

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><img src="/files/iEadLmOB05Fge6UMo8xp" alt="" data-size="original"></td><td><p><strong>Tanawat</strong></p><p>Twitter : <a href="https://twitter.com/ApeWAGMI">@ApeWagmi</a><br>Telegram : <a href="https://t.me/tanawat_ch">@tanawat_ch</a></p></td><td></td></tr><tr><td><p><img src="/files/7PtVm5TpPxAnaB3v6BXN" alt="" data-size="original"></p><p><strong>0xIsagi</strong></p><p>Twitter :<a href="https://twitter.com/0xIsagiBoi"> @0xIsagiBoi</a><br>Telegram : <a href="https://t.me/isagi_tokenunlock">@isagi_tokenunlock</a></p></td><td></td><td></td></tr><tr><td></td><td></td><td></td></tr></tbody></table>

**Not sure if someone is really on the team?**\
Reach out via tokenomist.ai or our support channels to double check.


# Tokenomist

A guide to our free tools

## Overview

Tokenomist Free gives you access to the essential tools for exploring token unlocks and supply schedules. Track upcoming unlock events, view project pages, and stay informed on tokenomics fundamentals, all in one place.

Let’s take a look at what you can do with a Free account.

## Stay up to date with upcoming token releases

Get a real-time view of upcoming token releases across the market on the Token Unlocks page. Tokenomist aggregates release schedules from verified sources so you never miss a key event.

<figure><img src="/files/9pKhwNXq0xCZrkd0pgFB" alt=""><figcaption></figcaption></figure>

Additionally, filter by category, big unlocks, or market cap in order to narrow down tokens of interest.

Learn more about our [Token Unlocks](/features/token-unlocks) page and what you can do with it.

## Track project release schedules with monthly detail

Explore historical and projected token release schedules at the individual project level, broken down with monthly granularity. See when and how much supply is set to be released, and who it is allocated to.

<figure><img src="/files/lBmqpigyNHBZfRYELxRC" alt=""><figcaption></figcaption></figure>

See Precision and Assumptions to see data granularity, assumptions made, and references, in order to verify data yourself.

<figure><img src="/files/70VKtYs3sNCbAaqOvfPM" alt=""><figcaption></figcaption></figure>

Check out the [Token Page](/tokenomist/token-page) to see everything you can do with it, or learn more about how [Precisions and Assumptions](/methodology/precisions-and-assumptions) works.

## Analyze market-wide emissions

Go beyond single projects by analyzing the total emissions of the crypto market in any rolling two-month window. Quickly identify periods of elevated supply pressure across the ecosystem.

<figure><img src="/files/8CbOSs3WfQ48vY585FVv" alt=""><figcaption></figcaption></figure>

Filter by category to see sector specific supply pressure.

See [Emission](/features/emission) to learn more about this feature.

## Compare token specific emissions

View total, cliff, and linear releases for specific tokens projected in the next 7 days or 1 month. Understand how different schedules affect near-term supply dynamics.

<figure><img src="/files/wc4C7pUNlAwtyXqttp0U" alt=""><figcaption></figcaption></figure>

See emission rates as percentage of circulating or unlocked supply for further analysis.

See how to make use of our [Emission Comparison](/features/emission/emission-comparison) feature.

## See the latest tokenomics updates

Stay informed with the most recent changes to tokenomics, including schedule updates, allocation adjustments, and new project disclosures. All updates are verified and continuously tracked for accuracy.

<figure><img src="/files/YSCQsSaxZyJ8wZOmZQCh" alt=""><figcaption></figcaption></figure>

Learn more about why and how we track [Updates](/features/updates).

## Switch to trader mode

Enable **Trader Mode** (also known as **WenUnlocks**) for a streamlined view built for active market participants. Highlight the most immediate unlocks and emissions data with monthly precision.

<figure><img src="/files/VG4uruCQQkd6EtRjx9v2" alt=""><figcaption></figcaption></figure>

It’s designed for quick decision-making, letting you react faster to supply events.

## What about Pro?

Check out [Tokenomist Pro](/tier-overviews/tokenomist-pro) to see all the additional tools available to you with a **Pro** subscription, or visit [Pricing](https://tokenomist.ai/pricing) to see the full list of differences between tiers.


# Tokenomist Pro

Your guide to Pro features

## Overview

Tokenomist is the leading intelligence suite for tokenomics data. With Pro, you get access to advanced research tools that let you analyze release schedules, track supply, and monitor on-chain movements, all in one powerful platform.

Let’s take a look at what you can do with a Pro account.

{% hint style="info" %}
Changes from Free are highlighted with a <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> symbol. Please see our [Pricing](https://tokenomist.ai/pricing) page for more details.
{% endhint %}

## Stay up to date with upcoming token releases

Get a real-time view of upcoming token releases across the market on the Token Unlocks page. Tokenomist aggregates release schedules from verified sources so you never miss a key event that could impact supply dynamics.

<figure><img src="/files/9pKhwNXq0xCZrkd0pgFB" alt=""><figcaption></figcaption></figure>

Filter by category, big unlocks, or market cap in order to narrow down tokens interest.

Learn more about our [Token Unlocks](/features/token-unlocks) page and what you can do with it.

## Track project release schedules with daily detail

Explore token release schedules at the individual project level, up to **Daily** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> or **Weekly** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> granularity. This allows you to see when and how much supply is set to enter circulation, and who it is allocated to.

<figure><img src="/files/lBmqpigyNHBZfRYELxRC" alt=""><figcaption></figcaption></figure>

Ascertain the nearest upcoming unlock events and past unlock events at a glance.

<figure><img src="/files/1YKxDwyyEYGGNwthxXdw" alt=""><figcaption></figcaption></figure>

Additionally, group allocations using **Standard Allocations** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> in order to view a standardized grouping of allocations by stakeholder type and their release schedules.

<figure><img src="/files/GMji0YvdaeycnHG9w8iO" alt=""><figcaption></figcaption></figure>

See **Precision and Assumptions** to see data granularity, assumptions made, and references, in order to verify data yourself.

<figure><img src="/files/70VKtYs3sNCbAaqOvfPM" alt=""><figcaption></figcaption></figure>

Check out the [Token Page](/tokenomist/token-page) to see everything you can do with it, or learn more about how [Standard Allocations](/methodology/standard-allocations)and [Precisions and Assumptions](/methodology/precisions-and-assumptions) works.

## Overlay key token supply metrics on release schedules

View additional metrics like **Claimed Supply** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> and **Burned Supply** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>, and overlay them directly onto release schedules. This provides a richer view of how token supply evolves over time.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2F7LQUPz0ATStMnWeTTs8f%2Fenable-burn.mp4?alt=media&token=59a6eb19-7f6e-46ce-a118-ae66b48591d7>" %}

By combining unlock projections with real-time metrics, you can better understand supply and its impacts.

Find out more about [On-Chain Claims](/features/on-chain-claims) or [Supply Metrics](/methodology/supply-metrics).

## Explore fundraising rounds and investors

Access details on a project’s fundraising history, including rounds, amounts raised, and key investors. Gain insights into how capital flows shape token distribution and positioning.

<figure><img src="/files/YTbtRUQHb2Lc8IBi9TkK" alt=""><figcaption></figcaption></figure>

Use fundraising data to evaluate long-term project backing and investor influence.

Learn more about the [Fundraising Screener](/features/fundraising-screener) and the [Fundraising](/features/token-page/fundraising) page.

## Discover token competitors by sector

See which tokens compete in the same sector by market capitalization and fully diluted valuation. Better understand positioning within a category and compare supply dynamics across projects.

<figure><img src="/files/i50oKOjABgIureqpqXFY" alt=""><figcaption></figcaption></figure>

Use competitor analysis to benchmark projects and spot relative advantages.

See how to use our [Token Competitors](/features/token-page/token-competitors) feature.

## Compare allocation strategies across token projects

Compare token allocations using Tokenomist’s **Standard Allocations** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> framework. Evaluate how different projects distribute supply across teams, investors, and ecosystems.

<figure><img src="/files/qWFPJ5lxIvWW2gpSMbns" alt=""><figcaption></figcaption></figure>

Spot trends in allocation design and assess stakeholder incentives.

Learn about our [Standard Allocations](/methodology/standard-allocations) methodology or become acquainted with our [Allocation Comparison](/features/allocation/allocation-comparison) and [Allocation Screener](/features/allocation/allocation-screener) features.

## Understand supply movement from release to market

Track tokens as they move out of vesting and internal wallets using **On-Chain Claims** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>. Understand how much supply has been withdrawn by beneficiaries.

<figure><img src="/files/CdplUOQUa61YoewEjyze" alt=""><figcaption></figcaption></figure>

Learn how we track [On-Chain Claims](/features/on-chain-claims) and how to use the feature.

## Analyze market-wide emissions by token

Go beyond single projects by analyzing the total emissions of the crypto market in any rolling **six-month** **window** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>. **Breakdown by token** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> to see token-specific supply impacts. Quickly identify periods of elevated supply pressure across the ecosystem.

<figure><img src="/files/SBMuHHYpUhX8Vpd84OXc" alt=""><figcaption></figcaption></figure>

Filter by category to see sector-specific supply pressure.

Check out [Crypto Market Emission](/features/emission/crypto-market-emission) to see how it works.

## Compare emissions across tokens

View total, cliff, and linear releases for specific tokens projected up to **+6M** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> or **+1Y** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>. Understand how different schedules affect near-term supply dynamics.

<figure><img src="/files/liWYADWOqZ6J855s8WC4" alt=""><figcaption></figcaption></figure>

See emission rates as percentage of circulating or unlocked supply for further analysis.

Find out what you can do with the [Emission Comparison](/features/emission/emission-comparison) tool.

## Export data as CSV for analysis

Export all previously mentioned data in **CSV format** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>. Integrate Tokenomist’s intelligence into your own tools and models.

<figure><img src="/files/PEBZ0qq18TDfgemHXJfA" alt=""><figcaption></figcaption></figure>

Bring data into your research workflow for deeper custom analysis.

See how you can get started with [CSV Download](/features/csv-download).

## See the latest tokenomics updates

Stay informed with the most recent changes to tokenomics, including schedule updates, allocation adjustments, and new project disclosures. All updates are verified and continuously tracked for accuracy.

<figure><img src="/files/YSCQsSaxZyJ8wZOmZQCh" alt=""><figcaption></figcaption></figure>

Learn more about [Updates](/features/updates) and how we track them.

## Switch to trader mode

Enable [**Trader Mode**](https://tokenomist.ai/wenunlocks) (also known as [**WenUnlocks**](https://tokenomist.ai/wenunlocks)) for a streamlined view built for active market participants. This mode highlights the most immediate unlocks and emissions data with **daily** **precision** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>.

<figure><img src="/files/VG4uruCQQkd6EtRjx9v2" alt=""><figcaption></figcaption></figure>

It’s designed for quick decision-making, letting you react faster to supply events.

## Enjoy Tokenomist with no ads

Tokenomist Pro is a completely ad-free experience. Focus on the data that matters without distractions or clutter.


# Overview

A high-level snapshot of token supply, unlocks, and key metrics

## Overview

The Overview page serves as the starting point for navigating Tokenomist. It provides a high-level summary of key market emissions and upcoming supply changes. From here, you can quickly identify trends and direct yourself to other features for deeper analysis.

<figure><img src="/files/xlM8LKv1pYtH7HtHVCmb" alt=""><figcaption></figcaption></figure>

## Key Sections

At the top of the main data sections, you'll find filters that allow you to customize your view. You can filter by **category** (e.g., AI & Agent, DeFi, GameFi) or focus on the **Top 300 tokens** by market capitalization.

### **Highlight Bar**

These components provide a quick overview of key weekly metrics.

* **Weekly Total Value Unlock**: This metric shows the total value of all tokens that have released in the past week, providing a clear picture of new supply.
* **Recently Added**: A list of tokens recently added to the Tokenomist platform.
* **Updates**: A news feed of recent tokenomics changes that keeps you informed when projects adjust their allocations or release schedules.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FErLnCugXhlxChdkdjPpK%2Foverview-highlight.mp4?alt=media&token=4ed5032c-ba74-4d16-9f3b-d002d8ae6ffa>" %}

Learn more about how to use [Crypto Market Emission](/features/emission/crypto-market-emission), our [Token Listing Process](/methodology/token-listing-process), or how [Updates](/features/updates) work.

### **Unlocks Analysis**

This section is your forward looking tool for anticipating upcoming token supply changes.

* **Cliff Unlocks Next 7D**: This section highlights any significant cliff unlocks happening soon, which can lead to sudden shifts in market supply.
* **Today Linear Release**: This section shows the total value of tokens being released in a linear fashion on the current day, which helps you understand constant supply flow.
* **Upcoming Unlocks Table**: The main table below provides a previewed of upcoming unlocks, including both cliff and linear events. You can use this to see the total unlocked amount for each project and its value, helping you assess the potential impact on the market.

<figure><img src="/files/PQvQ9SpmWbtF7hU9S6oc" alt=""><figcaption></figcaption></figure>

View the [Token Unlocks](/features/token-unlocks)page for more information, or learn about how we categorize emissions at [Emission: Cliff, Linear](/methodology/emission-cliff-linear).

### **Emission Analysis**

This section helps you understand the rate at which new tokens are being released and how it impacts the market.

* **Emission Analysis**: The chart in this section illustrates the 7-day emission comparison, highlighting which tokens are adding the most new supply to the market. This is useful for identifying potential sell-side pressure.
* **Top Supply Growth Last 30D**: This table highlights tokens with the highest supply growth over the last 30 days. It includes key metrics like market cap change, supply change, and price change, which can help you identify tokens with rapidly expanding supply.

<figure><img src="/files/g0FL4T7jprBoKuE0ilh1" alt=""><figcaption></figcaption></figure>

See [Emission Comparison](/features/emission/emission-comparison) how to use it.

### **Allocation Analysis**

This component gives you a breakdown of a project's token distribution, helping you gauge stakeholder interest and potential market risk.

* **Allocations Analysis**: A bar chart that visually represents how a token's supply is allocated among different stakeholder groups. This provides insight into the distribution of a token and potential concentrated selling interest.

<figure><img src="/files/V2u5hPGn8BH64eljrMZa" alt=""><figcaption></figcaption></figure>

Learn more about [Standard Allocations](/methodology/standard-allocations) or how to use [Allocation Comparison](/features/allocation/allocation-comparison).

### **Post-Unlocks Analysis**

This section focuses on the real-world flow of tokens after they are unlocked.

* **On-Chain Claims**: This table details tokens with recent on-chain claims. It shows the total unlocked value and the percentage that has been claimed, providing a more accurate picture of the true circulating supply.

<figure><img src="/files/rM04skjfOEXYqTJaCkkM" alt=""><figcaption></figcaption></figure>

Check out how to use our [On-Chain Claims](/features/on-chain-claims) here.


# Token Unlocks

Monitor cliff and linear unlocks across the entire market

## Overview

The **Token Unlocks Dashboard** is a central tool for tracking the most important unlock events and analyzing their potential impact on the market. It provides a comprehensive view of **cliff unlocks**, **linear releases**, and a detailed table of **upcoming unlock events**.

<figure><img src="/files/9pKhwNXq0xCZrkd0pgFB" alt=""><figcaption></figcaption></figure>

## Key Sections

### Highlight Bar

These components give you an immediate snapshot of the most significant token unlock events and platform updates happening right now.

* **Cliff Unlocks Next 7D**: This metric highlights tokens with major cliff unlocks scheduled within the next seven days.
* **Today Linear Release**: This component shows the total value of tokens being released continuously on the current day. It helps you understand the constant supply flow of major assets.
* **Updates**: A news feed of recent tokenomics updates that helps you stay up to date with project movements.
* **Crypto Market Emission**: This chart shows the total value of tokens released into the market on a weekly basis, providing a broad overview of new supply.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FuHo6WJN83HlRavyxNhwr%2Ftoken-unlocks-dashboard-highlight.mp4?alt=media&token=2cfcd0c9-14ee-4323-9058-380a83abc803>" %}

Learn more about how [Updates](/features/updates) work, or see how to use [Crypto Market Emission](/features/emission/crypto-market-emission) in action.

### **Token Unlocks Table**

This is the central component of the dashboard, providing a detailed, sortable, and filterable list of all tracked projects and their unlock data. At the top of the table, you'll find filtering options to customize your view:

* **Filters**: You can filter the data by **category** (e.g., AI & Agent, DeFi, Layer 1), **Top 300** to focus on the largest projects by market capitalization, or **Big Unlocks** to show only upcoming unlocks worth **$10M** or more. This is a useful for identifying high-impact events.
* **Search**: Use the search bar to find any project by name or ticker. Note that this will respect any active filters.
* **CSV Download** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>: The CSV download button allows you to export the entire table data. The download will respect any active filters, so you will only get the data for the projects you are currently viewing. Want to know more? See [CSV Download](/features/csv-download).

Each column in the table provides a key metric for quick analysis.

* **Project Name**: The name of the token, accompanied by a star icon to add it to your [Watchlist](/features/watchlist).
* **Price**: The current price of the token, reported from [CoinGecko](https://coingecko.com).
* **24h % Change**: The token's price change over the past 24 hours.
* **M.Cap**: The token's current market capitalization, reported from [CoinGecko](https://coingecko.com).
* **Circulating Supply**: The total number of tokens currently in circulation, reported from [CoinGecko](https://coingecko.com).
* **Released Percentage**: The percentage of the total supply that has been released according to its release schedule.
* **Upcoming Unlock**: This column shows the amount of the next scheduled unlock and its percentage of current released supply, along with a countdown to the event.
* **Next 7D Emission**: The amount of tokens that will be released over the next seven days and its percentage of current released supply.

<figure><img src="/files/Q2YF9MSKFrF9RZDlZXft" alt=""><figcaption></figcaption></figure>


# Token Page

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Overview</strong></td><td>Supply details, release schedule, and the key assumptions behind our listing</td><td data-object-fit="cover"><a href="/files/lBmqpigyNHBZfRYELxRC">/files/lBmqpigyNHBZfRYELxRC</a></td><td><a href="/pages/4qmaiMbpewC8AkccaQpn">/pages/4qmaiMbpewC8AkccaQpn</a></td></tr><tr><td><strong>Tokenomics</strong></td><td>Detailed view of allocations and release schedules</td><td><a href="/files/H8YLs7R44nOsBxZJLPx9">/files/H8YLs7R44nOsBxZJLPx9</a></td><td><a href="/pages/FKk4ofG3B4ZZnasQndkv">/pages/FKk4ofG3B4ZZnasQndkv</a></td></tr><tr><td><strong>Unlock Events</strong></td><td>Track major cliff-based unlocks, past and upcoming</td><td><a href="/files/cn8T0lpkK0KqDDT0mO0C">/files/cn8T0lpkK0KqDDT0mO0C</a></td><td><a href="/pages/uR6qxKkzdYgWCprHQwOE">/pages/uR6qxKkzdYgWCprHQwOE</a></td></tr><tr><td><strong>Token Competitors</strong></td><td>Compare a token’s valuation and float against its peers</td><td><a href="/files/i50oKOjABgIureqpqXFY">/files/i50oKOjABgIureqpqXFY</a></td><td><a href="/pages/lmDrzMEgTeBoET8pS4RF">/pages/lmDrzMEgTeBoET8pS4RF</a></td></tr><tr><td><strong>Fundraising</strong></td><td>Track who invested, how much was raised, and at what valuation</td><td><a href="/files/YTbtRUQHb2Lc8IBi9TkK">/files/YTbtRUQHb2Lc8IBi9TkK</a></td><td><a href="/pages/YtC7SBSNnvbwSmmrHCSX">/pages/YtC7SBSNnvbwSmmrHCSX</a></td></tr><tr><td><strong>Claims</strong></td><td>Follow tokens from release to circulation</td><td><a href="/files/CdplUOQUa61YoewEjyze">/files/CdplUOQUa61YoewEjyze</a></td><td><a href="/pages/mmcyZT0q6dQvAROADf0s">/pages/mmcyZT0q6dQvAROADf0s</a></td></tr><tr><td><strong>Updates</strong></td><td>Stay ahead with every tokenomics change</td><td><a href="/files/YSCQsSaxZyJ8wZOmZQCh">/files/YSCQsSaxZyJ8wZOmZQCh</a></td><td><a href="/pages/K8rvAzJK8AKzuUhsd4LJ">/pages/K8rvAzJK8AKzuUhsd4LJ</a></td></tr></tbody></table>


# Overview

Supply details, release schedule, and the key assumptions behind our listing

## Overview

Each token tracked on Tokenomist has a dedicated page that consolidates **release schedules, allocations,** and **methodology** in one place. This shows you not only *when* tokens are released, but also *who benefits* and *how precise* the data is.

<figure><img src="/files/bLkoXsGD6pIQzepMyJwu" alt=""><figcaption></figcaption></figure>

## Accessing the Token Page

The Token Page is available for every tracked asset in Tokenomist. You can access it by searching directly from the sidebar or top navigation, or by clicking into any token from features such as the [Emission Screener](/features/emission/emission-screener), [Allocation Screener](/features/allocation/allocation-screener), or [Fundraising Screener](/features/fundraising-screener).&#x20;

Each Token Page is organized into the following modules:

1. **Emission**: Net supply changes (cliff, linear, inflation, deflation). See for how we categorize releases into cliff unlocks or linear releases at [Emission: Cliff, Linear](/methodology/emission-cliff-linear).
2. **Unlock Progress & Notable Events**: A snapshot of total released supply and upcoming cliff unlocks.
3. **Release Schedule**: An interactive token release chart with allocation toggles and metric overlays.
4. **Tokenomics Reference**: Source reliability via [Precisions and Assumptions](/methodology/precisions-and-assumptions).

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FSB64YjgqJmeTAa0hcGsc%2Faccessing-token-page-overview.mp4?alt=media&token=dc4235da-2d36-4756-b517-2b46e8cb0394>" %}

## How to Use the Token Page

### Emission

At the top of the page, you’ll see live **price, market cap, fully diluted value (FDV), circulating supply, and max supply**, sourced from [CoinGecko](https://coingecko.com). These provide the baseline context for every analysis. For more information on supply metrics, please see [Supply Metrics](/methodology/supply-metrics).

<div data-full-width="false"><figure><img src="/files/Tn1UDBd8OAGD4As26lKO" alt=""><figcaption></figcaption></figure></div>

Beside that is the emission component, which standardizes all supply changes into

* **Inflation**: all positive supply emission from cliff unlocks and linear releases.
* **Deflation**: all negative supply decreases from mechanisms such as burn.
* **Emission**: the difference between inflation and deflation in the timeframe.

Emissions can be projected across multiple horizons, which include +1D, +7D, +1M, **+6M** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>**, +1Y** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>**, +4Y** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>**.** By default, the timeframe is set to **All**, which is all **historical** **emissions**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2Fl1thBVwnXVb1E7dOIwQC%2Ftoken-page-overview-emission.mp4?alt=media&token=abf62fea-2fe6-4f54-a898-4552cb0c1d9e>" %}

### Unlock Progress & Events

The unlock widget shows **total supply status**, i.e., how much of the token’s supply is Unlocked, TBD Locked (see [TBD Locked](/methodology/tbd-locked)), Unlocked, or Untracked.&#x20;

To the right of that, the **Notable Cliff Unlocks** carousel shows 3 historical and 1 upcoming cliff unlock events (or up to **10 historical cliff unlock events and 5 upcoming cliff unlock events with Pro** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>), excluding mining emissions.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2F5NbsPpebaJ4ZrDZif0zO%2Ftoken-page-overview-unlock-progress-and-events.mp4?alt=media&token=9aa31f2f-fc90-405f-8c52-ce6dd7fa5764>" %}

These components can be used to gauge the current status of token release progress and any important upcoming release events at a glance.

### Release Schedule

The **Release Schedule** shows how supply enters circulation over time, with interactive tools to customize the view.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FyG6djMIEVEW6Ewix4Vae%2Ftoken-page-overview-release-schedule.mp4?alt=media&token=ba45eb4d-bd8a-48e1-ab44-0ee3c1b7165e>" %}

On the left, allocations can be toggled individually or regrouped into [Standard Allocations](/methodology/standard-allocations) for cross-project comparison. Both the chart and the allocation table update instantly, and **Pro** users can export the full dataset as **CSV** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>.

The chart offers multiple controls:

* **Modes**: Cumulative stacked (default) or a non-cumulative bar chart
* **Timeframes**: the last 7D, 1M, 1Y, or All for the entire historical and projected view
* **Resolution**: Monthly, **Weekly** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>**, Daily** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>

Striped bars highlight **TBD allocations**, making uncertain supply visible. If projects later define these, updates are recorded in the **Historical Changes** panel. See [TBD Locked](/methodology/tbd-locked) for more information.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FOGXacSdOiQzxjG2fNWsG%2Ftoken-page-release-schedule-tbd.mp4?alt=media&token=dccc29e5-082a-4d3a-9585-d060272cd5ce>" %}

For additional context, you can click **Add Metric** to overlay additional metrics such as additional price pairs and metrics. **Pro** users can also overlay **Total Claimed Supply** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>, **Total Unlocked Supply** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>, and **Burn** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> for applicable tokens, connecting release schedules to on-chain and market behavior.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FvzgKHczCH7hS1G1QOfda%2Ftoken-page-release-schedule-metrics.mp4?alt=media&token=dcbe338f-4e16-4792-82dd-0e128fc96c8f>" %}

### Tokenomics Reference

At the bottom of every token page, allocations are listed with two important tags: **Assumption** and **Precision**. Together, these form our **Precision & Assumption framework**, which helps you quickly judge how reliable each piece of tokenomics data is.

<figure><img src="/files/70VKtYs3sNCbAaqOvfPM" alt=""><figcaption></figcaption></figure>

**Assumptions** show *where the release data originates*. **Precision** indicates *how exact the timing is*. This framework ensures that you aren’t just seeing *what* is set to unlock, but also *how much confidence* you should have in that information.

Learn more at [Precisions and Assumptions](/methodology/precisions-and-assumptions).

## Why It Matters

The Token Page combines every aspect of supply analysis into one standardized view. This makes it easier to evaluate dilution risk, investor incentives, and long-term sustainability, all in one place.

## Where To Next?

* Check out the remaining features of the token page: [Tokenomics](/features/token-page/tokenomics), [Unlock Events](/features/token-page/unlock-events), [Token Competitors](/features/token-page/token-competitors), [Fundraising](/features/token-page/fundraising), [On-Chain Claims](/features/on-chain-claims), and [Updates](/features/updates).
* Learn more about our [Token Listing Process](/methodology/token-listing-process).
* See our methodology for [Non-Traditional Unlock Mechanisms](/methodology/non-traditional-unlock-mechanisms), [Precisions and Assumptions](/methodology/precisions-and-assumptions), [TBD Locked](/methodology/tbd-locked), and [Standard Allocations](/methodology/standard-allocations).


# Tokenomics

Detailed view of allocations and release schedules

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

The Tokenomics pane provides a full-screen, detailed view of a project’s allocations and release schedules. Here, you can explore every allocation in more detail.

<figure><img src="/files/H8YLs7R44nOsBxZJLPx9" alt=""><figcaption></figcaption></figure>

## Accessing Tokenomics

You can access the Tokenomics pane directly from a project’s token page. Once inside, you’ll find three main tabs at the top:

* **Allocation**: a breakdown of each allocation, including progress, unreleased amounts, and upcoming cliffs.
* **Group Allocation**: the [Standard Allocations](/methodology/standard-allocations) view, showing a breakdown of allocations into Tokenomist’s **Standard Allocations**.
* **Release Mechanism**: a classification of the methods through which supply is distributed. *This view is in development and will be expanding soon*. Please refer to [Release Mechanisms](/methodology/release-mechanisms) for more information.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FAFjt1Xn54ScP1FcW7O4O%2Faccessing-token-page-tokenomics.mp4?alt=media&token=4a9138c0-9815-4e0d-af13-f212423d42e1>" %}

## How to Use Tokenomics

You can use the Tokenomics pane to

* Track *how much* of an allocation has been released and *how much remains locked*.
* See *when* the next cliff or release event is coming.
* Compare allocations side by side in the chart and release schedule.
* Investigate assumptions or governance dependencies (e.g., treasuries requiring DAO approval before distribution).

Clicking on any allocation row opens a modal with detailed information: precision, assumptions, release method, references, and allocation-specific release schedules.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FMwwMeAJfC1tmHhWiDV4c%2Ftoken-page-tokenomics.mp4?alt=media&token=616dba56-62c5-4963-becc-1e039f72d128>" %}

## Why It Matters

Tokenomics defines the long-term sustainability of a project. A project may have strong fundamentals, but if emissions are concentrated in certain allocations or subject to vague governance processes, the risks can be significant.

## Where To Next?

* Check out the remaining features of the token page: [Unlock Events](/features/token-page/unlock-events), [Token Competitors](/features/token-page/token-competitors), [Fundraising](/features/token-page/fundraising), [On-Chain Claims](/features/on-chain-claims), and [Updates](/features/updates).
* Learn more about [Standard Allocations](/methodology/standard-allocations) and how our classification works.
* See how we define [Release Mechanisms](/methodology/release-mechanisms) and map them to allocations.
* Learn how to interpret our [Precisions and Assumptions](/methodology/precisions-and-assumptions) feature.


# Unlock Events

Track major cliff-based unlocks, past and upcoming

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

The Unlock Events pane highlights the most important upcoming and historical unlocks for a token. It focuses specifically on **cliff-based unlocks**. **Continuous release mechanisms** such as mining rewards, staking emissions, or yield farming are **deliberately excluded here**.

This view makes it easy to see *when* large cliffs are scheduled, *how much* supply will be introduced, and *which allocations* are affected.

<figure><img src="/files/cn8T0lpkK0KqDDT0mO0C" alt=""><figcaption></figcaption></figure>

## Accessing Unlock Events

You can find the Unlock Events tab on any project’s token page, alongside [Tokenomics](/features/token-page/tokenomics), [Token Competitors](/features/token-page/token-competitors), [Fundraising](/features/token-page/fundraising), and other panes.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FrG71rfuCSYFHmi2Bbkk0%2Faccessing-token-page-unlock-events.mp4?alt=media&token=f0ed1fbe-3e7b-41a6-aa84-b45bece1c720>" %}

## How to Use Unlock Events

Once inside, the table presents three perspectives:

* **Upcoming events**: the next 5 cliffs scheduled for release.
* **Past events**: the 10 most recent cliffs that have already occurred.
* **All**: upcoming and past events combined.

Clicking any row opens a detailed panel on the right-hand side, showing the exact value, number of tokens, percentage released, precisions and assumptions, and a allocation-level breakdown.

## Why It Matters

Unlike gradual releases, cliffs can suddenly increase circulating supply by millions of tokens in a single day. Understanding the timing and size of these cliffs is essential for risk management, valuation analysis, and trading strategy.

## Where To Next?

* Check out the remaining features of the token page: [Tokenomics](/features/token-page/tokenomics), [Token Competitors](/features/token-page/token-competitors), [Fundraising](/features/token-page/fundraising), [On-Chain Claims](/features/on-chain-claims), and [Updates](/features/updates).
* Learn more about how we classify unlock events at [Emission: Cliff, Linear](/methodology/emission-cliff-linear).


# Token Competitors

Compare a token’s valuation and float against its peers

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

**Competitor Analysis** helps you put a token’s valuation into context. Instead of looking at **market cap** or **fully diluted value (FDV)** in isolation, this tool compares these metrics against a group of similar tokens while also accounting for **float** (the percentage of tokens already released).

This allows you to see whether a project looks undervalued, overvalued, or fairly positioned relative to its peers.

<figure><img src="/files/uNmfiZvnlYK8PVqPALEb" alt=""><figcaption></figcaption></figure>

## Accessing Competitor Analysis

You’ll find Competitor Analysis inside every token page. The analysis is available in two views: a scatter plot that highlights float classifications and a bar chart that provides a direct comparison of FDV and market cap across tokens.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2F3nwavjRkeck66kbYVjkO%2Faccessing-token-page-competitor-analysis.mp4?alt=media&token=5dfb0266-f8b1-4590-8282-bb833cc82eae>" %}

## Using Competitor Analysis

The **scatter plot** shows Market Cap versus FDV, layered with diagonal float bands.

Tokens plotted **along the diagonal lines** are **trading in line with their release progress**, while those above or below may be over or undervalued relative to float. E.g., a token sitting in the “low float” band with a high market cap may face dilution risk as more supply comes into circulation.

<figure><img src="/files/oet9cu4MWBuZdSnXmy0x" alt=""><figcaption></figcaption></figure>

The **bar chart** presents a straightforward visual comparison of valuations.

It complements the scatter plot by stripping away float and simply ranking tokens by FDV and market cap. Reference lines for sector averages make it easy to see where a project sits compared to the broader group, and the detailed valuation panel below provides precise numbers for each metric.

<figure><img src="/files/4qRIqOofkE6XzM9dakbG" alt=""><figcaption></figcaption></figure>

Both views include interactive tooltips, sector average markers, and the ability to download the dataset for deeper work.

## Why It Matters

Looking at a token’s valuation in isolation can be misleading, but by comparing it against peers, you get a clearer sense of where it stands. Competitor Analysis helps surface three critical insights:

1. Whether a token’s valuation aligns with its release schedule
2. Whether it trades above or below sector averages
3. Where risks of dilution or opportunities for undervaluation might lie.

This makes it easier to separate hype from substance.

## Where To Next?

* Check out the remaining features of the token page: [Tokenomics](/features/token-page/tokenomics), [Unlock Events](/features/token-page/unlock-events), [Fundraising](/features/token-page/fundraising), [On-Chain Claims](/features/on-chain-claims), and [Updates](/features/updates).
* Visit [Supply Metrics](/methodology/supply-metrics) to understand terms and definitions.


# Fundraising

Track who invested, how much was raised, and at what valuation

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

A project’s fundraising history reveals who backed it, how much was raised, and at what valuation. This serves as a window into **investor conviction** and **private-market expectations**. Additionally, comparing those early benchmarks to today’s valuation shows **whether a token trades at a discount**, **fair value**, or **premium**.

Tokenomist standardizes this view, combining rounds, valuations, entry prices, and investors into a single dashboard.

<figure><img src="/files/q7izTGJmwWfpjDl4uiPE" alt=""><figcaption></figcaption></figure>

## Accessing Token Fundraising

Within each token profile, the **Fundraising tab** provides a complete breakdown. Additionally, clicking into a token from the [Fundraising Screener](/features/fundraising-screener) will lead to this page.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FkNd47ZqTdb9y3U6cinz0%2Faccessing-token-page-fundraising.mp4?alt=media&token=0b0f5dbc-6ba6-4d41-ab4d-fad5082c9f70>" %}

## How to Use Token Fundraising

At the top, you’ll find a fundraising overview with total capital raised and the stages of each round. Alongside this, a valuation chart compares **total raised**, **current market cap**, and **fully diluted valuation (FDV)**, showing how the token stacks up against amounts originally committed by investors.

Below, the **Funding Rounds table** details every raise. Each row can be expanded to reveal additional participants, so you can follow the network of backers round by round.

Additionally, the **All Investors** view aggregates every participant, showing who invested once, who doubled down in later rounds, and who continues to have exposure across stages.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FRgYWcFGZymtSN3Z0wsoR%2Ftoken-page-fundraising.mp4?alt=media&token=d9acdbce-b419-4226-97f6-8ce4f5bd43ec>" %}

## Why It Matters

Fundraising data provides transparency into what investors saw in the project and at what price they were willing to commit.

Understanding fundraising rounds helps manage risk. If large allocations were sold at low entry prices, those tokens may eventually come to market once lockups expire, creating potential sell pressure. On the flip side, strong investor alignment across multiple rounds can be a signal of long-term sustainability.

## Where To Next?

* Learn more about our [Supply Metrics](/methodology/supply-metrics) to understand how we define supply related terms.
* Check out the [Fundraising Screener](/features/fundraising-screener) to see an overview of fundraising projects across categories.


# Buyback

Track how projects execute buyback programs for their tokens.

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## **Overview**

The **Buyback** section tracks when a project repurchases its own tokens from the market. This is typically done to reduce circulating supply, stabilize price, or return value to token holders.

Tokenomist aggregates on-chain and reported buyback data to show how much has been repurchased, how much was spent, and the resulting impact on token supply.

<figure><img src="/files/YMnQFcZ4MblP9n3WFv2F" alt=""><figcaption></figcaption></figure>

## **Accessing Buyback Data**

You can find the **Buyback** section directly on a token’s page. It includes:

* A **summary panel** showing total tokens repurchased, total amount spent (USD), and total value (USD).
* An **interactive chart** visualizing buyback activity over time.
* A **table of latest buyback events**, detailing amounts, transaction costs, and recipient addresses.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FB7Jjl7r7AfR8yZ035eAl%2Faccessing-buyback.mp4?alt=media&token=7109bb18-c647-4bb9-9c08-9fe187b2cea5>" %}

Additionally, you can also get here through the [Buyback Comparison](/features/buyback/buyback-comparison) or [Buyback Screener](/features/buyback/buyback-screener) features.

## **How to Use Buyback**

The **Buyback Overview** summarizes the key metrics at a glance:

* **Total Buyback:** The total number of tokens bought back to date.
* **Total Spent Amount:** The actual capital deployed by the project to repurchase tokens. When on-chain transactions linked to buyer addresses are known, we are able to compute this value.
* **Total Inflow Value:** The historical value of tokens repurchased (amount × price at the time of inflow into a buyback wallet).
* **Current Market Value:** Can be toggled from Total Inflow Value to see the current market value of tokens bought back to date.
* **Supply Offset (%):** The percentage that total buyback is of circulating or released supply.
* **Types / Sources / Precision**: The categorization of buyback type and where the funds to execute buybacks were sourced from, as well as how precise our data is. For more, see below.

These figures show how actively a project manages its supply and how impactful its buyback program is.

Below the overview, the **Buyback Chart** visualizes activity over time. You can toggle between:

* **Buyback Amount**, **Spent Amount**, **Value**, and **Price** metrics
* **Cumulative** or **Non-Cumulative** chart views
* Timeframes of **7D**, **1M**, **1Y**, or **All**

The **Buyback Table** lists the 10 most recent buyback events, aggregated daily, with details including date, token amount, USD spent, calculated value, and target address.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FS8bKmzlO6HQaHwTgaAPq%2Fusing-buyback.mp4?alt=media&token=4bd9b787-3086-4a10-a692-3328fb45911b>" %}

### **Buyback Type**

The **Buyback Type** tag shows *how* the buyback was executed.

| **Type**             | **Description**                                                                                                                                                |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Buyback & Burn**   | Tokens repurchased and immediately burned, permanently reducing supply.                                                                                        |
| **Treasury Buyback** | Direct token purchases from the open market (e.g., exchanges or liquidity pools) by the project treasury or foundation to rebalance reserves or retire supply. |

### **Buyback Source**

The **Source** tag indicates *where* the buyback funds come from, helping users understand sustainability.

| **Source**           | **Description**                                                                         |
| -------------------- | --------------------------------------------------------------------------------------- |
| **Revenue**          | Ongoing product or protocol revenue used to finance buybacks.                           |
| **Treasury**         | Capital drawn from the project’s treasury reserves or prior fundraising.                |
| **Protocol Fees**    | Fees collected from network or transaction activity (common in L1/L2 or DEX protocols). |
| **External Funding** | Non-recurring or external sources such as partnerships, grants, or investor funding.    |

Together, the **Basis**, **Type**, and **Source** tags give full context for each buyback event, showing not just *what* was bought, but *how*, *with what funds*, and *how verifiable* the data is.

### **Buyback Precision**

The **Buyback Precision** tag indicates how the data was obtained and how reliable it is, similar in spirit to [Precisions and Assumptions](/methodology/precisions-and-assumptions).

| **Basis**          | **Description**                                                                                             |
| ------------------ | ----------------------------------------------------------------------------------------------------------- |
| **On-chain Exact** | Verified through on-chain transactions with known buyer addresses and token transfers. Highest reliability. |
| **Reported**       | Disclosed by the project via public reports, blog posts, or announcements.                                  |
| **Estimated**      | Inferred from indirect data when explicit transaction records are unavailable.                              |

### **Spent Amount vs Inflow Value**

When tokens are transferred into a designated buyback wallet, this does not necessarily indicate that the project spent *token amount × price* at that moment. Buyback wallets often

* Receive tokens purchased in advance
* Aggregate funds for multiple purchases
* Conduct OTC deals at prices that differ from spot market rates.

The **Spent Amount vs Total Value** comparison highlights the efficiency of a project’s buyback strategy:

* **Spent Amount** shows the *actual* USD capital deployed, which is derived from on-chain transactions linked to known buyer addresses.
* **Inflow Value** represents the *calculated* market value of tokens repurchased (token amount × market price at the time of buyback).

A gap between the two indicates off-market purchases, OTC deals, or varying execution efficiency.

## **Why It Matters**

Buybacks provide a unique window into a project’s financial health and token management discipline:

* Consistent buybacks often signal confidence in the project or a good supply control policy.
* Buybacks remove tokens from circulation, reducing float and potentially supporting price stability.


# Burn

Analyze deflationary mechanisms of projects

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

The **Burn Page** provides an in-depth view of a project’s token burn activity. It captures every confirmed burn event and aggregates total value, supply offset, and underlying rationale, giving a clear picture of how deflationary mechanics operate across different projects.

<figure><img src="/files/1gOfZLOWqWxBzGMMPO4L" alt=""><figcaption></figcaption></figure>

## Accessing Burn Page

You can access the **Burn Page** by selecting any token from the **Burn Screener** or directly from its project profile.

Each Burn Page includes a **summary panel**, a **historical chart**, and a **burn event table**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2F2Cawe2EbENBS2erKjRLE%2Faccessing-burn.mp4?alt=media&token=e42ae9ea-7658-4dac-aeaa-b2f658be0531>" %}

## Using Burn

On the left you’ll see an overview summary of the burn information

* **Total Burn (USD)**: Total value of tokens burned across all burn events, denominated in USD.
* **Total Burn (Token)**: Total number of tokens permanently removed from supply.
* **Supply Offset**: The percentage of circulating (or released) supply offset by cumulative burns.
* **Burn Type**: Classification of the burn mechanism type and methodology.
* **Burn Reasons**: The primary rationale or purpose behind burn events.

The **Burn Chart** visualizes cumulative burns over time, overlayed with token price and burn value in USD.

You can toggle between **7D**, **1M**, **1Y**, or **All Time** views, and switch between **absolute** and **percentage** scaling for supply offset comparisons.

Hovering over the chart displays precise values for each date and cumulative totals. Below the chart, you’ll find a detailed table of all the latest 10 burn events.

Each row includes:

* **Date**: Timestamp of the burn event.
* **Burn Value (USD)**: USD value of tokens burned.
* **Burn Amount (Token)**: Quantity of tokens removed.
* **Burn Type**: Mechanism classification.
* **Burn Reason**: Context for the burn.
* **Source / Transaction**: Link to the originating on-chain transaction or record.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FbVJjWlVwwxREWlQRzlG1%2Fusing-burn.mp4?alt=media&token=2105f0df-c871-445c-af79-14a32fb3eaf3>" %}

## Burn Types

| **Type**             | **Description**                                                                                                                                                                                                 |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Programmatic**     | Burns that occur automatically according to protocol rules, such as fee burns, validator penalties, or on-chain logic. These are predictable and repeatable mechanisms embedded in the system’s design.         |
| **Non-Programmatic** | Burns executed manually or through discretionary decisions by the team, foundation, or community. Typically one-off or periodic, often based on governance votes, treasury decisions, or strategic adjustments. |

## Burn Reasons

| **Reason**           | **Description**                                                                                                                                            |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Governance**       | Burns decided through community or on-chain governance, such as proposals to reduce supply or allocate treasury funds to burn.                             |
| **Protocol Design**  | Burns that are an inherent part of how the protocol operates. For example, automatic burning of transaction fees or gas fees.                              |
| **Project Decision** | Burns initiated by the project’s core team or foundation, often as part of treasury management, tokenomics realignment, or discretionary supply reduction. |

## Why It Matters

Burns directly impact token scarcity and supply dynamics.

By tracking both **cumulative burn totals** and **burn rate trends**, you can assess whether a project’s deflationary design is structural, sustained, or symbolic.

This page helps investors and analysts understand:

* How much supply has been permanently removed.
* Whether burns are automatic or discretionary.
* How burns relate to price action and network activity.

## Where To Next?

* Compare across projects using the [Buyback Comparison](/features/buyback/buyback-comparison) page or [Burn Screener](/features/burn/burn-screener)


# Emission

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Crypto Market Emission</strong></td><td>Track token supply being released across the entire market</td><td><a href="/files/SBMuHHYpUhX8Vpd84OXc">/files/SBMuHHYpUhX8Vpd84OXc</a></td><td><a href="/pages/nHHQwSWmVZQWjekt2Nz7">/pages/nHHQwSWmVZQWjekt2Nz7</a></td></tr><tr><td><strong>Emission Comparison</strong></td><td>Visualize upcoming releases and market pressure across projects</td><td><a href="/files/liWYADWOqZ6J855s8WC4">/files/liWYADWOqZ6J855s8WC4</a></td><td><a href="/pages/bBInUIOiIVd6FlTHanHc">/pages/bBInUIOiIVd6FlTHanHc</a></td></tr><tr><td><strong>Emission Screener</strong></td><td>Scan emissions across every project and compare dilution risks at a glance</td><td><a href="/files/ysAkdRBEce0MsuHLBuJ9">/files/ysAkdRBEce0MsuHLBuJ9</a></td><td><a href="/pages/IlI8Rn5t7J4uVm7YKd8J">/pages/IlI8Rn5t7J4uVm7YKd8J</a></td></tr></tbody></table>


# Crypto Market Emission

Track token supply being released across the entire market

## Overview

**Crypto Market Emission** lets you track how much token supply is entering circulation across the entire crypto market. This gives you a clear sense of not just *when* tokens are being released, but also *how much value* is being released at any given time, allowing you to anticipate periods of higher dilution risk.

<figure><img src="/files/SBMuHHYpUhX8Vpd84OXc" alt=""><figcaption></figcaption></figure>

## Accessing Crypto Market Emission

You can open **Crypto Market Emission** directly from the sidebar. Once inside, you’ll see an interactive chart displaying the total market value of tokens unlocking over time. A toggle at the top lets you switch views between

* **Total Value Unlock**, which aggregates everything
* **Cliff Value Unlock**, which highlights cliff releases
* **Linear Value Unlock**, which filters only the steady drip of ongoing emissions.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FPx2ixW3WVV2a6pGZahLC%2Faccessing-crypto-market-emission.mp4?alt=media&token=a04d7173-d712-4fd5-bcfe-c3876a8841f6>" %}

## Using Crypto Market Emission

By default, emissions are shown in a **rolling 5-month window (+2 / –2 months)**, while **Pro users** can extend this to a **13-month horizon (+6 / –6 months)** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> for a broader outlook.

The chart can be viewed **weekly** or **monthly**, and toggled between **total value** or, on **Pro**, broken down by **individual** **tokens** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>. When grouped by tokens, tokens with unlocked values below a certain percentage of the total for each period are grouped into the '**Others**' category. For more details please see [below](#others-percentage-criteria).

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FPRI0tG7IAsVQ2Y4cJQG7%2Fcrypto-market-emission-chart.mp4?alt=media&token=04316fd2-31c2-49ea-819a-cfcd60c78adc>" %}

Beneath the chart, a table shows which tokens are driving emissions during the selected window. You can check unlocks for the current week or month, and compare them against **circulating supply**, **unlocked supply**, or **long-term supply through 2035**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FsWflP0h6x63mWWlCxsYh%2Fcrypto-market-emission-table.mp4?alt=media&token=6813d368-4c04-4d61-9f14-4db11785461b>" %}

**Filters** add another layer of context. Emissions can be narrowed to sectors such as AI, DeFi, Layer 1, or NFT tokens, while **Pro** accounts also filter by **allocation type** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>.

Finally, both the chart and table can be exported as **CSV files** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> so you can analyze the data in your own models.

## Why It Matters

Understanding market-wide emissions helps you anticipate when liquidity pressure may increase across the industry. A $100m unlock from one project may look large, but when seen as part of $2b in cumulative unlocks happening the same week, the bigger picture becomes clear.

## Others Percentage Criteria

When grouping the Crypto Market Emission chart by tokens, tokens with unlocked values below a certain percent of the total for each period are grouped into the '**Others**' category.

The thresholds for the **Others** cutoff are as follows

| Week   | 2M | 6M |
| ------ | -- | -- |
| All    | 2% | 3% |
| Cliff  | 3% | 5% |
| Linear | 1% | 1% |

| Month  | 2M | 6M |
| ------ | -- | -- |
| All    | 1% | 2% |
| Cliff  | 3% | 5% |
| Linear | 1% | 1% |

## Where To Next?

* See [Emission: Cliff, Linear](/methodology/emission-cliff-linear) to learn about how we categorize cliff and linear releases.
* Check out [Supply Metrics](/methodology/supply-metrics) to learn more about definitions of terms like circulating and unlocked supply.
* See how you can utilize [Emission Comparison](/features/emission/emission-comparison) and [Emission Screener](/features/emission/emission-screener) together with Crypto Market Emission.
* Learn more about [CSV Download](/features/csv-download) and where you can use it.


# Emission Comparison

Visualize upcoming releases and market pressure across projects

## Overview

Rather than looking at emissions in isolation or the overall state of the market in [Crypto Market Emission](/features/emission/crypto-market-emission), **Emission Comparison** lets you see multiple tokens side by side, compare their upcoming releases, and visualize how much pressure each project is facing relative to supply.

<figure><img src="/files/liWYADWOqZ6J855s8WC4" alt=""><figcaption></figcaption></figure>

## Accessing Emission Comparison

You’ll find **Emission Comparison** in the top navigation, next to [Crypto Market Emission](/features/emission/crypto-market-emission), or through the sidebar.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FsEBEVqz1mnki5qOc9ts9%2Faccessing-emission-comparison.mp4?alt=media&token=a7f5c616-2ea3-4e44-a212-455a5252ece6>" %}

When you open it, you’ll see three panes at the top:

* **Total Value Unlock** shows the combined value of all unlocks, regardless of type.
* **Cliff Value Unlock** isolates sudden one-time releases (e.g., team or investor cliffs).
* **Linear Value Unlock** highlights tokens that are gradually released over time.

## Using Emission Comparison

Start by choosing your timeframe: one **week**, one month, or extended horizons of **+6 months** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> or even **+1 year** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>. You can add any project for side-by-side comparison. By default, the top tokens are ranked by highest emission percentage.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FnN0dNygfOm04AYFXosm5%2Femission-analysis.mp4?alt=media&token=5f1555fe-0708-4c7f-9164-886298fb5032>" %}

You can choose to view emissions as percentages of **circulating supply** (reported by [CoinGecko](https://coingecko.com)) or by **unlocked supply** (the current released supply). Please see [Supply Metrics](/methodology/supply-metrics) to learn more about how we define various types of supply.

**Pro** users can also export all comparison data as a **CSV** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> for deeper analysis.

## Why It Matters

Emission Comparison is especially useful when you want to put projects in context.&#x20;

* A single token release might look large in absolute terms, but when compared against peers in the same sector, you may find it’s relatively small.&#x20;
* Likewise, two projects might both unlock $50m, but if one is 2% of supply and the other is 20%, the impact is very different.

## Where To Next?

* See [Emission: Cliff, Linear](/methodology/emission-cliff-linear) to learn about how we categorize cliff and linear releases.
* See how you can utilize [Crypto Market Emission](/features/emission/crypto-market-emission) and [Emission Screener](/features/emission/emission-screener) together with Emission Comparison.
* Learn more about [CSV Download](/features/csv-download) and where you can use it.


# Emission Screener

Scan emissions across every project and compare dilution risks at a glance

## Overview

**Emission Screener** provides a tabular overview of emissions across all projects in the market, making it easy to scan every project, compare values, and quickly identify which tokens are contributing the most supply at different time horizons.

<figure><img src="/files/ysAkdRBEce0MsuHLBuJ9" alt=""><figcaption></figcaption></figure>

## Accessing Emission Screener

You’ll find **Emission Screener** alongside Crypto Market Emission and Emission Comparison in the navigation bar, or through the sidebar. When opened, it defaults to **Total Value Unlock**, but you can also switch to **Cliff Value Unlock** or **Linear Value Unlock** for more specific views.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2Fm02DXSNXEVVg2J7xtW8y%2Faccessing-emission-screener.mp4?alt=media&token=bb126809-02e7-45f4-b363-b79578222847>" %}

## Using Emission Screener

The table shows unlock projections across multiple horizons: **+1 day, +7 days, +1 month,** and even up to **+6 months** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>**, and +1 year** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> **with Pro**.

Each column displays both the **absolute value in USD** and the **percentage relative to supply**. You can toggle whether these percentages are calculated against **circulating supply**, **unlocked supply**, or the **2035 supply baseline**. Please see our [Supply Metrics](/methodology/supply-metrics) to learn more about how we define different types of supply.

Filters let you refine the view by **sector** (AI, DeFi, RWA, Layer 1, etc.), or with **Pro**, by **allocation type** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>. The table is fully searchable, sortable by value or percentage, and **for Pro users** all data can be exported to **CSV** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> for custom analysis.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FmL4PqBpK7n9dOR55w5rC%2Femission-screener.mp4?alt=media&token=6be9afdf-bca2-437d-88de-455bcfd94b35>" %}

## Why It Matters

The screener makes it simple to identify which projects are facing near-term dilution pressure, and how those compare across categories. You can see at a glance whether emissions are concentrated in the next week, spread evenly over a year, or dominated by a single sector.

**Pro users** gain deeper filters and allocation-level insights, turning the screener into a powerful tool for both quick scans and detailed workflows.

## Where To Next?

* See [Emission: Cliff, Linear](/methodology/emission-cliff-linear) to learn about how we categorize cliff and linear releases.
* Check out [Supply Metrics](/methodology/supply-metrics) to learn more about definitions of terms like circulating and unlocked supply.
* See how you can utilize [Emission Comparison](/features/emission/emission-comparison) and [Crypto Market Emission](/features/emission/crypto-market-emission) together with the Emission Screener.
* Learn more about [CSV Download](/features/csv-download) and where you can use it.


# Allocation

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Allocation Comparison</strong></td><td>Compare token distribution across projects to see who holds supply</td><td><a href="/files/qWFPJ5lxIvWW2gpSMbns">/files/qWFPJ5lxIvWW2gpSMbns</a></td><td><a href="/pages/MkHsIdGvxPtdcwfLuyJ3">/pages/MkHsIdGvxPtdcwfLuyJ3</a></td></tr><tr><td><strong>Allocation Screener</strong></td><td>Scan token allocations across the entire market</td><td><a href="/files/Kf7k5Auv5lv8rnaWwCZC">/files/Kf7k5Auv5lv8rnaWwCZC</a></td><td><a href="/pages/E9VxQajt9mZKNcCwVeIh">/pages/E9VxQajt9mZKNcCwVeIh</a></td></tr></tbody></table>


# Allocation Comparison

Compare token distribution across projects to see who holds supply

## Overview

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

**Allocation Comparison** lets you compare how different projects distribute their tokens across key stakeholder groups. Instead of looking at one project in isolation, you can line up multiple tokens side by side and compare how they have structured their stakeholder allocations.

This feature uses Tokenomist’s [Standard Allocations](/methodology/standard-allocations) framework, ensuring every project is classified in a consistent way.

<figure><img src="/files/qWFPJ5lxIvWW2gpSMbns" alt=""><figcaption></figcaption></figure>

## Accessing Allocation Comparison

You’ll find **Allocation Comparison** under the Allocation tab in the navigation bar, or through the sidebar. When opened, you can add any tokens to the comparison pane. Each project will appear with its supply broken down by allocation category.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FClXXwfF6qYwghGTFACan%2Faccessing-allocation-comparison.mp4?alt=media&token=80dd3590-d79c-40e2-854b-bdb07f01b980>" %}

## Using Allocation Comparison

At the top, you can toggle between **Unlocked**, **Locked**, or **Total** supply distribution. You can also switch between **percentage view**, **absolute USD value**, or a **stacked bar layout** for easier cross-project comparison.

The chart can also be grouped both **by token** or **by allocation** for easier comparison across categories.

Each bar is color-coded by allocation type, and can be toggled at the bottom of the bottom of the component. The **striped section** of a bar represents **TBD allocations**: tokens that don’t yet have a defined release schedule. For details on how TBD is handled, see [TBD Locked](/methodology/tbd-locked).

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FYunpsDU81MBFiPmIpmHZ%2Fallocation-comparison.mp4?alt=media&token=a6ea0db9-5a28-44c0-a545-cb2af58ca0b3>" %}

## Why It Matters

Allocation structures tell you who controls a project’s supply and where future selling or governance power may come from. A project with a heavy investor allocation looks very different from one dominated by community or ecosystem reserves.

By comparing multiple tokens side by side, you can quickly see which projects are founder heavy, investor heavy, or more community driven, and build a clearer picture of risk and alignment.

## Where To Next?

* See [Standard Allocations](/methodology/standard-allocations) to learn our methodology for classifying allocations.
* Check out [Supply Metrics](/methodology/supply-metrics) to learn more about definitions of terms like circulating and unlocked supply.
* See [TBD Locked](/methodology/tbd-locked) to learn more about how we tackle unpredictable release events.
* Learn more about how to use [Allocation Screener](/features/allocation/allocation-screener) in parallel with Allocation Comparison.


# Allocation Screener

Scan token allocations across the entire market

## Overview

**Allocation Screener** gives you a market-wide, tabular overview of how projects allocate their tokens. Instead of analyzing one project at a time, you can scan the entire market and compare supply distribution across stakeholder groups standardized through Tokenomist’s [Standard Allocations](/methodology/standard-allocations).

<figure><img src="/files/Kf7k5Auv5lv8rnaWwCZC" alt=""><figcaption></figcaption></figure>

## Accessing Allocation Screener

You’ll find **Allocation Screener** under the Allocation tab, next to Compare Allocation, or through the sidebar. It opens by default in **Total supply** view, but you can switch to **Unlocked** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> or **Locked** <i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i>.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FnE5K94oSvl2ZsXwPboML%2Faccessing-allocation-screener.mp4?alt=media&token=03aaac8d-8437-49ec-a09b-b49ae12d72b8>" %}

## Using Allocation Screener

The table lists projects row by row, with allocation categories shown as columns. For each category, you’ll see both the **percentage of total supply** and the **value in USD**.

Filters at the top allow you to narrow results by sector (AI, DeFi, L1, L2, etc.), and with **Pro** you can toggle between unlocked, locked, and total distributions. The table is sortable by percentage or value, and fully searchable.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FampKHRDu1u9OFcT4xUOJ%2Fallocation-screener.mp4?alt=media&token=2101d1c1-fc95-424b-91c5-92d71c2ad9d8>" %}

## Why It Matters

Allocation Screener lets you compare the *structure* of projects at scale. Two projects may have the same emissions outlook, but if one is dominated by private investors while another leans heavily toward community, the long term incentives and risks look very different.

## Where To Next?

* See [Standard Allocations](/methodology/standard-allocations) to learn our methodology for classifying allocations.
* Check out [Supply Metrics](/methodology/supply-metrics) to learn more about definitions of terms like circulating and unlocked supply.
* Learn more about how to use [Allocation Comparison](/features/allocation/allocation-comparison) in parallel with Allocation Screener.


# Fundraising Screener

Track fundraising data and investor context, all in one view

## Overview

**Fundraising Screener** provides a market wide table of how crypto projects have raised capital. It consolidates investor participation, amounts raised, unlock status, and valuation context, so you can compare fundraising across the industry at a glance.

<figure><img src="/files/eJg56mta4QIBFLaItTrF" alt=""><figcaption></figcaption></figure>

## Accessing Fundraising Screener

You’ll find **Fundraising Screener** in the Fundraising tab on the Sidebar. Each row represents a project, with key fundraising and investor metrics displayed side by side. Clicking on a project opens its [Fundraising](/features/token-page/fundraising) pane, where you can explore round-by-round details and investor allocations.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FqRQPgXjTs83w7UHdQyIq%2Faccessing-fundraising-screener.mp4?alt=media&token=1010674e-cb6d-41bf-ab73-4fc15c9628b6>" %}

## Using Fundraising Screener

The table includes:

* **Lead Investors** and the **number of participants** in funding rounds.
* **Total Raised**, showing cumulative funding in USD.
* **Unlocked Investors** and **% unlocked**, indicating how much investor allocation is liquid.
* **Latest Round**, listing the most recent funding stage (Seed, Private, Public, Strategic).
* **Market Cap (MCAP) vs Fully Diluted Valuation (FDV)**, letting you compare present valuations to historical fundraising.

**Filters** across the top (AI, DeFi, Layer 1, RWA, etc.) let you narrow results by sector, and the table can be sorted by any column.

In some cases, the lead investor or investor allocations may be unclear, in which case some of these fields may be denoted by a “—”.

## Why It Matters

Fundraising history provides critical context for token supply. A project that raised heavily through private rounds may face different risks than one supported by public token sales.

By scanning the **Fundraising Screener**, you can quickly:

* Benchmark projects by capital raised.
* Spot which investors dominate early rounds.
* Gauge whether investor allocations are liquid or still vesting.
* Compare funding scale against current valuation (MCAP / FDV).

For deeper context, click into a project’s **Fundraising page** [Fundraising](/features/token-page/fundraising) to view its full funding history, valuation by round, and detailed investor participation.

## Where To Next?

* See more about individual tokens’ fundraising pages at [Fundraising](/features/token-page/fundraising).


# On-Chain Claims

Follow tokens from release to circulation

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

Tokenomist’s **On-Chain Claims** provides a precise view of how token supply actually enters circulation after unlocks.

In many cases, when tokens unlock, they don’t automatically circulate. Many remain in vesting or internal wallets until claimed by beneficiaries. By tracking on-chain activity for known vesting wallets, we surface the *real* amount of tokens entering circulation. This data is continuously updated on a daily basis.

Our goal is to bring greater transparency to token supply and vesting by showing not just what is unlocked, but what has truly been claimed and moved into the market.

<figure><img src="/files/CdplUOQUa61YoewEjyze" alt=""><figcaption></figcaption></figure>

## Accessing On-Chain Claims

You can access **On-Chain Claims** from the sidebar. This opens a table of supported tokens along with their most recent claim data.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FbSxtjEmzyCyoByVegnqt%2Faccessing-onchain-claims.mp4?alt=media&token=e3e058ee-5de0-46a3-8719-22db134cc439>" %}

You can also reach a token’s Claims page directly by visiting its [Token Page](/tokenomist/token-page) and selecting the **Claimed** tab.

## Using On-Chain Claims

At the top of the page you'll see

1. **Total Unlocked Supply**: the number of tokens that have unlocked, based on our vesting data.
2. **Total Claimed**: the cumulative amount of tokens that have been claimed, i.e., transferred out of **known** vesting/internal wallets into beneficiary wallets.

Below this, you’ll find a **sankey diagram** of the top 10 claimers — the beneficiaries who have received the largest amounts of tokens from vesting wallets.

* You can filter this by timeframe to understand claim activity in context.
* Clicking on a claimer reveals their address, the total amount and value of tokens claimed, and a full transaction history (including token prices at the time of claim).

{% hint style="danger" %}
It is possible for the tracked total claim amount to exceed total unlocked amount due to unlabeled or unidentified internal / operational transfers by the token project.
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FdLTRlCCE0kwGzi9ymGgi%2Fonchain-claims.mp4?alt=media&token=346e4bfa-b66d-4dbe-a33f-4b458dc8c85a>" %}

### On-Chain Claims in Release Schedules

On-Chain Claims can also be layered onto a token’s **Release Schedule**.

1. On the token’s overview page, click **Add Metric** above the Release Schedule.
2. Select **Claim**, then click **Save**.

This lets you compare *actual claimed supply* against the projected unlock schedule.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2Fb7XLex4ePgplPedCoLxl%2Fonchain-claims-overlay.mp4?alt=media&token=da5b7154-a00c-4503-8835-6ccbec9c01df>" %}

## Claim FAQs

### How are internal wallets identified?

We identify vesting and internal wallets using:

* **Project disclosures**: team allocations, foundation wallets, or addresses published in docs/announcements.
* **On-chain heuristics**: transaction patterns, clustering, funding sources.
* **Direct verification**: where possible, we confirm with project teams directly.

Once identified, we monitor these wallets. Outflows from them into external wallets are classified as **claims**.

### How often is claim data updated?

Claim data is refreshed **daily**. We continuously track on-chain transfers, tag them against our database of vesting wallets, and update cumulative claim totals.

### What’s the difference between released, claimed, and circulating supply?

See our [Supply Metrics](/methodology/supply-metrics) page, but in short:

* **Released supply**: Tokens that have passed their release schedule.
* **Claimed supply**: Released tokens actually withdrawn from vesting wallets.
* **Circulating supply**: A broader market metric, which includes claimed tokens plus other liquid tokens available for trading.

## Supported Tokens

As of **15 September 2025**, On-Chain Claims supports the following tokens:

1. [1inch](https://tokenomist.ai/1inch/claim)
2. [ApeCoin](https://tokenomist.ai/apecoin/claim)
3. [Arbitrum](https://tokenomist.ai/arbitrum/claim)
4. [Axie Infinity](https://tokenomist.ai/axie-infinity/claim)
5. [BitDAO](https://tokenomist.ai/bitdao/claim)
6. [Blur](https://tokenomist.ai/blur/claim)
7. [Ethena](https://tokenomist.ai/ethena/claim)
8. [Ethereum Name Service](https://tokenomist.ai/ethereum-name-service/claim)
9. [SpaceID](https://tokenomist.ai/space-id/claim)
10. [Illuvium](https://tokenomist.ai/illuvium/claim)
11. [ImmutableX](https://tokenomist.ai/immutable-x/claim)
12. [Chainlink](https://tokenomist.ai/chainlink/claim)
13. [Liquity](https://tokenomist.ai/liquity/claim)
14. [Polygon](https://tokenomist.ai/matic-network/claim)
15. [Optimism](https://tokenomist.ai/optimism/claim)
16. [Pendle](https://tokenomist.ai/pendle/claim)
17. [The Sandbox](https://tokenomist.ai/the-sandbox/claim)
18. [XAI](https://tokenomist.ai/xai-blockchain/claim)

## Where To Next?

* See how you can use Claims in conjunction with other metrics on the [Token Page](/features/token-page).


# Buyback


# Buyback Comparison

Compare buybacks across projects.

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

**Buyback Comparison** lets you compare how different projects conduct and scale their token buyback programs.

Instead of viewing a single project’s activity in isolation, you can line up multiple tokens side by side and evaluate the magnitude, consistency, and impact of their buybacks.

<figure><img src="/files/HMqPYqLTCWsmW5IhkgZV" alt=""><figcaption></figcaption></figure>

## Accessing Buyback Comparison

You’ll find **Buyback Comparison** under the **Buyback** tab in the navigation bar, or through the sidebar. When opened, you can add any tokens with buyback to the comparison pane.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FksEhurRZC3swKhm33G0m%2Faccessing-buyback-comparison.mp4?alt=media&token=eae5cf47-bc4d-408c-ac08-23e9a3cbabfa>" %}

## Using Buyback Comparison

At the top, you can toggle between viewing **Total Value**, **% of Circulating Supply**, or **% of Released Supply**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FoXprUDAXNZiOjB6K7F0c%2Fusing-buyback-comparison.mp4?alt=media&token=2b98085d-7903-458e-892b-4563401a43fd>" %}

Hovering over any segment reveals the breakdown of released supply impact, buyback amount, and buyback value.

## Why It Matters

Buybacks play a key role in shaping a token’s long-term supply dynamics and value accrual. A project that consistently conducts buybacks demonstrates stronger alignment between token utility, protocol revenue, and holder value.

By comparing multiple tokens side by side, you can quickly see which projects are more aggressive in buybacks, which tie them to on-chain revenue.

## Where To Next?

* See our [Buyback](/features/token-page/buyback) page for a more indepth look at project buyback mechanisms
* See the [Buyback Screener](/features/buyback/buyback-screener) for a full list of tokens with buyback


# Buyback Screener

Track buyback across projects

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

**Buyback Screener** provides a tabular overview of all tracked projects with active or historical buyback programs.

It allows you to sort and analyze tokens by their total buyback volume, frequency, or intensity relative to supply.

## Accessing Buyback Screener

You’ll find **Buyback Screener** under the **Buyback** tab in the sidebar.

The table lists every token with detected or reported buybacks, showing key metrics such as:

* **% of Released Supply**: Total buyback value as a share of released supply.
* **Total Buyback Value**: The cumulative USD value of all buybacks to date.
* **Last Buyback**: Timestamp of the most recent confirmed buyback event.
* **30D Buyback Value**: Total value of buybacks in the last 30 days.
* **Buyback Types**: Methods used (e.g. Treasury Buyback, Repurchase, Fee Burn).
* **Buyback Sources**: Funding origins (e.g. Protocol Fees, Treasury, Revenue).

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FgA1UszvdDmPifejyqzX9%2Faccessing-buyback-screener.mp4?alt=media&token=195ecc5f-f660-4c7c-87aa-7fa80c797848>" %}

## Using Buyback Screener

You can sort any column by clicking its header, or filter results using the search bar to locate specific tokens or buyback sources. Projects can also be added directly to your [Watchlist](/features/watchlist) for ongoing monitoring.

Clicking a token name opens its detailed [Buyback](/features/token-page/buyback) page, showing time-series data, burn linkage, and source breakdowns.

<figure><img src="/files/R8Vv2Ox3AUwmSxDZXzug" alt=""><figcaption></figcaption></figure>

## Why It Matters

The **Buyback Screener** highlights which projects are actively reducing supply, which are sustaining long-term buybacks, and which rely on organic revenue versus treasury reserves.

By scanning multiple projects at once, you can identify leaders in protocol value accrual, spot emerging trends, and benchmark buyback effectiveness across ecosystems.

## Where To Next?

* See [Buyback Comparison](/features/buyback/buyback-comparison) to compare total buyback strength across multiple projects visually.
* Learn more about the [Buyback](/features/token-page/buyback) page.


# Burn


# Burn Comparison

Compare burn across projects

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

**Burn Comparison** lets you compare how different projects conduct and scale their token burn programs.

Instead of looking at a single token in isolation, you can line up multiple projects side by side to understand the total size and frequency of their burn activity.

<figure><img src="/files/nCaW04tKANAKA4eesOR0" alt=""><figcaption></figcaption></figure>

## Accessing Burn Comparison

You’ll find **Burn Comparison** under the **Burn** tab in the sidebar.

When opened, you can add any tokens to the comparison pane. Each project will appear as a chart, with total burn value or token amount visualized across comparable metrics.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2F2EWtzUt0XQk2AUWcjXgo%2Faccessing-burn-comparison.mp4?alt=media&token=3c3fe5e1-f97b-4fb3-a7fd-4d5786109984>" %}

## Using Burn Comparison

At the top, you can toggle between:

* **Total Burn Value (USD)**: Cumulative value of all burned tokens.
* **% of Circulating Supply**: Portion of current circulating supply permanently removed.
* **% of Released Supply**: Portion of total released supply offset by burns.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FRuQL1lpHqMJJlTXZyNDC%2Fusing-burn-comparison.mp4?alt=media&token=307b0fb3-4736-4643-81ba-675973090396>" %}

Hovering over any bar displays more information.

## Why It Matters

Burn mechanisms are a key deflationary force that influence token supply and long-term value.

By comparing multiple projects, you can identify which tokens have consistent, structural burn mechanisms versus those relying on one-off events or governance-driven actions.

## Where To Next?

* Explore the [Burn](/features/token-page/burn) page for in-depth project-level burn data.
* Use [Burn Screener](/features/burn/burn-screener) to filter tokens by burn type or value.


# Burn Screener

Track burn across projects

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

**Burn Screener** gives you a table view of all tracked token burns, letting you sort, search, and filter across tokens with burn.

It’s ideal for quickly identifying which projects have the highest burn rates, how recently burns occurred, and whether burns are programmatic or manually triggered.

## Accessing Burn Screener

You can find the **Burn Screener** tab in the Sidebar under Burn.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FUN6Yn3XQY1G7DCul3Kr1%2Faccessing-burn-screener.mp4?alt=media&token=ec192383-83ce-4c14-9b69-679929ebc901>" %}

## Using Burn Screener

The screener table includes the following key columns:

| Column                   | Description                                              |
| ------------------------ | -------------------------------------------------------- |
| **Token**                | Token name and symbol, with logo for quick recognition.  |
| **% of Released Supply** | Portion of total released supply permanently burned.     |
| **Total Burn Value**     | Lifetime value of all burned tokens, denominated in USD. |
| **Last Burn**            | Timestamp of the most recent burn event.                 |
| **30D Burn Value**       | Total value burned in the last 30 days.                  |
| **Burn Types**           | Classification of burn mechanism (see below).            |
| **Burn Reasons**         | Explanation for why the burn occurred (see below).       |

You can also add tokens to your [Watchlist](/features/watchlist) for ongoing burn tracking, search for tokens by name or symbol, and sort any column (e.g., by Total Burn Value or % of Supply Burned).

<figure><img src="/files/K7p6qajH26k17OFsujBH" alt=""><figcaption></figcaption></figure>

## Where To Next?

* Use [Burn Comparison](/features/burn/burn-comparison) for cross-project visual comparisons.
* Learn more about our [Burn](/features/token-page/burn) feature and methodology.


# CSV Download

Export charts and tables into CSV files for flexible offline analysis

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

**CSV Export** gives you direct access to Tokenomist’s core datasets in raw, structured format. You can download token supply schedules, allocation breakdowns, emission forecasts, and valuation metrics, then integrate them directly into Excel, Python scripts, or portfolio tools.

This removes the need for manual data entry and ensures faster, cleaner, and more consistent analysis across your workflows.

## Available Datasets

| **.csv Dataset**                                                                      | **Free, Legacy Essential**\*, **Legacy Pro**\*\* | **Current Pro**                                                                           | **Standard API**                                                                                               | **Elite API**                                                                                                 |
| ------------------------------------------------------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| [Total Value Unlock](https://tokenomist.ai/emission/crypto-market)                    | ❌                                                | ✅                                                                                         | ✅                                                                                                              | ✅                                                                                                             |
| [Token Unlocks Dashboard](https://tokenomist.ai/)                                     | ❌                                                | ✅                                                                                         | ✅                                                                                                              | ✅                                                                                                             |
| [Emission Screener List](https://tokenomist.ai/emission/screener)                     | ❌                                                | ✅                                                                                         | ✅                                                                                                              | ✅                                                                                                             |
| [All Release Events (each token)](https://tokenomist.ai/ethena/unlock-events)         | ❌                                                | ✅                                                                                         | ✅                                                                                                              | ✅                                                                                                             |
| [Allocation (each token)](https://tokenomist.ai/ethena/tokenomics)                    | ❌                                                | ✅                                                                                         | ✅                                                                                                              | ✅                                                                                                             |
| [Float & FDV Competitor Comparison](https://tokenomist.ai/ethena/competitor-analysis) | ❌                                                | ✅                                                                                         | ✅                                                                                                              | ✅                                                                                                             |
| [Vesting chart (each token)\*\*\*](https://tokenomist.ai/ethena)                      | ❌                                                | <p></p><ul><li>Historical 1Y</li><li>Future 1Y</li><li>Monthly granularity only</li></ul> | <p></p><ul><li>Historical 1Y</li><li>Future 2Y</li><li>Daily,Weekly ,Monthly granularities available</li></ul> | <p></p><ul><li>Historical 2Y</li><li>Future 3Y</li><li>Daily,Weekly,Monthly granularities available</li></ul> |

{% hint style="warning" %}

* \*Former Essential plan users must upgrade to **Current Pro** to enable CSV export.
* \*\*Pro users subscribed before April 22, 2025 must upgrade to **Current Pro** for CSV access.
* Only scheduled release chart data is included; TBD allocations excluded until clarified by projects.
  {% endhint %}

## Using CSV Download

To use CSV Export, navigate to the dataset you’re interested in and apply the timeframes or filters you want. Once the view reflects your chosen parameters, simply click the **.csv** button to download the file.

<figure><img src="/files/JGoCXGE7InlXKykLeEGw" alt=""><figcaption></figcaption></figure>

## Why It Matters

CSV Export turns Tokenomist from a dashboard into a **data backbone**. Analysts can run their own models, funds can apply internal risk criteria, and developers can integrate tokenomics data directly into pipelines. With granular supply, allocation, and emission datasets available, your analysis stays both flexible and consistent.


# Updates

Stay ahead with every tokenomics change

## Overview

The **Updates** page keeps Tokenomist’s dataset accurate and transparent by showing a live feed of tokenomics changes across projects. Whenever a project updates its token tokenomics, or we correct or expand our data, those changes are recorded here for all users to see.

This ensures you’re always working with the most up to date supply data, and you can trace exactly when and why a dataset changed.

<figure><img src="/files/YSCQsSaxZyJ8wZOmZQCh" alt=""><figcaption></figcaption></figure>

## What Gets Updated

We continually update projects when

1. **Data corrections are required**: for example, when corrections in supply, allocations, or release schedules are required.
2. **Tokenomics updates are made by the project**: such as governance-approved changes, new vesting terms, or adjustments to allocation design.
3. **TBD allocations receive release logs**: when projects provide clarity on previously unassigned tokens. These specifically update **TBD allocations**. See [TBD Locked](/methodology/tbd-locked) for more on how we handle these cases.

## Using Updates

Each entry shows:

* The **project name** and the **date of update**.
* A short description of the change, with direct references to sources (e.g., governance forums, official announcements).
* A link to the full project page so you can review the updated tokenomics in context.

By scrolling through Updates, you can quickly spot which projects recently changed and what those changes mean for circulating supply, unlock schedules, or allocation distributions.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FcHpeD35yJ0hPZyxK8HNd%2Faccessing-updates.mp4?alt=media&token=3c79d5b6-6678-4595-b5f2-56f8cd501cea>" %}

## Why It Matters

Tokenomics data is not static. Projects frequently revise vesting, add new allocations, or clarify release timing. By tracking these updates in one place, Tokenomist ensures you don’t miss critical changes that can affect valuation models, supply forecasts, or investment decisions.

## Where To Next?

* Learn more about how we update [TBD Locked](/methodology/tbd-locked) allocations when more information is made available.


# Watchlist

Keep tabs on the tokens you care about

## Overview

The **Watchlist** lets you track the projects that matter most to you across Tokenomist. Once a project is added, it becomes a filter you can use in multiple parts of the platform.

## Accessing Watchlist

You can create and manage your Watchlist from the sidebar.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2F6zDR4IfxUZN4JagBpu7x%2Fwatchlist.mp4?alt=media&token=6ba96bb6-45f0-40fa-9098-2b45b4b7f504>" %}

Projects can be added to your Watchlist anywhere you see the star icon — for example, on a token page or in a table. Once added, those tokens are automatically available as a **Watchlist filter** in three key areas of Tokenomist:

1. **Token Unlocks Page**: filter unlock charts and tables to only show your Watchlist tokens.

   <figure><img src="/files/Q2YF9MSKFrF9RZDlZXft" alt=""><figcaption></figcaption></figure>
2. **Fundraising Screener**: check how projects you care about have raised capital.<br>

   <figure><img src="/files/eJg56mta4QIBFLaItTrF" alt=""><figcaption></figcaption></figure>
3. **WenUnlocks (Trading Mode)**: focus trading signals and unlock alerts around the projects you follow.

   <figure><img src="/files/VG4uruCQQkd6EtRjx9v2" alt=""><figcaption></figcaption></figure>

## Using Watchlist

After adding projects, select **“Watchlist”** in the filter bar. This instantly narrows the view to just your chosen tokens, whether you’re viewing Token Unlocks, Fundraising, or WenUnlocks.

Your Watchlist stays synced across the platform, so once a token is added in one place, it will be available everywhere. You can edit your Watchlist at any time, adding new projects as they emerge, or removing those you no longer need to monitor.

## Why It Matters

The watchlist gives you a personalized filter, so you always see the unlocks, raises, and trading events that matter most to you.

Traders use it to stay focused on a handful of tokens. Researchers use it to track specific ecosystems or categories. Investors use it to keep an eye on portfolio companies.

## Where To Next?

* Check out the [Token Unlocks](/features/token-unlocks)page, [Fundraising Screener](/features/fundraising-screener) or [WenUnlocks](https://tokenomist.ai/wenunlocks) to see what you can do with your watchlist.


# AI Insights

AI-powered explanations for tokenomics data

## Overview

AI Insights add an explanatory layer on top of Tokenomist’s structured data. Instead of scanning numbers and charts in isolation, AI Insights aims to help you immediately understand the main patterns and implications of the data.

<figure><img src="/files/Pkps0JLQuikYqQPssUNK" alt=""><figcaption></figcaption></figure>

## Accessing AI Insights

The feature is embedded directly into supported components. Clicking the sparkle icon ✨ reveals a sidebar containing a tailored summary. Each write-up corresponds to the data in front of you. Once open, you can read the narrative and go view the chart itself for more details.

## Using AI Insights

Every summary is generated automatically and refreshes whenever the underlying dataset changes. At the bottom of the panel you’ll see a **“Last updated” timestamp**, so you always know when the insight was last refreshed.

You can mark an insight as helpful or unhelpful with a simple **thumbs up** or **thumbs down**, and can also **submit questions** you would like to see answered. Over time, this feedback loop helps refine and expand the quality of insights delivered.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FLtYGUfw5mTPMKaUyhMDW%2Fai-insights.mp4?alt=media&token=c6154c67-681d-45b5-a0be-a1ed75de98c8>" %}

{% hint style="warning" %}
AI Insights are **experimental** and s**hould not be mistaken for financial advice**. They are designed to highlight key takeaways and trends, but decisions should always be confirmed against the raw data. As the feature develops, coverage will expand into more categories and include a wider set of components.
{% endhint %}

Currently, coverage focuses on the **Top 300 tokens in the All category**, giving a broad overview of market activity.

## Why It Matters

Crypto emission and unlock data can be dense, and it isn’t always obvious what matters most. AI Insights can help translate complex market events into a digestible summary. With just one click, you can move from raw numbers to clear understanding.


# Token Listing Process

The processes and methodologies behind our token listing process

Tokenomist’s token coverage is curated with accuracy and transparency in mind. Every token goes through a clear process of criteria checks, data collection, and a final review before being published.

We use a combination of manual research, AI-driven analysis, and project collaboration to ensure the data we display is both reliable and up to date.

## Listing Criteria

Before any token is considered for listing, it must meet a basic set of criteria:

* **Verifiable vesting or release schedules**, in the form of publicly accessible official docs, announcements, or smart contracts, etc.
* **Sufficient market presence** through exchange listings, liquidity, or established community.
* **Relevance to Tokenomist users**, such as tokens with medium to high market cap or by user request

Additionally, **listing priority is determined internally at the discretion of employees only**. These criteria ensure we focus on tokens where supply and tokenomics data have real market impact.

## Listing Methods

Below are the primary ways tokens are added to our platform:

### Human Listings

Our data team manually verifies and adds new tokens on an ongoing basis. This involves a member of our team

* **Reviewing** official project documentation (whitepapers, blog posts, governance forums).
* **Cross-referencing** with on-chain data and trusted third-party sources.
* In many cases, **reaching out** to confirm or request details from token project teams.

Manual listings are especially important for high-profile projects, where accuracy and transparency are critical. Each listing is **triple-checked for accuracy**, and only after approval is it published on the platform.

We aim to list tokens with verifiable references acquired from official sources that contain **accurate**, **up to date tokenomics**. A listing **may be reconsidered if it contains vague or incomplete tokenomics, contradictory information**, or provides vesting in **a format that cannot be reliably extracted**.

As part of our data policy, our data team will reach out to token projects before any big unlocks to reverify our release schedule with them. It is at the discretion of these projects to respond to our inquiries.

### AI-Assisted Listings

AI is used to accelerate the discovery and structuring of tokenomics data, but **it does not replace human review**. Its role is to make the process more efficient and ensure no project with available information is overlooked.

AI tools help us surface and structure new data faster by

* **Scanning** announcements and sources for vesting details.
* **Extracting** allocations into a structured format.
* **Highlighting** inconsistencies for human follow-up.

**AI never lists tokens automatically**. We validate the data, confirms details against official sources, and approves the token before it goes live. This ensures AI speeds up the process without compromising data quality or trustworthiness.

Tokens listed by AI will be labeled as such on their token pages.

### Self-Listing (For Projects)

Projects can also self-list by submitting tokenomics and release data directly to Tokenomist. This ensures the most accurate and timely information is published.

When submitting, teams are asked to provide:

* **Detailed vesting schedules** and **allocation breakdowns**.
* **Relevant wallet addresses** for verification purposes.
* Any **supplementary documentation** that supports the provided data.

Our data team then

* **Verifies** the submission against publicly data (where possible).
* **Checks** for clarity, consistency, and completeness.
* **Standardizes** the information to align with Tokenomist’s frameworks.

Even though the data comes directly from projects, **all self-submitted listings are audited by our data team before publication**. If inconsistencies are found, our team will work with the project to resolve them before the listing goes live.&#x20;

**Tokenomist reserves full discretion over which projects are listed**. We do not support or promote scam tokens, and any project failing to meet our standards for accuracy, legitimacy, or transparency will not be published.

### Summary

| Method           | Data Source                                   | Review Process                                        | Who’s Involved      |
| ---------------- | --------------------------------------------- | ----------------------------------------------------- | ------------------- |
| **Criteria**     | Public docs, contracts, announcements         | Checked against requirements and reviewed before live | Data Team           |
| **Manual**       | Researcher-collected (docs, forums, on-chain) | Drafted + peer-reviewed by another researcher         | Data Team           |
| **AI-Assisted**  | AI parses announcements and structures data   | Validated by researcher, compared to official sources | AI + Data Team      |
| **Self-Listing** | Project teams submit tokenomics and wallets   | Verified and approved by data team                    | Project Team + Data |

## Request a token

To request a token to be listed on our website, please head over to our [official forum](https://feedback.tokenomist.ai/b/token-requests/) and submit a token request there!


# Standard Allocations

Normalizing tokenomics for easy, cross-project analysis

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

Token allocation data is often inconsistent, with projects using non-standard labels for dozens of different allocations. A "Strategic Sale," "Seed Round," and "Private Sale" might be functionally identical, yet they are listed separately. This makes direct, cross-project comparison difficult and time-consuming.

Tokenomist solves this problem by normalizing tokenomics data into **six distinct Standard Allocations**. We group allocations based on their actual purpose and beneficiaries for reliable comparative analysis.

***

## Methodology

| **Tokenomist Standard Allocation** | **Definitions**                                                                                                                                    | **Examples**                                                                                                                                                        |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Founder / Team                     | The allocations for a group of people who has the most ownership and responsibility to drive business and product                                  | Founder, Team, Advisors, Core Contributors, Future Employees                                                                                                        |
| Private Investors                  | Allocations for entities that provide capital in investment rounds that are not publicly accessible, often at a lower valuation.                   | Strategic Round, Series A, Series B, Angel Investor VC                                                                                                              |
| Public Investors                   | Investment offerings by the general public through launchpads or exchanges, typically providing immediate market liquidity.                        | Whitelist IDO (Initial Dex Offering), ICO (Initial Coin Offering), ILO (Initial Liquidity Offering), IEO (Initial Exchange Offering), Crowdsale Launchpad, Coinlist |
| Reserved                           | A strategic reserve whose purpose are not clearly stated or held by foundations or DAOs for future operational expenses and ecosystem initiatives. | Foundation, Treasury, Ecosystem, Marketing, Non-profit foundation, Ecosystem grants, Reserves                                                                       |
| Community                          | Incentives designed to bootstrap the network and reward community members for active participation.                                                | Airdrop, Liquidity mining, Staking, Rewards, Bounty programs, Contests, Initial LP                                                                                  |
| Other                              | Any allocation that does not fit into the other standard categories.                                                                               | Mixed allocations                                                                                                                                                   |

### Practical Examples: How We Categorize Ambiguous Labels

#### **Example 1: "Core Contributors" vs. "Team"**

* **Scenario:** A project's allocation chart shows 15% for "Core Contributors" but has no mention of a "Team" allocation.
* **Analysis:** Many decentralized projects, especially those managed by a foundation, avoid corporate-sounding terms like "Team" or "Company." However, the economic purpose of the "Core Contributors" allocation is to compensate and incentivize the primary individuals building and maintaining the protocol. This is functionally identical to a traditional team allocation.
* **Our Categorization:** `Core Contributors` is classified under **Founder / Team**.

#### **Example 2: The "Ecosystem Fund" Dilemma**

* **Scenario:** A project allocates 20% to an "Ecosystem Fund." This could mean several things.
* **Analysis:** The key question is: *who controls the funds and for what purpose?*
  * If the fund is controlled by the foundation or core team to be strategically deployed via grants, partnerships, or development bounties, its primary nature is a reserve.
  * If the fund is distributed directly to the public through automated, open programs like liquidity mining or staking rewards, it behaves more like a community incentive.
* **Our Categorization:** We typically classify `Ecosystem Fund` under **Reserved**, as the funds are project-controlled reserves for future use.

***

## Accessing Standard Allocations

<i class="fa-square-web-awesome-stroke">:square-web-awesome-stroke:</i> Available to **Pro users**

Standard Allocations are integrated in several of our pages and features:

#### Token Page

On the token analysis page, at the Allocations section, Standards Allocation can be toggled to group the project’s allocations by stakeholder

<figure><img src="/files/GMji0YvdaeycnHG9w8iO" alt=""><figcaption></figcaption></figure>

#### Allocation Comparison & Screener Features

Additionally, they can be seen on the [Allocation Comparison](/features/allocation/allocation-comparison) and [Allocation Screener](/features/allocation/allocation-screener) tools.

## Using Standard Allocations

**Token Page**

Token allocations will be grouped by their respective Standard Allocation giving you a more objective view of the project’s token distribution.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2Fean6JfGJpZpPibS9YrH5%2Fstandard-allocation.mp4?alt=media&token=1cf3acbe-774f-4650-bf98-337a5cf486cb>" %}

**Allocation Comparison**

Visually benchmark projects side-by-side to instantly compare their token distribution strategies and spot outliers.

<figure><img src="/files/qWFPJ5lxIvWW2gpSMbns" alt=""><figcaption></figcaption></figure>

Check out how the [Allocation Comparison](/features/allocation/allocation-comparison) feature can be utilized.

**Allocation Screener**

Filter the market with sorting and filter feature to find projects that match your thesis, such as *who allocates the most to Founder & Team* or *which Layer 1 project has the most unlocked % of Community Allocation*.

<figure><img src="/files/Kf7k5Auv5lv8rnaWwCZC" alt=""><figcaption></figcaption></figure>

Learn more on how to use the [Allocation Screener](/features/allocation/allocation-screener)


# TBD Locked

Quantifying unpredictable token supply and governance risk

{% hint style="info" %}

## Data Coverage & Project Disclosures

Tokenomist’s classifications are based on publicly available information, on-chain data, and verifiable disclosures. In some cases, particularly for operational distributions such as grants, incentives, or internal allocations, release mechanics may not be fully observable using these methods.

Projects that maintain additional documentation, internal tracking, or updated governance decisions that are not reflected in our data are encouraged to reach out. Where information can be independently verified, we will update classifications accordingly and document the change transparently in the **History Log**.
{% endhint %}

## Overview

#### The Problem: Not All Unlocks Are Timed

Standard, time-based vesting schedules are only part of the story. A significant portion of a project's token supply is often allocated without a publicly verifiable release schedule. This supply can often be based on unpredictable events, not a fixed calendar.

* Governance votes
* Achievement of specific roadmap milestones
* Internal processes not transparently tracked

As a result, analysts face a data visibility gap. Tokens may be allocated, partially distributed, or reserved, with exact release timing and remaining balance unable to be reliably confirmed.

#### Our Solution: TBD (To Be Determined) Locked

To solve this, we introduced **TBD Locked**, a classification that accounts for this uncertain supply.

TBD Locked refers to tokens that are allocated but do not have a predetermined release date. Their release mechanics are not governed by a publicly verifiable, time-based schedule and may depend on future events, internal decisions, or ongoing operational distributions.

Not all TBD Locked supply represents immediate or latent market sell pressure. In practice, TBD Locked includes two broad categories

**Event-Gated TBD Locked**: unlocks contingent on a discrete, observable trigger. For example, a governance vote assigning a vesting schedule. These allocations may present future supply overhang.

**Operational TBD Locked**: tokens allocated for ongoing uses (grants, incentives, ecosystem spend). The distribution for this supply occurs incrementally or off-schedule, and it may not be possible to verify the remaining balance independently. These allocations represent accounting uncertainty, not sudden market risk.

#### Why TBD Locked Matters for Analysis

* **Identify Areas of Supply Uncertainty:** A large TBD Locked allocation signals that a portion of supply lacks a publicly verifiable release schedule. In some cases, this may represent potential future market supply. In others, it reflects limited transparency into operational distributions already underway.
* **Assess Governance Power:** A treasury with a large TBD Locked allocation potentially holds significant, deployable capital. Tracking this is key to understanding the resources a foundation or DAO has to influence the ecosystem.
* **Track Changes Over Time:** TBD Locked amounts are dynamic. We monitor governance proposals and announcements quarterly, and any changes are recorded in the **History Log** with links to the source. This helps you to follow the evolution of a project's tokenomics with a verifiable proof.
* **Separate Market Risk from Data Gaps**: TBD Locked does not imply that all tokens are idle or immediately deployable. Rather, it highlights where supply dynamics cannot be precisely modeled due to incomplete disclosure or tracking limitations.

## Methodology

#### Definitions

* **TBD Locked Supply (To Be Determined Locked):** Refers to tokens that are allocated but do not have a predetermined release date. Their unlock is depends on future events, such as governance votes or team decisions. On our charts, this is visualized with a **striped pattern**.
* **Locked Supply:** Locked tokens of a known, time-based release schedule.
* **Unlocked Supply:** Unlocked tokens of a known, time-based release schedule.
* **Available Supply:** Unlocked Supply + TBD Locked Supply

#### Generic Example of a TBD Locked Supply

`TBD Locked Supply` → `Trigger Event` → `Time-based Release Schedule` → `Unlocked Supply`

#### Example Case: Arbitrum ($ARB) Governance

A real-world example is how we handle the [Arbitrum](https://tokenomist.ai/arbitrum) DAO Treasury.

* **Initial State:** Initially, a large portion of the treasury's supply had no defined unlock schedule, so we classified it as **TBD Locked**.
* **Trigger Event:** The Arbitrum community passed [**AIP-1.1**](https://www.tally.xyz/gov/arbitrum/proposal/70545629960586317780628692755032548222173912190231545322320044688071893662480), a governance proposal that assigned a 4-year vesting schedule to a specific portion of the treasury funds.
* **The Update:** Following this vote, we updated our data. The affected tokens were converted from the uncertain **TBD Locked** to the predictable **Locked Supply** (time-based release schedule).
* **The Verifiable Proof:** This change is documented transparently in the **History Log**, which details the proposal, the amount of tokens affected, and the new unlock dates.

## Accessing TBD

We represent TBD with a distinct **striped pattern** on our charts in the Token Page, allowing you to differentiate between predictable time-locked tokens and this more uncertain event-locked supply.

<figure><img src="/files/lBmqpigyNHBZfRYELxRC" alt=""><figcaption></figcaption></figure>

Additionally, you can compare TBD supply allocated to token stakeholders, shown as a striped bar chart, on the **Allocation Comparison** page.

<figure><img src="/files/qWFPJ5lxIvWW2gpSMbns" alt=""><figcaption></figcaption></figure>

## Using TBD

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FwXlSI1CmcxXkZnHapgi2%2Ftoken-page-tbd.mp4?alt=media&token=c9befa0e-83d0-4e2c-9644-8ba3d92d4f6f>" %}

**1. See Which Allocations are Affected**

It’s not enough to know *that* TBD supply exists; you need to know *who* holds it. The **Allocation** component on the Token page shows you exactly which stakeholder holds these event-based tokens. This helps you determine if the uncertain supply is in the project's treasury, earmarked for community incentives, or held by another party.

**2. Visualize on the Release Schedule**

On the token page’s release schedule, TBD Locked tokens appear as a striped block. This signifies their potential to be unlocked at any point in the future, subject to the required conditions being met. When a formal release schedule is approved for these tokens, they are converted from "TBD Locked" to "Locked" on our chart.

**3. Tracking Changes with the Historical Logs**

TBD Locked amounts are not static. When a project sets a release timing schedule, a portion of these tokens become a known **Locked Supply**, reducing the overall TBD Locked amount.

We keep track of these allocations and update them as decisions are made. You can see the details with proofs in the **History Log**, which provides a transparent, auditable trail of all changes to a project's tokenomics.


# Emission: Cliff, Linear

Standardizing token release schedules with cliff and linear models

## Overview

Token release schedules use inconsistent terms, making it difficult to compare projects. We solve this by standardizing unlock models into two types: periodic **Cliff Release** and daily **Linear Release**. Our **Emission** component provides the complete picture by tracking net supply changes from both inflation and token burns (deflation).

<figure><img src="/files/k0jOpOyJUMpWncwNadj6" alt=""><figcaption></figcaption></figure>

## Methodology

#### **Definitions**

* **Cliff Unlock:** An unlock event that occurs at a set interval greater than one day (e.g., weekly, monthly, quarterly). This represents a discrete, periodic release of tokens.
* **Linear Unlock:** A continuous, daily release of a specific number of tokens. This represents a smooth, predictable increase in the circulating supply.
* **Inflation:** The number of new tokens either from new issuance or released according to a release schedule.
* **Deflation:** The decrease of tokens via a burn mechanism.
* **Emission:** Calculated as `Inflation - Deflation`.

1. **Unlock Classification:** We analyze each allocation's release schedule. If tokens are released daily, we classify the model as **Linear**. If they are released in discrete intervals (weekly, monthly, etc.), we classify it as a **Cliff**.
2. **Emission Calculation:**
   * **Historical:** We track all inflation and deflation events from the Token Generation Event (TGE) to today to calculate the total net emission history.
   * **Projected:** We project future inflation based on all known **Cliff** and **Linear** unlock schedules. **Note:** Our future projections do not include potential deflationary events (burns), as these are often variable and unpredictable.

#### **Example Cases**

* **Case 1 (Cliff):** A project's "Advisor" tokens unlock 1,000,000 tokens on the 1st of every month. Our system shows this as a monthly **Cliff Unlock** with a countdown.
* **Case 2 (Linear):** A protocol's "Ecosystem Rewards" release 50,000 tokens per day. We classify this as a **Linear Unlock** and show a countdown to the next *change in this daily rate*, allowing analysts to model smooth inflation.

## Accessing Unlock & Emission Data

This data is a central feature of the main dashboard for every asset we track.

* The **Cliff** and **Linear** unlock modules are located at the top of the page, giving you an immediate summary of the next critical supply events.
* The detailed **Emission** chart is located further down, providing a comprehensive view of historical and projected supply changes.

See more about this on the **Token page**.


# Precisions and Assumptions

Evaluate the sources and accuracy of our tokenomics data

## Overview

#### The Problem: Unlock Data Lacks Consistency

Crypto projects report release schedules without any standardized enforcement. Data can be spread across blog posts, whitepapers, on-chain contracts, and multisigs, leading to ambiguity and making it difficult for users to trust the information they find.

#### Our Solution: Precision & Assumption

We introduce the **Precision & Assumption** framework. For every token we track, we show you **where** our data comes from (*Assumption*) and **how accurate** its timing is (*Precision*). This framework gives you the clarity to assess the transparency of a release schedule.

<figure><img src="/files/70VKtYs3sNCbAaqOvfPM" alt=""><figcaption></figcaption></figure>

## Methodology

#### Definitions

* **Assumption (Data Source Types):** Indicates where the release schedule data originates.
* **Precision (Release Time):** Indicates how precise the release timing is.

#### Assumption (Data Sources)

| Source Type                                 | Definition                                                                              |
| ------------------------------------------- | --------------------------------------------------------------------------------------- |
| **Public Project Data & On-chain Verified** | The release schedule was publicly announced by the project and verified by us on-chain. |
| **Public Project Data**                     | The release schedule was publicly announced by the project (e.g., in a blog post).      |
| **Vesting Contract**                        | The release schedule is derived directly from a time-lock smart contract.               |
| **Private Project Data**                    | The release schedule was confirmed privately by the project's team.                     |
| **Inferred On-chain**                       | The release schedule is interpreted by our team from on-chain behavior.                 |

#### Precision (Release Timing)

| Precision Level      | Definition                                                    |
| -------------------- | ------------------------------------------------------------- |
| **Second**           | The release occurs at the exact second specified.             |
| **Block**            | The release is tied to a specific block number.               |
| **Hour**             | The release can occur at any time within the specified hour.  |
| **Day**              | The release can occur at any time within the specified day.   |
| **Week**             | The release can occur at any time within the specified week.  |
| **Month**            | The release can occur at any time within the specified month. |
| **To Be Determined** | The release time is not yet known (see TBD Locked Supply).    |

## Example Cases

#### Example 1: Vesting Contract with Exact Timestamps

* **Scenario:** A vesting contract is deployed on-chain with parameters specifying exact unlock times down to the second (e.g., `2025-01-01 00:00:00 UTC`).
* **Analysis:** Because the contract itself dictates the precise timing, the data source is both transparent and verifiable on-chain. Users can independently confirm the schedule without ambiguity.
* **Our Categorization:** `Vesting Contract` with precision **Second** (the unlock will execute exactly at or very close to that timestamp).

#### Example 2: Whitepaper with Monthly Unlocks

* **Scenario:** A whitepaper states that 10% of tokens unlock "monthly" (e.g., January, February, March) without specifying days or hours.
* **Analysis:** The data is official, but without finer time granularity. The unlock could occur on the 1st, 15th, or 30th of the month.
* **Our Categorization:** `Public Project Data` with precision **Month** (the unlock can occur at any point during the specified month).

#### Example 3: Private Confirmation from Project

* **Scenario:** The team privately shares aspects of their vesting schedule with Tokenomist but does not publish it publicly.
* **Analysis:** While the source is direct, it lacks public verifiability. Confidence depends on the team’s reliability rather than on-chain guarantees.
* **Our Categorization:** `Private Project Data` with precision **Day** (if the team specifies exact dates, but not timestamps).

## Accessing Precision & Assumption

You can find the Precision & Assumption details on every token page. It is located in a dedicated **Tokenomics Reference** section underneath the release schedule that clearly displays the source and precision for each of the token's allocations.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FfONX0pmyGeceWx7NcnnW%2Ftoken-page-precision-and-assumptions.mp4?alt=media&token=90139144-9ae6-417a-9ba7-1cb7a988819e>" %}

## Using Precision & Assumption

**1. Evaluate Reliability of Unlocks**

* A **Cliff Unlock** for an *Investor* allocation with a `Vesting Contract` + `Second` precision is highly reliable, near-certain.
* An unlock with `Inferred On-chain` + `Month` precision is far less reliable and should be treated cautiously.

**2. Compare Allocations Across Sources**

See how different allocations within a project vary in reliability — some may be contract-verified while others are only privately confirmed.

**3. Incorporate into Risk Assessment**

Before acting on vesting data, always check its **Assumption** and **Precision** to gauge confidence.


# Release Mechanisms

Standardizing token distribution methods for deeper analysis

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

Understanding *who* gets a project's tokens (the allocation) is only half the story. The *how*, i.e., the specific method by which those tokens are distributed, is just as critical for assessing emissions and long-term incentives.

To this end, Tokenomist introduces **Release Mechanisms**, a standardized classification system for token distribution methods. This allows you to analyze not just which stakeholders get tokens, but also the mechanics of how those tokens are released.

## Methodology

#### **Definitions**

Our system categorizes all distribution methods into one of the following eight standard mechanisms:

| Release Mechanism                      | Definition                                                                                                                                         |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Airdrop & Retroactive Rewards**      | Free token distribution to users based on eligibility, promotions, or past participation. Used to bootstrap communities and reward early adopters. |
| **Auctions & Sales (ICO/IDO/IEO)**     | Tokens sold via structured fundraisers like public sales (ICOs, IDOs, IEOs), with either fixed or auction-based pricing.                           |
| **Vesting & Time-Locked Distribution** | Gradual token release over a predetermined period. Used to control selling pressure and align long-term incentives for teams and investors.        |
| **Mining & Validators**                | Tokens awarded for securing the network through Proof-of-Work (mining) or Proof-of-Stake (staking), rewarding participation in network consensus.  |
| **Yield Farming**                      | Tokens awarded to users for providing liquidity to a protocol, incentivizing capital for DeFi ecosystems.                                          |
| **Initial Liquidity**                  | Tokens allocated as starting liquidity on trading platforms to ensure sufficient market depth at launch.                                           |
| **Activity Based**                     | Tokens distributed based on specific user actions, such as task completion, referrals, contests, or governance participation.                      |
| **Others**                             | Alternative or unique distribution methods that do not fit into the standard categories above.                                                     |

#### Example #1: Liquidity Mining Program

* **Scenario:** A new DeFi protocol allocates tokens to a "Liquidity Mining Program," with tokens distributed through user participation in farming pools.
* **Analysis:** Liquidity mining is a type of yield farming with the underlying purpose of rewarding users for providing capital and engaging with the protocol.
* **Our Categorization:** `Liquidity Mining Program` is classified under **Yield Farming.**

#### Example #2: Early Backers & Team

* **Scenario:** A new Layer 1 blockchain lists allocations for "Early Backers & Team," with tokens locked and gradually released over time.
* **Analysis:** Early backer and team allocations typically involve vesting schedules or time-locks to align long-term incentives and prevent large, immediate sell-offs. While project documents may use varying labels, the mechanism is a standard vesting distribution.
* **Our Categorization:** `Early Backers & Team` is classified with a **Vesting & Time-Locked Distribution** release mechanism.

## Accessing Release Mechanisms

{% hint style="info" %}
Under construction
{% endhint %}

## Using Release Mechanisms

{% hint style="info" %}
Under construction
{% endhint %}


# Supply Metrics

The reference guide to Tokenomist's supply metrics

## **Overview**

In the crypto industry, there is no universal standard for defining supply metrics. Terms like "Circulating Supply" can mean different things on different platforms, leading to confusion and making it difficult to perform accurate, apples-to-apples comparisons.

Tokenomist resolves this by establishing a standardized framework for supply metrics ensuring that you have a reliable and unambiguous data.

## **Methodology**

#### **Definitions**

| Metric                        | Definition                                                                                                                                                                                                                                                                                                                 | Formula                                                                                                                         |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Fully Diluted Value (FDV)** | <p></p><p>The theoretical total market value of a cryptocurrency assuming all possible tokens are in circulation.</p>                                                                                                                                                                                                      | Limited supply tokens: `Maximum Supply × Current Price`Unlimited supply tokens: `Projected Supply at Year 2035 × Current Price` |
| **Released Supply**           | The total amount of tokens that are unlocked and claimable, including those still held in stakeholder wallets. **This is not the same as Reported Circulating Supply.**                                                                                                                                                    |                                                                                                                                 |
| **Adjusted Released Supply**  | The total amount of tokens that have been released into circulation or are available to claim, excluding permanently burned tokens. This includes both actively traded tokens and those held in stakeholder wallets.                                                                                                       | `Released Supply- Deflation`                                                                                                    |
| **Adjusted Market Cap**       | <p>The total value of a cryptocurrency's released supply excluding permanently burned tokens. </p><p>This metric may differ from reported market cap, as it includes tokens that are available but may still be held in stakeholder wallets.</p>                                                                           | `Current Price × Adjusted Released Supply.`                                                                                     |
| **Stakeholder Wallet**        | A known wallet (e.g., team, treasury, investor) holding tokens under special conditions. Tokens in these wallets are not considered part of the circulating supply until they are moved out.                                                                                                                               |                                                                                                                                 |
| **Circulating Supply**        | The number of tokens available for open market trading, having been transferred out of stakeholder wallets. This is the most common measure of a token's liquid supply. We collect this supply data from multiple sources.                                                                                                 |                                                                                                                                 |
| **Locked Supply**             | <p>The number of tokens that have been restricted to prevent trading in the public market and transfer to non-stakeholder wallets. The duration of the lock time and type of release (cliff or linear) are also specified.<br><br><em>This metric does not yet include the locked token in the re-lock mechanism.</em></p> |                                                                                                                                 |
| **TBD Locked Supply**         | Tokens locked without a determined release date, often held in a treasury or reserve pending a future event (e.g., a governance vote).                                                                                                                                                                                     |                                                                                                                                 |
| **Available Supply**          | The total number of tokens that are either already unlocked or TBD Locked, representing the maximum potential near-term supply.                                                                                                                                                                                            | `Released Supply + TBD Locked`                                                                                                  |
| **Untracked Supply**          | A temporary classification for tokens that cannot be assigned to a specific allocation due to data uncertainty.                                                                                                                                                                                                            |                                                                                                                                 |
| **Supply Y2035**              | Projected available token supply expected to be unlocked by end of 2035, including current unlocked, scheduled releases, and those with undetermined unlock dates (TBD supply).                                                                                                                                            |                                                                                                                                 |
| **Max Supply**                | The theoretical maximum number of tokens that can ever be created. In some cases, this number may be infinite, which indicates there is no limit to token issuance.                                                                                                                                                        |                                                                                                                                 |
| **Emission**                  | The net change in released supply over a period, representing the rate of supply dilution or contraction.                                                                                                                                                                                                                  | `Inflation - Deflation`                                                                                                         |

#### **3. Practical Example: How Metrics Relate**

Imagine "Token X" has a **Total Supply** of 100 million. A snapshot might look like this:

* **Locked Supply:** 40M (Team tokens vesting over 4 years)
* **TBD Locked Supply:** 20M (In a DAO treasury awaiting a vote)
* **Released Supply:** 40M (The remaining tokens are unlocked and claimable)
* **Circulating Supply:** 30M (Of the 40M unlocked, 30M have been moved out of stakeholder wallets to the open market, while 10M are still held by the project/investors).

#### **Accessing Supply Metrics**

These core metrics are the foundation of our platform and can be found across the website:

* On the main dashboard for every token.
* In the detailed charts and tables on each token page.

#### **Using Supply Metrics for Insights**

By combining these metrics, you can uncover deeper insights:

* **Gauge Inflation Potential:** Compare the **Circulating Supply** to the **Total Supply**. A large difference indicates significant future inflation is scheduled.
* **Identify "Unclaimed Overhang":** Compare the **Released Supply** to the **Circulating Supply**. A large gap means insiders are holding a significant amount of claimable tokens that *could* enter the market at any time.

#### **FAQs**

Q1: What is the most important difference between Released Supply and Circulating Supply?

Released Supply is the total amount of tokens that are no longer vesting, including those still held by the team or investors. Circulating Supply only includes the portion of unlocked tokens that have left these "stakeholder" wallets and are available on the open market.

Q2: Why do you separate Locked Supply and TBD Locked Supply?

Locked Supply has a predictable, time-based release schedule that we can chart out. TBD Locked Supply has no schedule and is event-based, representing a more uncertain future supply. Separating them allows users to distinguish between predictable inflation and potential supply shocks.

Q3: Does your FDV calculation use Max Supply or Total Supply?

As stated in our formula, we use Total Supply for our FDV calculation. This represents the value after all currently planned tokens are issued, which we believe is a more practical metric than a theoretical and potentially infinite Max Supply.


# Non-Traditional Unlock Mechanisms

Understanding the difference between vesting unlocks and emission-based releases

## Overview

Not every project distributes tokens through a **vesting schedule**. While many do, others rely on mechanisms such as **mining, staking rewards, or inflation schedules**.

At Tokenomist, we track both. For tokens like [**Bitcoin**](https://tokenomist.ai/bitcoin) **(mining rewards)**, [**Bittensor**](https://tokenomist.ai/bittensor) **(emissions)**, or [**Solana**](https://tokenomist.ai/solana) **(staking inflation)**, supply enters the market continuously rather than through unlock cliffs. In these cases, we use the word **“release”** rather than **“unlock”**.

Some users have asked why tokens without unlocks appear on Tokenomist. The reason is that regardless of the mechanism, these tokens **still introduce new supply into circulation**, which affects valuation, float, and dilution. Whether tokens are unlocked from allocations or released through emissions, the market impact is similar: **more supply becomes available**.

## Methodology

### Unlocks vs Releases

* **Unlocks**: Supply entering circulation from vesting schedules or allocations (e.g., team, investors, treasury).
* **Releases**: Supply entering circulation from continuous mechanisms (e.g., mining, staking rewards, inflation).

In practice, there are times when the two words are used interchangeably in the product, since both describe new supply being introduced. However, the distinction matters for context, and we are working on making this clearer in the interface.

### Allocation Specific vs. Whole Token Releases

Releases can appear in two forms on Tokenomist:

* **Allocation specific releases**: For projects like **Solana**, some allocations (e.g., staking rewards) are tracked as ongoing releases, while others still follow vesting unlocks.
* **Whole token releases**: For tokens such as **Bitcoin** or **Kaspa**, the entire circulating supply is emission-based, so the whole token is modeled as a release schedule rather than unlocks.

### Examples

* [**Bitcoin**](https://tokenomist.ai/bitcoin) **(BTC):** Entirely release-based via PoW mining rewards.
* [**Kaspa**](https://tokenomist.ai/kaspa) **(KAS):** Entirely release-based via emission schedule.
* [**Bittensor**](https://tokenomist.ai/bittensor) **(TAO):** Entirely release-based via ongoing emissions.
* [**Solana**](https://tokenomist.ai/solana) **(SOL):** Mixed model—staking rewards are releases, while some allocations follow vesting unlocks.

## Looking Ahead

Our goal is to make it easy for users to understand *when* and *how much* supply is entering the market, regardless of mechanism. Over time, we’ll refine our labels so it’s always clear whether a figure represents an **unlock** or a **release**, and whether that applies to an allocation or the entire token.

As the industry evolves, we’ll continue updating our approach to ensure these distinctions remain accurate and relevant.

## Where To Next?

* See [Emission: Cliff, Linear](/methodology/emission-cliff-linear) to learn how we standardize releases into Cliff and Linear.
* Learn more about definitions and supply terms at [Supply Metrics](/methodology/supply-metrics).


# Introduction

A Guide to using Tokenomist' API.

{% hint style="info" %}
Pro access is included in API tier. To access Tokenomist' API visit [here](https://token.unlocks.app/pricing).
{% endhint %}

### Overview

This guide details the API, which provides access to comprehensive time series data for available crypto tokens. For more information on our API offerings, please visit [here](https://token.unlocks.app/pricing) or reach out to us on the [Tokenomist Official Telegram](<https://t.me/daosurv >) or via email (<consulting@tokenomist.ai>).

### API Datasets

By purchasing the API plan, you will receive access to the following time series data for your research and internal uses:

**Details of Dataset per Plan:**

* Standard API Plan
* Elite API Plan
* Enterprise API Plan: For longer timeframes, additional datasets, and commercial terms for business usecases, please contact <consulting@tokenomist.ai> for customized solutions.
* Free trial: please fill this [form](https://docs.google.com/forms/d/e/1FAIpQLSebUG7Dq2mffAxoUfxbpSaN-GwUSB4vxmWA1PEobJlzcVesuw/viewform?usp=header) to request for free trial.

*All data provided through all Tokenomist' plans is intended for personal or non-commercial, non-redistribution use only.*

<table><thead><tr><th width="119.4423828125">Endpoint</th><th width="128.458984375">Description</th><th align="center">Free trial</th><th width="126.169921875" align="center">Standard</th><th width="128.6708984375" align="center">Elite</th><th width="127.515625" align="center">Enterprise</th></tr></thead><tbody><tr><td>Rate Limit</td><td>Requests per Min</td><td align="center">60</td><td align="center">60</td><td align="center">60</td><td align="center">60 or customized</td></tr><tr><td><em>Token List</em></td><td>Get list of all tokens available</td><td align="center">50 Tokens</td><td align="center">All tokens</td><td align="center">All tokens</td><td align="center">All tokens</td></tr><tr><td><em>Allocations</em></td><td>Detailed unlocked Allocations breakdown</td><td align="center">50 Tokens</td><td align="center">All tokens</td><td align="center">All tokens</td><td align="center">All tokens</td></tr><tr><td><em>Unlock Events</em></td><td>Events containing Unlocks information with timestamp<br>(Cliff Unlocks, Linear Unlocks Start Event)</td><td align="center">1 year backward</td><td align="center">1 year backward, 2 years forward</td><td align="center">2 years backward, 3 years forward</td><td align="center">Customizable</td></tr><tr><td><em>Daily Emission</em></td><td>Token emission summarized to daily granularity regardless of type of unlocks (linear, cliff, etc) <a href="https://app.gitbook.com/o/TzUgDOjLsDHgkQ8AJzlm/s/AiV8rQPRMYfCyYrQgX5Q/~/changes/135/token-unlocks/token-page/cliff-linear-and-emission">learn more</a></td><td align="center">1 year backward</td><td align="center">1 years backward, 2 years forward</td><td align="center">2 years backward, 3 years forward</td><td align="center">Customizable</td></tr><tr><td>Fundraising</td><td>Token project venture capital funding rounds and investor participation</td><td align="center">No</td><td align="center">All </td><td align="center">All</td><td align="center">All </td></tr><tr><td>Burn</td><td>An event when tokens permanently removed from circulation.</td><td align="center">No</td><td align="center">No</td><td align="center">All </td><td align="center">All </td></tr><tr><td>Buyback</td><td>An event when and how projects repurchase their own tokens from the market</td><td align="center">No</td><td align="center">No</td><td align="center">All </td><td align="center">All </td></tr><tr><td>Commercial License</td><td>Rights to re-distribute</td><td align="center">No</td><td align="center">No</td><td align="center">No</td><td align="center">Yes</td></tr></tbody></table>

{% hint style="info" %}
To get started, call the Token List API to acquire tokenID and initiate the necessary API endpoints to retrieve the rest of the data.
{% endhint %}

All Timeframe provided is in UTC+00

Visit each API endpoint page for more details and data examples.


# API Endpoints

Visit each API endpoint page for more details and data example.

**For All API users:**

{% content-ref url="/pages/r0uCm0sfKvLv3aUqnUFe" %}
[Token List API](/api-documents/api-endpoints/token-list-api)
{% endcontent-ref %}

{% content-ref url="/pages/p2ZwhOuF44JBC4BGL3Mg" %}
[Allocations API](/api-documents/api-endpoints/allocations-api)
{% endcontent-ref %}

{% content-ref url="/pages/rGRYMPE0f46ZFxt4JETT" %}
[Daily Emission API](/api-documents/api-endpoints/daily-emission-api)
{% endcontent-ref %}

{% content-ref url="/pages/poGtWkRYw0Zex2VVAOKw" %}
[Unlock Events API](/api-documents/api-endpoints/unlock-events-api)
{% endcontent-ref %}

{% content-ref url="/pages/9EbNZFyX6cHGZ5rNnMwV" %}
[Token Fundraising API](/api-documents/api-endpoints/token-fundraising-api)
{% endcontent-ref %}

{% content-ref url="/pages/YC65lQN7xjzBCUYWgLC5" %}
[Investor List API](/api-documents/api-endpoints/investor-list-api)
{% endcontent-ref %}

{% content-ref url="/pages/Yfts5a1Pqg6j9bdUGNmO" %}
[Investors API](/api-documents/api-endpoints/investors-api)
{% endcontent-ref %}

{% content-ref url="/pages/4m0CRKTBrxlvoY0ljGkr" %}
[Burn API](/api-documents/api-endpoints/burn-api)
{% endcontent-ref %}

{% content-ref url="/pages/OHP1rcM8syAuzoGtV9Fd" %}
[Buyback API](/api-documents/api-endpoints/buyback-api)
{% endcontent-ref %}


# Token List API

**Overview**

Start here to get a list of all tokenID to use for calling another  endpoints. You can then use the required tokenID to call each endpoint.

There are 4 versions of Token List API

* <mark style="background-color:yellow;">**Token List API v4 (Recommended) ; Include informations about fundraising rounds, burns, and buybacks**</mark>

{% content-ref url="/pages/werXUM133Rd2YBu4NN3W" %}
[Token List API v4](/api-documents/api-endpoints/token-list-api/token-list-api-v4)
{% endcontent-ref %}

* Token List API v3 ; Provides more data fundraising rounds

{% content-ref url="/pages/NAvCGe8WSycxzeHLrKe3" %}
[Token List API v3](/api-documents/api-endpoints/token-list-api/token-list-api-v3)
{% endcontent-ref %}

* Token List API v2 ; Provides more data from tokens added with AI assisted method

{% content-ref url="/pages/9VIKlXbdbaNSW1cdak5D" %}
[Token List API v2](/api-documents/api-endpoints/token-list-api/token-list-api-v2)
{% endcontent-ref %}

* Token List API v1&#x20;

{% content-ref url="/pages/4l15XSTGsYWQRmZvmMWU" %}
[Token List API v1](/api-documents/api-endpoints/token-list-api/token-list-api-v1)
{% endcontent-ref %}


# Token List API v1

**Overview**

Start here to get a list of all tokenID to use for calling following API's. You can then use the required tokenID to call each endpoint.

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v1/token/list
HEADER: x-api-key: <YOUR_API_KEY>
```

## **Endpoints: Token List**  <a href="#endpoints" id="endpoints"></a>

**Parameters**

No parameters required.

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/token/list' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2024-08-19T11:50:53Z"
    },
    "status": true,
    "data": [
        {
            "id": "optimism",
            "name": "Optimism",
            "symbol": "OP",
            "circulatingSupply": 1187596466,
            "marketCap": 1603255229.1000001,
            "maxSupply": 4294967296,
            "totalLockedAmount": 856358024.1999991,
            "tbdLockedAmount": 2231937452,
            "unlockedAmount": 1206671819.0000002,
            "untrackedAmount": 0.8000006675720215,
            "hasStandardAllocation": true,
            "websiteUrl": "https://token.unlocks.app/optimism",
            "lastUpdatedDate": "2024-06-18T09:07:49Z"
        },
        {
            "id": "arbitrum",
            "name": "Arbitrum",
            "symbol": "ARB",
            "circulatingSupply": 3339278542,
            "marketCap": 1767580310.63686,
            "maxSupply": 10000000000,
            "totalLockedAmount": 3337041635.2724714,
            "tbdLockedAmount": 3403750000,
            "unlockedAmount": 3259208364.7275305,
            "untrackedAmount": 0,
            "hasStandardAllocation": true,
            "websiteUrl": "https://token.unlocks.app/arbitrum",
            "lastUpdatedDate": "2024-06-11T08:49:27Z"
        },
        {
            "id": "aptos",
            "name": "Aptos",
            "symbol": "APT",
            "circulatingSupply": 483688317.525007,
            "marketCap": 2815066007.995541,
            "maxSupply": null,
            "totalLockedAmount": 621184773.949999,
            "tbdLockedAmount": 0,
            "unlockedAmount": 378815226.04999995,
            "untrackedAmount": 0,
            "hasStandardAllocation": true,
            "websiteUrl": "https://token.unlocks.app/aptos",
            "lastUpdatedDate": "2024-06-11T07:03:20Z"
        },
        ....
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

**Return Fields Explanation**

| Fields                | Data Type | Description                                                                                   |
| --------------------- | --------- | --------------------------------------------------------------------------------------------- |
| id                    | string    | Identifier to call for a dataset                                                              |
| name                  | string    | Token Name                                                                                    |
| symbol                | string    | Token Symbol                                                                                  |
| circulatingSupply     | number    | Circulating supply of the token provided by external source (Will be null if no data present) |
| marketCap             | number    | Market cap of the token provided by external source (Will be null if no data present)         |
| maxSupply             | number    | 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                                           |
| websiteUrl            | string    | Link to Tokenomist token page                                                                 |
| lastUpdatedDate       | timestamp | Last updated date of token                                                                    |


# Token List API v2

**Overview**

Start here to get a list of all tokenID to use for calling following API's. You can then use the required tokenID to call each endpoint.

⬆️ v2 update: Provides more tokens that are listed with AI method. Add more field about  listing method, see below for field description

<table><thead><tr><th width="190">Listing Method</th><th>Definition</th></tr></thead><tbody><tr><td>INTERNAL</td><td>This token is listed and verified and cross checked across multiple sources by tokenomist</td></tr><tr><td>AI</td><td>This token has been listed using LLM assisted with single source. </td></tr><tr><td>EXTERNAL</td><td>This token is listed directly by the project team. It is first-party data and comes solely from the project's own source.</td></tr></tbody></table>

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v2/token/list
HEADER: x-api-key: <YOUR_API_KEY>
```

## **Endpoints: Token List**  <a href="#endpoints" id="endpoints"></a>

**Parameters**

No parameters required.

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v2/token/list' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2025-02-10T07:43:15Z"
    },
    "status": true,
    "data": [
        {
            "id": "1inch",
            "name": "1inch",
            "symbol": "1INCH",
            "listedMethod": "INTERNAL",
            "circulatingSupply": 1399213268.376045,
            "marketCap": 363579807,
            "maxSupply": 1499999999.997,
            "totalLockedAmount": 1748578.7999999523,
            "tbdLockedAmount": 0,
            "unlockedAmount": 1386314857.9699986,
            "untrackedAmount": 111936563.22700143,
            "hasStandardAllocation": false,
            "websiteUrl": "https://token.unlocks.app/1inch",
            "lastUpdatedDate": "2024-06-13T07:13:05Z"
        },
        {
            "id": "a3s",
            "name": "A3S",
            "symbol": "AA",
            "listedMethod": "INTERNAL",
            "circulatingSupply": 240195062.5232677,
            "marketCap": 8638466,
            "maxSupply": 1000000000,
            "totalLockedAmount": 66150000.000000015,
            "tbdLockedAmount": 900000000,
            "unlockedAmount": 33850000,
            "untrackedAmount": 0,
            "hasStandardAllocation": true,
            "websiteUrl": "https://token.unlocks.app/a3s",
            "lastUpdatedDate": "2024-11-25T03:06:24Z"
        },
        ....
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

**Return Fields Explanation**

| Fields                | Data Type | Description                                                                                   |
| --------------------- | --------- | --------------------------------------------------------------------------------------------- |
| id                    | string    | Identifier to call for a dataset                                                              |
| name                  | string    | Token Name                                                                                    |
| symbol                | string    | Token Symbol                                                                                  |
| listedMethod          | string    | Method of listing(INTERNAL, AI, EXTERNAL)                                                     |
| circulatingSupply     | number    | Circulating supply of the token provided by external source (Will be null if no data present) |
| marketCap             | number    | Market cap of the token provided by external source (Will be null if no data present)         |
| maxSupply             | number    | 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                                           |
| websiteUrl            | string    | Link to Tokenomist token page                                                                 |
| lastUpdatedDate       | timestamp | Last updated date of token                                                                    |


# Token List API v3

⬆️ v3 update: Add information about fundraising and latest round

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v3/token/list
HEADER: x-api-key: <YOUR_API_KEY>
```

## **Endpoints: Token List**  <a href="#endpoints" id="endpoints"></a>

**Parameters**

No parameters required.

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v3/token/list' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2026-01-08T10:16:00Z"
    },
    "status": true,
    "data": [
        {
            "id": "0x",
            "name": "0x Protocol",
            "symbol": "ZRX",
            "listedMethod": "INTERNAL",
            "circulatingSupply": 848396562.906836,
            "marketCap": 121860242,
            "maxSupply": 1000000000,
            "totalLockedAmount": 0,
            "tbdLockedAmount": 0,
            "unlockedAmount": 1000000000,
            "untrackedAmount": 0,
            "hasStandardAllocation": true,
            "hasFundraising": true,
            "latestFundraisingRound": "Series B",
            "websiteUrl": "https://tokenomist.ai/0x",
            "lastUpdatedDate": "2025-04-25T08:42:27Z"
        },
        ....
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

**Return Fields Explanation**

| Fields                  | Data Type | Description                                                                                   |
| ----------------------- | --------- | --------------------------------------------------------------------------------------------- |
| id                      | string    | Identifier to call for a dataset                                                              |
| name                    | string    | Token Name                                                                                    |
| symbol                  | string    | Token Symbol                                                                                  |
| listedMethod            | string    | Method of listing(INTERNAL, AI, EXTERNAL)                                                     |
| circulatingSupply       | number    | Circulating supply of the token provided by external source (Will be null if no data present) |
| marketCap               | number    | Market cap of the token provided by external source (Will be null if no data present)         |
| maxSupply               | number    | 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                                                           |
| lastestFundraisingRound | string    | The latest round raised                                                                       |
| websiteUrl              | string    | Link to Tokenomist token page                                                                 |
| lastUpdatedDate         | timestamp | Last updated date of token                                                                    |


# Token List API v4

⬆️ v4 update: <mark style="background-color:yellow;">Include informations about fundraising rounds, burns, and buybacks</mark>

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v4/token/list
HEADER: x-api-key: <YOUR_API_KEY>
```

## **Endpoints: Token List**  <a href="#endpoints" id="endpoints"></a>

**Parameters**

No parameters required.

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v4/token/list' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2026-01-08T10:13:58Z"
    },
    "status": true,
    "data": [
        {
            "id": "0x",
            "name": "0x Protocol",
            "symbol": "ZRX",
            "listedMethod": "INTERNAL",
            "circulatingSupply": 848396562.906836,
            "marketCap": 121860242,
            "maxSupply": 1000000000,
            "totalLockedAmount": 0,
            "tbdLockedAmount": 0,
            "unlockedAmount": 1000000000,
            "untrackedAmount": 0,
            "hasStandardAllocation": true,
            "hasFundraising": true,
            "latestFundraisingRound": "Series B",
            "hasBurn": false,
            "hasBuyback": false,
            "websiteUrl": "https://tokenomist.ai/0x",
            "lastUpdatedDate": "2025-04-25T08:42:27Z"
        },
        ....
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

**Return Fields Explanation**

| Fields                  | Data Type | Description                                                                                   |
| ----------------------- | --------- | --------------------------------------------------------------------------------------------- |
| id                      | string    | Identifier to call for a dataset                                                              |
| name                    | string    | Token Name                                                                                    |
| symbol                  | string    | Token Symbol                                                                                  |
| listedMethod            | string    | Method of listing(INTERNAL, AI, EXTERNAL)                                                     |
| circulatingSupply       | number    | Circulating supply of the token provided by external source (Will be null if no data present) |
| marketCap               | number    | Market cap of the token provided by external source (Will be null if no data present)         |
| maxSupply               | number    | 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                                                           |
| hasBurn                 | boolean   | Data set identifier for burn                                                                  |
| hasBuyback              | boolean   | Data set identifier for buyback                                                               |
| lastestFundraisingRound | string    | The latest round raised                                                                       |
| websiteUrl              | string    | Link to Tokenomist token page                                                                 |
| lastUpdatedDate         | timestamp | Last updated date of token                                                                    |


# Allocations API

There are 2 versions of Allocations API

* <mark style="background-color:yellow;">**Allocations API v2 (Recommended) ; Provides more data from tokens with AI assisted**</mark>

{% content-ref url="/pages/Ka9kt9kK5XeKfO1Dxvtw" %}
[Allocations API v2](/api-documents/api-endpoints/allocations-api/allocations-api-v2)
{% endcontent-ref %}

* Allocations API v1&#x20;

{% content-ref url="/pages/wlo1vnMuGQGN7ZoNNgyI" %}
[Allocations API v1](/api-documents/api-endpoints/allocations-api/allocations-api-v1)
{% endcontent-ref %}


# Allocations API v1

**Overview**

Get all token allocations as well as Tokenomist' own methodology of comparable allocation standards.&#x20;

See more details about our [Standard Allocation](/tokenomist-pro/standard-allocation)

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

<pre><code><strong>GET https://api.unlocks.app/v1/allocations
</strong>HEADER: x-api-key: &#x3C;YOUR_API_KEY>
</code></pre>

## **Endpoints: Allocations** <a href="#endpoints" id="endpoints"></a>

**Parameters**

Note: `tokenId` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/allocations?tokenId=optimism' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2024-06-24T13:29:11Z"
    },
    "status": true,
    "data": {
        "name": "Optimism",
        "symbol": "OP",
        "maxSupply": 4294967296,
        "lastUpdatedDate": "2024-06-18T09:07:49Z",
        "totalUnlockedAmount": 1133988512.7000003,
        "totalLockedAmount": 929041330.499999,
        "totalUntrackedAmount": 0.8000006675720215,
        "totalTBDLockedAmount": 2231937452,
        "allocations": [
            {
                "allocationName": "Core Contributors",
                "allocationType": "Scheduled",
                "standardAllocationName": "Founder / Team",
                "allocationUnlockedAmount": 402508084,
                "allocationLockedAmount": 413535702,
                "allocationAmount": 816043786,
                "trackedAllocationPercentage": 18.999999994412065
            },
            {
                "allocationName": "Seed Fund",
                "allocationType": "TBD",
                "standardAllocationName": "Private Investors",
                "allocationUnlockedAmount": 0,
                "allocationLockedAmount": 231928234,
                "allocationAmount": 231928234,
                "trackedAllocationPercentage": 5.400000000372529
            },
            {
                "allocationName": "Investors",
                "allocationType": "Scheduled",
                "standardAllocationName": "Private Investors",
                "allocationUnlockedAmount": 360138811.7,
                "allocationLockedAmount": 370005628.5000002,
                "allocationAmount": 730144440.2000002,
                "trackedAllocationPercentage": 16.999999997206036
            },
            {
                "allocationName": "Unallocated Ecosystem Fund",
                "allocationType": "Scheduled",
                "standardAllocationName": "Reserve",
                "allocationUnlockedAmount": 0,
                "allocationLockedAmount": 135500000,
                "allocationAmount": 135500000,
                "trackedAllocationPercentage": 3.1548552215099335
            },
            {
                "allocationName": "Unallocated Ecosystem Fund",
                "allocationType": "TBD",
                "standardAllocationName": "Reserve",
                "allocationUnlockedAmount": 0,
                "allocationLockedAmount": 242457122,
                "allocationAmount": 242457122,
                "trackedAllocationPercentage": 5.645144777372479
            },
            {
                "allocationName": "Partner Fund",
                "allocationType": "Scheduled",
                "standardAllocationName": "Reserve",
                "allocationUnlockedAmount": 1712000,
                "allocationLockedAmount": 0,
                "allocationAmount": 1712000,
                "trackedAllocationPercentage": 0.03986060619354248
            },
            {
                "allocationName": "Partner Fund",
                "allocationType": "TBD",
                "standardAllocationName": "Reserve",
                "allocationUnlockedAmount": 0,
                "allocationLockedAmount": 230216234,
                "allocationAmount": 230216234,
                "trackedAllocationPercentage": 5.3601393941789865
            },
            {
                "allocationName": "User Airdrops",
                "allocationType": "Scheduled",
                "standardAllocationName": "Community",
                "allocationUnlockedAmount": 256245713,
                "allocationLockedAmount": 0,
                "allocationAmount": 256245713,
                "trackedAllocationPercentage": 5.966185429133475
            },
            {
                "allocationName": "User Airdrops",
                "allocationType": "TBD",
                "standardAllocationName": "Community",
                "allocationUnlockedAmount": 0,
                "allocationLockedAmount": 559798073,
                "allocationAmount": 559798073,
                "trackedAllocationPercentage": 13.03381456527859
            },
            {
                "allocationName": "Retroactive Public Goods Funding",
                "allocationType": "Scheduled",
                "standardAllocationName": "Community",
                "allocationUnlockedAmount": 41000000,
                "allocationLockedAmount": 10000000,
                "allocationAmount": 51000000,
                "trackedAllocationPercentage": 1.187436282634735
            },
            {
                "allocationName": "Retroactive Public Goods Funding",
                "allocationType": "TBD",
                "standardAllocationName": "Community",
                "allocationUnlockedAmount": 0,
                "allocationLockedAmount": 807993459,
                "allocationAmount": 807993459,
                "trackedAllocationPercentage": 18.812563712708652
            },
            {
                "allocationName": "Governance Fund",
                "allocationType": "Scheduled",
                "standardAllocationName": "Community",
                "allocationUnlockedAmount": 72383904,
                "allocationLockedAmount": 0,
                "allocationAmount": 72383904,
                "trackedAllocationPercentage": 1.6853190958499908
            },
            {
                "allocationName": "Governance Fund",
                "allocationType": "TBD",
                "standardAllocationName": "Community",
                "allocationUnlockedAmount": 0,
                "allocationLockedAmount": 159544330,
                "allocationAmount": 159544330,
                "trackedAllocationPercentage": 3.714680904522538
            }
        ]
    }
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

**Return Fields Explanation**

| Fields               | Data Type | Description                                                    |
| -------------------- | --------- | -------------------------------------------------------------- |
| name                 | string    | Token Name                                                     |
| symbol               | string    | Token Symbol                                                   |
| maxSupply            | number    | Max supply for the token (Will be null if no data are present) |
| lastUpdatedDate      | timestamp | Last updated date of token                                     |
| totalUnlockedAmount  | number    | Total current unlocked amount                                  |
| totalLockedAmount    | number    | Total current locked token amount                              |
| totalUntrackedAmount | number    | Total current untracked amount                                 |
| totalTBDLockedAmount | number    | Total current TBD locked amount                                |

**Return Fields Explanation: Allocations**

| Fields                      | Data Type | Description                                           |
| --------------------------- | --------- | ----------------------------------------------------- |
| allocationName              | string    | Allocation name                                       |
| allocationType              | string    | Type of allocation (Schedule, TBD, Untracked)         |
| standardAllocationName      | string    | Standard allocation of this allocation                |
| allocationUnlockedAmount    | number    | Current unlocked amount of the allocation             |
| allocationLockedAmount      | number    | Current locked amount of the allocation               |
| allocationAmount            | number    | Total token amount assign to this allocation          |
| trackedAllocationPercentage | number    | Total track allocation percentage not include untrack |


# Allocations API v2

⬆️ v2 update: Add Dynamic inflation rate. \*value might differ to v1\*

⬆️ v2 update: Provides more tokens that are listed with AI method. Add more field about  listing method, see below for field description

<table><thead><tr><th width="190">Listing Method</th><th>Definition</th></tr></thead><tbody><tr><td>INTERNAL</td><td>This token is listed and verified and cross checked across multiple sources by tokenomist</td></tr><tr><td>AI</td><td>This token has been listed using LLM assisted with single source. </td></tr><tr><td>EXTERNAL</td><td>This token is listed directly by the project team. It is first-party data and comes solely from the project's own source.</td></tr></tbody></table>

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

<pre><code><strong>GET https://api.unlocks.app/v2/allocations
</strong>HEADER: x-api-key: &#x3C;YOUR_API_KEY>
</code></pre>

**Parameters**

Note: `tokenId` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v2/allocations?tokenId=optimism' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2026-01-08T10:17:39Z"
    },
    "status": true,
    "data": {
        "name": "Optimism",
        "symbol": "OP",
        "listedMethod": "INTERNAL",
        "maxSupply": 4294967296,
        "lastUpdatedDate": "2025-06-11T10:36:43Z",
        "totalUnlockedAmount": 1930591949.2000003,
        "totalLockedAmount": 274658779,
        "totalUntrackedAmount": 0.8000006675720215,
        "totalTBDLockedAmount": 2089716567,
        "allocations": [
            {
                "allocationName": "Core Contributors",
                "allocationType": "Scheduled",
                "standardAllocationName": "Founder / Team",
                "allocationUnlockedAmount": 716795218,
                "allocationLockedAmount": 99248568,
                "allocationAmount": 816043786,
                "trackedAllocationPercentage": 18.999999998835847
            },
            {
                "allocationName": "Retroactive Public Goods Funding",
                "allocationType": "TBD",
                "standardAllocationName": "Community",
                "allocationUnlockedAmount": 0,
                "allocationLockedAmount": 799993459,
                "allocationAmount": 799993459,
                "trackedAllocationPercentage": 18.62629920212233
            },
        ....
        ]
    }
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

**Return Fields Explanation**

| Fields               | Data Type | Description                                                    |
| -------------------- | --------- | -------------------------------------------------------------- |
| name                 | string    | Token Name                                                     |
| symbol               | string    | Token Symbol                                                   |
| listedMethod         | string    | Method of listing(INTERNAL, AI, EXTERNAL)                      |
| maxSupply            | number    | Max supply for the token (Will be null if no data are present) |
| lastUpdatedDate      | timestamp | Last updated date of token                                     |
| totalUnlockedAmount  | number    | Total current unlocked amount                                  |
| totalLockedAmount    | number    | Total current locked token amount                              |
| totalUntrackedAmount | number    | Total current untracked amount                                 |
| totalTBDLockedAmount | number    | Total current TBD locked amount                                |

**Return Fields Explanation: Allocations**

| Fields                      | Data Type | Description                                           |
| --------------------------- | --------- | ----------------------------------------------------- |
| allocationName              | string    | Allocation name                                       |
| allocationType              | string    | Type of allocation (Schedule, TBD, Untracked)         |
| standardAllocationName      | string    | Standard allocation of this allocation                |
| allocationUnlockedAmount    | number    | Current unlocked amount of the allocation             |
| allocationLockedAmount      | number    | Current locked amount of the allocation               |
| allocationAmount            | number    | Total token amount assign to this allocation          |
| trackedAllocationPercentage | number    | Total track allocation percentage not include untrack |


# Daily Emission API

**Overview**

This dataset provides daily emission data per token which summarizes all unlocks  happening each day. This includes both linear and cliff unlocks that occurs within the day. &#x20;

(For longer historical and future dataset, please contact [consulting@tokenenomist.ai](mailto:consulting@tokenomist.ai))

Included is the breakdown of beneficiaries into [standard allocation](https://docs.unlocks.app/docs/~/changes/Iamy4ACjYOBw6V1zBAnb/tokenunlocks-pro/standard-allocation), a Tokenomist methodology for categorizing and grouping allocations from different projects into a comparable standard.

There are 2 versions of Daily Emission API

* <mark style="background-color:yellow;">**Daily Emission API v2 (Recommended) ;**</mark> <mark style="background-color:yellow;">**Provides more data from tokens with AI assisted**</mark>

{% content-ref url="/pages/YSOHoCcpkhR6nuaDY65z" %}
[Daily Emission API v2](/api-documents/api-endpoints/daily-emission-api/daily-emission-api-v2)
{% endcontent-ref %}

* Daily Emission API v1 ;

{% content-ref url="/pages/cXJ5rS1pE06GuRivIp9v" %}
[Daily Emission API v1](/api-documents/api-endpoints/daily-emission-api/daily-emission-api-v1)
{% endcontent-ref %}


# Daily Emission API v1

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v1/daily-emission
HEADER: x-api-key: <YOUR_API_KEY>
```

**Parameters**

Note: `tokenID` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* end (optional):   The end date for time filtering in the format YYYY-MM-DD. Defaults to the current date.

**Get Specific Date Range Example:**

Replace the preferred start and end dates in indicated format.

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/daily-emission?tokenId=arbitrum&start=YYYY-MM-DD&end=YYYY-MM-DD' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Get Full Data Range Example:**

Remove date completely to call the full range.

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/daily-emission?tokenId=arbitrum' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2024-08-20T04:53:46Z"
    },
    "status": true,
    "data": [
        {
            "startDate": "2024-08-20T00:00:00Z",
            "endDate": "2024-08-21T00:00:00Z",
            "tokenName": "Arbitrum",
            "tokenSymbol": "ARB",
            "unlockAmount": 478781.65092402464,
            "unlockValue": 259053.43030216015,
            "referencePrice": 0.541068,
            "allocations": [
                {
                    "allocationName": "Arbitrum DAO Treasury",
                    "standardAllocationName": "Reserve",
                    "unlockAmount": 478781.65092402464,
                    "unlockValue": 259053.43030216015
                }
            ],
            "totalCumulativeUnlockedAmount": 3259930660.716421
        },
        ....
    ]
}

```

The response includes time series data with the date (in UTC timezone), with granularity at the level of day.

**Return Fields Explanation**

| Fields                        | Data Type    | Description                                                 |
| ----------------------------- | ------------ | ----------------------------------------------------------- |
| startDate                     | timestamp    | Start date of the aggregated emission                       |
| endDate                       | timestamp    | End date of the aggregated emission                         |
| tokenName                     | string       | Token name                                                  |
| tokenSymbol                   | string       | Token symbol                                                |
| unlockAmount                  | number       | Total Unlock amount in date period                          |
| unlockValue                   | number       | Total unlock value in date period                           |
| referencePrice                | number       | Reference price for unlockValue calculation                 |
| allocations                   | object array |                                                             |
| totalCumulativeUnlockedAmount | number       | Total unlocked amount from token TGE till specified endDate |

**Return Fields Explanation: Allocations**

| Fields                 | Data Type | Description                            |
| ---------------------- | --------- | -------------------------------------- |
| allocationName         | string    | Allocation name                        |
| standardAllocationName | string    | Standard allocation of this allocation |
| UnlockedAmount         | number    | Total Unlock amount in date period     |
| UnlockedValue          | number    | Total unlock value in date period      |


# Daily Emission API v2

⬆️ v2 update: Add Dynamic inflation rate. \*value might differ to v1\* in some tokens

⬆️ v2 update: Provides more tokens that are listed with AI method. Add more field about  listing method, see below for field description

<table><thead><tr><th width="190">Listing Method</th><th>Definition</th></tr></thead><tbody><tr><td>INTERNAL</td><td>This token is listed and verified and cross checked across multiple sources by tokenomist</td></tr><tr><td>AI</td><td>This token has been listed using LLM assisted with single source. </td></tr><tr><td>EXTERNAL</td><td>This token is listed directly by the project team. It is first-party data and comes solely from the project's own source.</td></tr></tbody></table>

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v2/daily-emission
HEADER: x-api-key: <YOUR_API_KEY>
```

**Parameters**

Note: `tokenID` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* end (optional):   The end date for time filtering in the format YYYY-MM-DD. Defaults to the current date.

**Get Specific Date Range Example:**

Replace the preferred start and end dates in indicated format.

```
curl -X 'GET' \
  'https://api.unlocks.app/v2/daily-emission?tokenId=arbitrum&start=YYYY-MM-DD&end=YYYY-MM-DD' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Get Full Data Range Example:**

Remove date completely to call the full range.

```
curl -X 'GET' \
  'https://api.unlocks.app/v2/daily-emission?tokenId=arbitrum' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2026-01-08T10:19:12Z"
    },
    "status": true,
    "data": [
        {
            "startDate": "2024-01-08T00:00:00Z",
            "endDate": "2024-01-09T00:00:00Z",
            "tokenName": "Arbitrum",
            "tokenSymbol": "ARB",
            "listedMethod": "INTERNAL",
            "unlockAmount": 478781.65471694345,
            "unlockValue": 818716.6295659733,
            "referencePrice": 1.71,
            "allocations": [
                {
                    "allocationName": "Arbitrum DAO Treasury",
                    "standardAllocationName": "Reserve",
                    "unlockAmount": 478781.65471694345,
                    "unlockValue": 818716.6295659733
                }
            ],
            "totalCumulativeUnlockedAmount": 1527949623.5683928
        },
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of day.

**Return Fields Explanation**

| Fields                        | Data Type    | Description                                                 |
| ----------------------------- | ------------ | ----------------------------------------------------------- |
| startDate                     | timestamp    | Start date of the aggregated emission                       |
| endDate                       | timestamp    | End date of the aggregated emission                         |
| tokenName                     | string       | Token name                                                  |
| tokenSymbol                   | string       | Token symbol                                                |
| listedMethod                  | string       | Method of listing(INTERNAL, AI, EXTERNAL)                   |
| unlockAmount                  | number       | Total Unlock amount in date period                          |
| unlockValue                   | number       | Total unlock value in date period                           |
| referencePrice                | number       | Reference price for unlockValue calculation                 |
| allocations                   | object array |                                                             |
| totalCumulativeUnlockedAmount | number       | Total unlocked amount from token TGE till specified endDate |

**Return Fields Explanation: Allocations**

| Fields                 | Data Type | Description                            |
| ---------------------- | --------- | -------------------------------------- |
| allocationName         | string    | Allocation name                        |
| standardAllocationName | string    | Standard allocation of this allocation |
| unlockedAmount         | number    | Total Unlock amount in date period     |
| unlockedValue          | number    | Total unlock value in date period      |


# Weekly Emission API

There are 3 versions of the emission API endpoints.

* <mark style="background-color:yellow;">**Emission API v3 (Recommended) ; Provides more data from tokens with AI assisted**</mark>

{% content-ref url="/pages/YYoFo4VpyyK69HUG4pBL" %}
[Weekly Emission API v3](/api-documents/api-endpoints/weekly-emission-api/weekly-emission-api-v3)
{% endcontent-ref %}

* Emission API v2 ; Add more detailed allocations and unlocks.

{% content-ref url="/pages/e8y1zupGHdtvBP1gnGQb" %}
[Weekly Emission API v2](/api-documents/api-endpoints/weekly-emission-api/weekly-emission-api-v2)
{% endcontent-ref %}

* Emission API v1&#x20;

{% content-ref url="/pages/yzAZYHqSo6PyNxG1coNs" %}
[Weekly Emission API v1](/api-documents/api-endpoints/weekly-emission-api/weekly-emission-api-v1)
{% endcontent-ref %}


# Weekly Emission API v1

**Overview**

A weekly aggregated emission per token. The start date is expected to be a Sunday and end date a Saturday. This will include both linear and cliff unlocks that happened in the specified week.&#x20;

Included is the breakdown of beneficiaries into [standard allocation](https://docs.unlocks.app/docs/~/changes/Iamy4ACjYOBw6V1zBAnb/tokenunlocks-pro/standard-allocation), a Tokenomist™️ methodology for categorizing and grouping allocations from different projects into a comparable standard.

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v1/emission
HEADER: x-api-key: <YOUR_API_KEY>
```

## **Endpoints: Emission API v1** <a href="#endpoints" id="endpoints"></a>

**Parameters**

Note: `tokenId` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* end (optional):   The end date for time filtering in the format YYYY-MM-DD. Defaults to the current date.

**Get Specific Date Range Example:**

Replace the preferred start and end dates in indicated format.

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/emission?tokenId=optimisim&start=YYYY-MM-DD&end=YYYY-MM-DD' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Get Full Data Range Example:**

Remove date completely to call the full range.

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/emission?tokenId=optimisim' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2024-06-24T13:31:20Z"
    },
    "status": true,
    "data": [
        {
            "startDate": "2023-06-25T00:00:00Z",
            "endDate": "2023-07-02T00:00:00Z",
            "tokenName": "Optimism",
            "tokenSymbol": "OP",
            "unlockAmount": 31341653,
            "unlockValue": 40744148.9,
            "referencePrice": 1.3,
            "allocations": [
                "Core Contributors",
                "Investors"
            ],
            "standardAllocations": [
                "Founder / Team",
                "Private Investors"
            ]
        },
        {
            "startDate": "2023-07-02T00:00:00Z",
            "endDate": "2023-07-09T00:00:00Z",
            "tokenName": "Optimism",
            "tokenSymbol": "OP",
            "unlockAmount": 0,
            "unlockValue": 0,
            "referencePrice": 1.34,
            "allocations": [],
            "standardAllocations": []
        },
        {
            "startDate": "2023-07-09T00:00:00Z",
            "endDate": "2023-07-16T00:00:00Z",
            "tokenName": "Optimism",
            "tokenSymbol": "OP",
            "unlockAmount": 1683000,
            "unlockValue": 2036430,
            "referencePrice": 1.21,
            "allocations": [
                "Governance Fund"
            ],
            "standardAllocations": [
                "Community"
            ]
        },
        {
            "startDate": "2023-07-16T00:00:00Z",
            "endDate": "2023-07-23T00:00:00Z",
            "tokenName": "Optimism",
            "tokenSymbol": "OP",
            "unlockAmount": 0,
            "unlockValue": 0,
            "referencePrice": 1.45,
            "allocations": [],
            "standardAllocations": []
        },
        ...
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

**Return Fields Explanation**

| Fields              | Data Type    | Description                                 |
| ------------------- | ------------ | ------------------------------------------- |
| startDate           | timestamp    | Start date of the aggregated emission       |
| endDate             | timestamp    | End date of the aggregated emission         |
| tokenName           | string       | Token name                                  |
| tokenSymbol         | string       | Token symbol                                |
| unlockAmount        | number       | Total Unlock amount within specified period |
| unlockValue         | number       | Total Unlock value within specified period  |
| referencePrice      | number       | Reference price for unlockValue calculation |
| allocations         | object array | Allocation name                             |
| standardAllocations | object array | Standard allocation of this allocation      |


# Weekly Emission API v2

**Overview**

A weekly aggregated emission per token. The start date is expected to be a Sunday and end date a Saturday. This will include both linear and cliff unlocks that happened in the specified week.&#x20;

Included is the breakdown of beneficiaries into [standard allocation](https://docs.unlocks.app/docs/~/changes/Iamy4ACjYOBw6V1zBAnb/tokenunlocks-pro/standard-allocation), a Tokenomist™️ methodology for categorizing and grouping allocations from different projects into a comparable standard.

⬆️ v2 update: Provides more detailed breakdown of unlock amount and unlock value within the 'allocations' field.

See below for each field description.

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v2/emission
HEADER: x-api-key: <YOUR_API_KEY>
```

## **Endpoints: Emission API v2** <a href="#endpoints" id="endpoints"></a>

**Parameters**

Note: `tokenID` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* end (optional):   The end date for time filtering in the format YYYY-MM-DD. Defaults to the current date.

**Get Specific Date Range Example:**

Replace the preferred start and end dates in indicated format.&#x20;

Including breakdown of : allocationName, standardAllocationName, unlockAmount, unlockValue, and totalCumulativeUnlockedAmount. See below for each field definitions.

```
curl -X 'GET' \
  'https://api.unlocks.app/v2/emission?tokenId=arbitrum&start=YYYY-MM-DD&end=YYYY-MM-DD' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Get Full Data Range Example:**

Remove date completely to call the full range.

```
curl -X 'GET' \
  'https://api.unlocks.app/v2/emission?tokenId=arbitrum' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2024-08-20T08:18:14Z"
    },
    "status": true,
    "data": [
              {
                "startDate": "2026-10-11T00:00:00Z",
                "endDate": "2026-10-18T00:00:00Z",
                "tokenName": "Arbitrum",
                "tokenSymbol": "ARB",
                "unlockAmount": 95997304.55646817,
                "unlockValue": 52539420.78105959,
                "referencePrice": 0.547301,
                "allocations": [
                  {
                    "allocationName": "Team, Future Team + Advisors",
                    "standardAllocationName": "Founder / Team",
                    "unlockAmount": 56125000,
                    "unlockValue": 30717268.625000004
                  },
                  {
                    "allocationName": "Investors",
                    "standardAllocationName": "Private Investors",
                    "unlockAmount": 36520833,
                    "unlockValue": 19987888.421733003
                  },
                  {
                    "allocationName": "Arbitrum DAO Treasury",
                    "standardAllocationName": "Reserve",
                    "unlockAmount": 3351471.556468172,
                    "unlockValue": 1834263.734326587
                  }
                ],
                "totalCumulativeUnlockedAmount": 6046002268.244544
              },
              {
                "startDate": "2026-10-18T00:00:00Z",
                "endDate": "2026-10-25T00:00:00Z",
                "tokenName": "Arbitrum",
                "tokenSymbol": "ARB",
                "unlockAmount": 3351471.556468172,
                "unlockValue": 1834263.734326587,
                "referencePrice": 0.547301,
                "allocations": [
                  {
                    "allocationName": "Arbitrum DAO Treasury",
                    "standardAllocationName": "Reserve",
                    "unlockAmount": 3351471.556468172,
                    "unlockValue": 1834263.734326587
                  }
                ],
                "totalCumulativeUnlockedAmount": 6049353739.801012
              },
              {
                "startDate": "2026-10-25T00:00:00Z",
                "endDate": "2026-11-01T00:00:00Z",
                "tokenName": "Arbitrum",
                "tokenSymbol": "ARB",
                "unlockAmount": 3351471.556468172,
                "unlockValue": 1834263.734326587,
                "referencePrice": 0.547301,
                "allocations": [
                  {
                    "allocationName": "Arbitrum DAO Treasury",
                    "standardAllocationName": "Reserve",
                    "unlockAmount": 3351471.556468172,
                    "unlockValue": 1834263.734326587
                  }
                ],
                "totalCumulativeUnlockedAmount": 6052705211.35748
              },
        ...
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

**Return Fields Explanation**

<table><thead><tr><th width="336">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>startDate</td><td>timestamp</td><td>Start date of the aggregated emission</td></tr><tr><td>endDate</td><td>timestamp</td><td>End date of the aggregated emission</td></tr><tr><td>tokenName</td><td>string</td><td>Token name</td></tr><tr><td>tokenSymbol</td><td>string</td><td>Token symbol</td></tr><tr><td>unlockAmount</td><td>number</td><td>Total Unlock amount in date period</td></tr><tr><td>unlockValue</td><td>number</td><td>Total unlock value in date period</td></tr><tr><td>referencePrice</td><td>number</td><td>Reference price for unlockValue calculation</td></tr><tr><td>allocations</td><td>object array</td><td>Expand allocation details</td></tr><tr><td>totalCumulativeUnlockedAmount</td><td>number</td><td>Total unlocked amount from token TGE till specified endDate</td></tr></tbody></table>

**Return Fields Explanation: Allocations**

| Fields                 | Data Type | Description                            |
| ---------------------- | --------- | -------------------------------------- |
| allocationName         | string    | Allocation name                        |
| standardAllocationName | string    | Standard allocation of this allocation |
| unlockedAmount         | number    | Total Unlock amount in date period     |
| unlockedValue          | number    | Total unlock value in date period      |


# Weekly Emission API v3

**Overview**

A weekly aggregated emission per token. The start date is expected to be a Sunday and end date a Saturday. This will include both linear and cliff unlocks that happened in the specified week.&#x20;

Included is the breakdown of beneficiaries into [standard allocation](https://docs.unlocks.app/docs/~/changes/Iamy4ACjYOBw6V1zBAnb/tokenunlocks-pro/standard-allocation), a Tokenomist™️ methodology for categorizing and grouping allocations from different projects into a comparable standard.

⬆️ v3 update: Provides more tokens that are listed with AI method. Add more field about  listing method, see below for field description

<table><thead><tr><th width="190">Listing Method</th><th>Definition</th></tr></thead><tbody><tr><td>INTERNAL</td><td>This token is listed and verified and cross checked across multiple sources by tokenomist</td></tr><tr><td>AI</td><td>This token has been listed using LLM assisted with single source. </td></tr><tr><td>EXTERNAL</td><td>This token is listed directly by the project team. It is first-party data and comes solely from the project's own source.</td></tr></tbody></table>

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v3/emission
HEADER: x-api-key: <YOUR_API_KEY>
```

## **Endpoints: Emission API v3** <a href="#endpoints" id="endpoints"></a>

**Parameters**

Note: `tokenID` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* end (optional):   The end date for time filtering in the format YYYY-MM-DD. Defaults to the current date.

**Get Specific Date Range Example:**

Replace the preferred start and end dates in indicated format.&#x20;

Including breakdown of : allocationName, standardAllocationName, unlockAmount, unlockValue, and totalCumulativeUnlockedAmount. See below for each field definitions.

```
curl -X 'GET' \
  'https://api.unlocks.app/v3/emission?tokenId=arbitrum&start=YYYY-MM-DD&end=YYYY-MM-DD' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Get Full Data Range Example:**

Remove date completely to call the full range.

```
curl -X 'GET' \
  'https://api.unlocks.app/v3/emission?tokenId=arbitrum' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```
{
                "startDate": "2026-10-11T00:00:00Z",
                "endDate": "2026-10-18T00:00:00Z",
                "tokenName": "Arbitrum",
                "tokenSymbol": "ARB",
                "listedMethod": "INTERNAL",
                "unlockAmount": 95997304.55646817,
                "unlockValue": 52539420.78105959,
                "referencePrice": 0.547301,
                "allocations": [
                  {
                    "allocationName": "Team, Future Team + Advisors",
                    "standardAllocationName": "Founder / Team",
                    "unlockAmount": 56125000,
                    "unlockValue": 30717268.625000004
                  },
                  {
                    "allocationName": "Investors",
                    "standardAllocationName": "Private Investors",
                    "unlockAmount": 36520833,
                    "unlockValue": 19987888.421733003
                  },
                  {
                    "allocationName": "Arbitrum DAO Treasury",
                    "standardAllocationName": "Reserve",
                    "unlockAmount": 3351471.556468172,
                    "unlockValue": 1834263.734326587
                  }
                ],
                "totalCumulativeUnlockedAmount": 6046002268.244544
              }
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

**Return Fields Explanation**

<table><thead><tr><th width="336">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>startDate</td><td>timestamp</td><td>Start date of the aggregated emission</td></tr><tr><td>endDate</td><td>timestamp</td><td>End date of the aggregated emission</td></tr><tr><td>tokenName</td><td>string</td><td>Token name</td></tr><tr><td>tokenSymbol</td><td>string</td><td>Token symbol</td></tr><tr><td>listedMethod</td><td>string</td><td>Method of listing(INTERNAL, AI, EXTERNAL)</td></tr><tr><td>unlockAmount</td><td>number</td><td>Total Unlock amount in date period</td></tr><tr><td>unlockValue</td><td>number</td><td>Total unlock value in date period</td></tr><tr><td>referencePrice</td><td>number</td><td>Reference price for unlockValue calculation</td></tr><tr><td>allocations</td><td>object array</td><td>Expand allocation details</td></tr><tr><td>totalCumulativeUnlockedAmount</td><td>number</td><td>Total unlocked amount from token TGE till specified endDate</td></tr></tbody></table>

**Return Fields Explanation: Allocations**

| Fields                 | Data Type | Description                            |
| ---------------------- | --------- | -------------------------------------- |
| allocationName         | string    | Allocation name                        |
| standardAllocationName | string    | Standard allocation of this allocation |
| unlockedAmount         | number    | Total Unlock amount in date period     |
| unlockedValue          | number    | Total unlock value in date period      |


# Unlock Events API

**Overview**

This endpoint is the timestamp information of the unlock events start date. This dataset is the only dataset with timestamp information of the unlocks

There are 4 versions of Unlock Events API

* <mark style="background-color:yellow;">**Unlock Events API v4 (Recommended) ; Reflect to updated frontend > Remove start of linear**</mark> <mark style="background-color:yellow;"></mark> <mark style="background-color:yellow;">**and mining rewards  (only contain cliff unlocks)**</mark>

{% content-ref url="/pages/rFdpYaMWCU0IiRbUU7x0" %}
[Unlock Events API v4](/api-documents/api-endpoints/unlock-events-api/unlock-events-api-v4)
{% endcontent-ref %}

* Unlock Events API v3 ; Provides more data from tokens with AI assisted

{% content-ref url="/pages/UovQVsW7GUyxwRX1fNHH" %}
[Unlock Events API v3](/api-documents/api-endpoints/unlock-events-api/unlock-events-api-v3)
{% endcontent-ref %}

* Unlock Events API v2 ; reflect to updated frontend -> Remove linear change rate

{% content-ref url="/pages/Uv9FlNRngcQ8sbKR1Dd8" %}
[Unlock Events API v2](/api-documents/api-endpoints/unlock-events-api/unlock-events-api-v2)
{% endcontent-ref %}

* Unlock Events API v1 ;

{% content-ref url="/pages/SwDLDoON0PYc9UtXg3NT" %}
[Unlock Events API v1](/api-documents/api-endpoints/unlock-events-api/unlock-events-api-v1)
{% endcontent-ref %}


# Unlock Events API v1

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v1/unlock/events
HEADER: x-api-key: <YOUR_API_KEY>
```

**Parameters**

Note: `tokenID` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* end (optional):   The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/unlock/events?tokenId=arbitrum' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2024-08-20T08:19:20Z"
    },
    "status": true,
    "data": [
        {
            "unlockDate": "2024-09-16T13:00:00Z",
            "tokenName": "Arbitrum",
            "tokenSymbol": "ARB",
            "dataSource": "Whitepaper",
            "linearUnlocks": null,
            "cliffUnlocks": {
                "cliffAmount": 92645833.29999995,
                "cliffValue": 49929711.58620228,
                "referencePrice": 0.538931,
                "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                "valueToMarketCap": 2.7744266354166256,
                "allocationBreakdown": [
                    {
                        "unlockDate": "2024-09-16T13:00:00Z",
                        "allocationName": "Investors",
                        "standardAllocationName": "Private Investors",
                        "cliffAmount": 36520833.29999995,
                        "cliffValue": 19682209.211202275,
                        "referencePrice": 0.538931,
                        "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                        "unlockPrecision": "month"
                    },
                    {
                        "unlockDate": "2024-09-16T13:00:00Z",
                        "allocationName": "Team, Future Team + Advisors",
                        "standardAllocationName": "Founder / Team",
                        "cliffAmount": 56125000,
                        "cliffValue": 30247502.375000004,
                        "referencePrice": 0.538931,
                        "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                        "unlockPrecision": "month"
                    }
                ]
            },
            "latestUpdateDate": "2024-06-11T08:49:27Z"
        },
        ...
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of day.

**Return Fields Explanation**

| Fields           | Data Type    | Description                         |
| ---------------- | ------------ | ----------------------------------- |
| unlockDate       | timestamp    | Date of the Unlock Event            |
| tokenName        | string       | Token Name                          |
| tokenSymbol      | string       | Token Symbol                        |
| dataSource       | string       | Data Source of the Token            |
| linearUnlocks    | object array | Linear Unlocks in this unlock event |
| cliffUnlocks     | object array | Cliff Unlocks in this unlock event  |
| latestUpdateDate | timestamp    | Unlocks Data Latest Update time     |

**Return Fields Explanation:&#x20;**<mark style="background-color:orange;">**Linear Unlocks**</mark>

| Fields                    | Data Type    | Description                                      |
| ------------------------- | ------------ | ------------------------------------------------ |
| linearAmount              | number       | Linear Unlocks Amount Denominated in Token       |
| linearValue               | number       | Linear Unlocks Amount Denominated in USD         |
| dailyAmount               | number       | Daily Linear Unlocks Amount Denominated in Token |
| dailyValue                | number       | Daily Linear Unlocks Amount Denominated in USD   |
| referencePrice            | number       | Reference Price used in daily value calculation  |
| referencePriceUpdatedTime | timestamp    | Reference Price Last Updated Time                |
| allocationBreakdown       | object array | Unlocks data breakdown by each allocation        |

**Return Fields Explanation: Linear Allocation breakdown**

| Fields                 | Data Type | Description                                               |
| ---------------------- | --------- | --------------------------------------------------------- |
| allocationName         | string    | Allocation Name                                           |
| standardAllocationName | string    | Standard allocation of this allocation                    |
| linearAmount           | number    | Total Linear Unlocks Amount in token                      |
| linearValue            | number    | Total Linear Unlocks Value in USD                         |
| durationOfRate         | number    | Duration of Linear Rate                                   |
| beginDate              | timestamp | Begin date of the linear unlock                           |
| endDate                | timestamp | End date of the linear unlock                             |
| unlockPrecision        | string    | Precision of Unlock. Example: second, hour, day, week etc |

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Cliff Unlocks**</mark>

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>cliffAmount</td><td>number</td><td>Total Unlock Amount Denominated in token</td></tr><tr><td>cliffValue</td><td>number</td><td>Total Unlock Value Denominated in USD</td></tr><tr><td>referencePrice</td><td>number</td><td>Reference Price used in total unlocks value calculation</td></tr><tr><td>referencePriceUpdatedTime</td><td>timestamp</td><td>Reference Price Last Updated Time</td></tr><tr><td>valueToMarketCap</td><td>number</td><td>Value / M.Cap in Percentage</td></tr><tr><td>allocationBreakdown</td><td>object array</td><td>Allocation Breakdown</td></tr><tr><td>unlockDate</td><td>timestamp</td><td>Cliff unlock date</td></tr><tr><td>allocationName</td><td>string</td><td>Allocation Name</td></tr><tr><td>standardAllocationName</td><td>string</td><td>Standard allocation of this allocation</td></tr><tr><td>cliffAmount</td><td>number</td><td>Unlock Amount Denominated in Token</td></tr><tr><td>cliffValue</td><td>number</td><td>Unlock Value Denominated in USD</td></tr><tr><td>unlockPrecision</td><td>string</td><td>Precision of Unlock. Example: second, hour, day, week etc</td></tr></tbody></table>

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Cliff**</mark>**&#x20;Allocation breakdown**

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>allocationName</td><td>string</td><td>Allocation Name</td></tr><tr><td>standardAllocationName</td><td>string</td><td>Standard allocation of this allocation</td></tr><tr><td>cliffAmount</td><td>number</td><td>Unlock Amount Denominated in Token</td></tr><tr><td>cliffValue</td><td>number</td><td>Unlock Value Denominated in USD</td></tr><tr><td>unlockPrecision</td><td>string</td><td>Precision of Unlock. Example: second, hour, day, week etc</td></tr></tbody></table>


# Unlock Events API v2

⬆️ v2 update: Remove Linear change rate events -> reflect to updated frontend

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v2/unlock/events
HEADER: x-api-key: <YOUR_API_KEY>
```

**Parameters**

Note: `tokenID` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* end (optional):   The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v2/unlock/events?tokenId=arbitrum' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2024-08-20T08:19:20Z"
    },
    "status": true,
    "data": [
        {
            "unlockDate": "2024-09-16T13:00:00Z",
            "tokenName": "Arbitrum",
            "tokenSymbol": "ARB",
            "listedMethod": "INTERNAL",
            "dataSource": "Whitepaper",
            "linearUnlocks": null,
            "cliffUnlocks": {
                "cliffAmount": 92645833.29999995,
                "cliffValue": 49929711.58620228,
                "referencePrice": 0.538931,
                "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                "valueToMarketCap": 2.7744266354166256,
                "allocationBreakdown": [
                    {
                        "unlockDate": "2024-09-16T13:00:00Z",
                        "allocationName": "Investors",
                        "standardAllocationName": "Private Investors",
                        "cliffAmount": 36520833.29999995,
                        "cliffValue": 19682209.211202275,
                        "referencePrice": 0.538931,
                        "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                        "unlockPrecision": "month"
                    },
                    {
                        "unlockDate": "2024-09-16T13:00:00Z",
                        "allocationName": "Team, Future Team + Advisors",
                        "standardAllocationName": "Founder / Team",
                        "cliffAmount": 56125000,
                        "cliffValue": 30247502.375000004,
                        "referencePrice": 0.538931,
                        "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                        "unlockPrecision": "month"
                    }
                ]
            },
            "latestUpdateDate": "2024-06-11T08:49:27Z"
        },
        ...
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of day.

**Return Fields Explanation**

| Fields           | Data Type    | Description                         |
| ---------------- | ------------ | ----------------------------------- |
| unlockDate       | timestamp    | Date of the Unlock Event            |
| tokenName        | string       | Token Name                          |
| tokenSymbol      | string       | Token Symbol                        |
| listedMethod     | string       | Human/Ai                            |
| dataSource       | string       | Data Source of the Token            |
| linearUnlocks    | object array | Linear Unlocks in this unlock event |
| cliffUnlocks     | object array | Cliff Unlocks in this unlock event  |
| latestUpdateDate | timestamp    | Unlocks Data Latest Update time     |

**Return Fields Explanation:&#x20;**<mark style="background-color:orange;">**Linear Unlocks**</mark>

| Fields                    | Data Type    | Description                                               |
| ------------------------- | ------------ | --------------------------------------------------------- |
| linearAmount              | number       | Linear Unlocks Amount Denominated in Token                |
| linearValue               | number       | Linear Unlocks Amount Denominated in USD                  |
| dailyAmount               | number       | Daily Linear Unlocks Amount Denominated in Token          |
| dailyValue                | number       | Daily Linear Unlocks Amount Denominated in USD            |
| referencePrice            | number       | Reference Price used in daily value calculation           |
| referencePriceUpdatedTime | timestamp    | Reference Price Last Updated Time                         |
| allocationBreakdown       | object array | Unlocks data breakdown by each allocation                 |
| allocationName            | string       | Allocation Name                                           |
| standardAllocationName    | string       | Standard allocation of this allocation                    |
| linearAmount              | number       | Total Linear Unlocks Amount in token                      |
| linearValue               | number       | Total Linear Unlocks Value in USD                         |
| durationOfRate            | number       | Duration of Linear Rate                                   |
| beginDate                 | timestamp    | Begin date of the linear unlock                           |
| endDate                   | timestamp    | End date of the linear unlock                             |
| unlockPrecision           | string       | Precision of Unlock. Example: second, hour, day, week etc |

**Return Fields Explanation: Linear Allocation Breakdown**

| Fields                 | Data Type | Description                                               |
| ---------------------- | --------- | --------------------------------------------------------- |
| allocationName         | string    | Allocation Name                                           |
| standardAllocationName | string    | Standard allocation of this allocation                    |
| linearAmount           | number    | Total Linear Unlocks Amount in token                      |
| linearValue            | number    | Total Linear Unlocks Value in USD                         |
| durationOfRate         | number    | Duration of Linear Rate                                   |
| beginDate              | timestamp | Begin date of the linear unlock                           |
| endDate                | timestamp | End date of the linear unlock                             |
| unlockPrecision        | string    | Precision of Unlock. Example: second, hour, day, week etc |

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Cliff Unlocks**</mark>

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>cliffAmount</td><td>number</td><td>Total Unlock Amount Denominated in token</td></tr><tr><td>cliffValue</td><td>number</td><td>Total Unlock Value Denominated in USD</td></tr><tr><td>referencePrice</td><td>number</td><td>Reference Price used in total unlocks value calculation</td></tr><tr><td>referencePriceUpdatedTime</td><td>timestamp</td><td>Reference Price Last Updated Time</td></tr><tr><td>valueToMarketCap</td><td>number</td><td>Value / M.Cap in Percentage</td></tr><tr><td>allocationBreakdown</td><td>object array</td><td>Allocation Breakdown</td></tr></tbody></table>

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Cliff Allocation Breakdown**</mark>

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>unlockDate</td><td>timestamp</td><td>Cliff unlock date</td></tr><tr><td>allocationName</td><td>string</td><td>Allocation Name</td></tr><tr><td>standardAllocationName</td><td>string</td><td>Standard allocation of this allocation</td></tr><tr><td>cliffAmount</td><td>number</td><td>Unlock Amount Denominated in Token</td></tr><tr><td>cliffValue</td><td>number</td><td>Unlock Value Denominated in USD</td></tr><tr><td>unlockPrecision</td><td>string</td><td>Precision of Unlock. Example: second, hour, day, week etc</td></tr></tbody></table>


# Unlock Events API v3

⬆️ v3 update: Provides more tokens that are listed with AI method. Add more field about  listing method, see below for field description

<table><thead><tr><th width="190">Listing Method</th><th>Definition</th></tr></thead><tbody><tr><td>INTERNAL</td><td>This token is listed and verified and cross checked across multiple sources by tokenomist</td></tr><tr><td>AI</td><td>This token has been listed using LLM assisted with single source. </td></tr><tr><td>EXTERNAL</td><td>This token is listed directly by the project team. It is first-party data and comes solely from the project's own source.</td></tr></tbody></table>

*\*unlockPrecision for* AI *listed token might be unknown*

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v3/unlock/events
HEADER: x-api-key: <YOUR_API_KEY>
```

**Parameters**

Note: `tokenID` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* end (optional):   The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v3/unlock/events?tokenId=arbitrum' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2024-08-20T08:19:20Z"
    },
    "status": true,
    "data": [
        {
            "unlockDate": "2024-09-16T13:00:00Z",
            "tokenName": "Arbitrum",
            "tokenSymbol": "ARB",
            "listedMethod": "INTERNAL",
            "dataSource": "Whitepaper",
            "linearUnlocks": null,
            "cliffUnlocks": {
                "cliffAmount": 92645833.29999995,
                "cliffValue": 49929711.58620228,
                "referencePrice": 0.538931,
                "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                "valueToMarketCap": 2.7744266354166256,
                "allocationBreakdown": [
                    {
                        "unlockDate": "2024-09-16T13:00:00Z",
                        "allocationName": "Investors",
                        "standardAllocationName": "Private Investors",
                        "cliffAmount": 36520833.29999995,
                        "cliffValue": 19682209.211202275,
                        "referencePrice": 0.538931,
                        "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                        "unlockPrecision": "month"
                    },
                    {
                        "unlockDate": "2024-09-16T13:00:00Z",
                        "allocationName": "Team, Future Team + Advisors",
                        "standardAllocationName": "Founder / Team",
                        "cliffAmount": 56125000,
                        "cliffValue": 30247502.375000004,
                        "referencePrice": 0.538931,
                        "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                        "unlockPrecision": "month"
                    }
                ]
            },
            "latestUpdateDate": "2024-06-11T08:49:27Z"
        },
        ...
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of day.

**Return Fields Explanation**

| Fields           | Data Type    | Description                         |
| ---------------- | ------------ | ----------------------------------- |
| unlockDate       | timestamp    | Date of the Unlock Event            |
| tokenName        | string       | Token Name                          |
| tokenSymbol      | string       | Token Symbol                        |
| listedMethod     | string       | Human/AI                            |
| dataSource       | string       | Data Source of the Token            |
| linearUnlocks    | object array | Linear Unlocks in this unlock event |
| cliffUnlocks     | object array | Cliff Unlocks in this unlock event  |
| latestUpdateDate | timestamp    | Unlocks Data Latest Update time     |

**Return Fields Explanation:&#x20;**<mark style="background-color:orange;">**Linear Unlocks**</mark>

| Fields                    | Data Type    | Description                                      |
| ------------------------- | ------------ | ------------------------------------------------ |
| linearAmount              | number       | Linear Unlocks Amount Denominated in Token       |
| linearValue               | number       | Linear Unlocks Amount Denominated in USD         |
| dailyAmount               | number       | Daily Linear Unlocks Amount Denominated in Token |
| dailyValue                | number       | Daily Linear Unlocks Amount Denominated in USD   |
| referencePrice            | number       | Reference Price used in daily value calculation  |
| referencePriceUpdatedTime | timestamp    | Reference Price Last Updated Time                |
| allocationBreakdown       | object array | Unlocks data breakdown by each allocation        |

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Linear Allocation Breakdown**</mark>

| Fields                    | Data Type | Description                                                                                   |
| ------------------------- | --------- | --------------------------------------------------------------------------------------------- |
| allocationName            | string    | Allocation Name                                                                               |
| standardAllocationName    | string    | Standard allocation of this allocation                                                        |
| linearAmount              | number    | Total Linear Unlocks Amount in token                                                          |
| linearValue               | number    | Total Linear Unlocks Value in USD                                                             |
| referencePrice            | number    | Reference price of the token value calculation                                                |
| referencePriceUpdatedTime | string    | Reference price updated time                                                                  |
| dailyAmount               | number    | Amount of a token that is unlocked and readily claimable into circulation at any time         |
| dailyValue                | number    | Value of the unlocked supply in the public market                                             |
| durationOfRate            | number    | Duration of Linear Rate                                                                       |
| beginDate                 | timestamp | Begin date of the linear unlock                                                               |
| endDate                   | timestamp | End date of the linear unlock                                                                 |
| unlockPrecision           | string    | Precision of Unlock. Example: second, hour, day, week, unknown(for AI listed token only), etc |

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Cliff Unlocks**</mark>

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>cliffAmount</td><td>number</td><td>Total Unlock Amount Denominated in token</td></tr><tr><td>cliffValue</td><td>number</td><td>Total Unlock Value Denominated in USD</td></tr><tr><td>referencePrice</td><td>number</td><td>Reference Price used in total unlocks value calculation</td></tr><tr><td>referencePriceUpdatedTime</td><td>timestamp</td><td>Reference Price Last Updated Time</td></tr><tr><td>valueToMarketCap</td><td>number</td><td>Value / M.Cap in Percentage</td></tr><tr><td>allocationBreakdown</td><td>object array</td><td>Allocation Breakdown</td></tr></tbody></table>

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Cliff Allocation Breakdown**</mark>

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>unlockDate</td><td>timestamp</td><td>Cliff unlock date</td></tr><tr><td>allocationName</td><td>string</td><td>Allocation Name</td></tr><tr><td>standardAllocationName</td><td>string</td><td>Standard allocation of this allocation</td></tr><tr><td>cliffAmount</td><td>number</td><td>Unlock Amount Denominated in Token</td></tr><tr><td>cliffValue</td><td>number</td><td>Unlock Value Denominated in USD</td></tr><tr><td>referencePrice</td><td>number</td><td>Reference Price used in total unlocks value calculation</td></tr><tr><td>referencePriceUpdatedTime</td><td>timestamp</td><td>Reference Price Last Updated Time</td></tr><tr><td>unlockPrecision</td><td>string</td><td>Precision of Unlock. Example: second, hour, day, week, unknown(for AI listed token only), etc</td></tr></tbody></table>


# Unlock Events API v4

⬆️ v4 update: Show only cliff unlocks, remove start of Linear unlocks and unlocks event with mining rewards  and yield farming distribution methods. See below link for definition of Release Mechanism

{% content-ref url="/pages/PpdQwCInKjlrDyQ1PUXe" %}
[Release Mechanism](/tokenomist-pro/release-mechanism)
{% endcontent-ref %}

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v4/unlock/events
HEADER: x-api-key: <YOUR_API_KEY>
```

**Parameters**

Note: `tokenID` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults is the earliest available date.
* end (optional):   The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v4/unlock/events?tokenId=arbitrum' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2024-08-20T08:19:20Z"
    },
    "status": true,
    "data": [
        {
            "unlockDate": "2024-09-16T13:00:00Z",
            "tokenName": "Arbitrum",
            "tokenSymbol": "ARB",
            "listedMethod": "INTERNAL",
            "dataSource": "Whitepaper",
            "linearUnlocks": null,
            "cliffUnlocks": {
                "cliffAmount": 92645833.29999995,
                "cliffValue": 49929711.58620228,
                "valueToMarketCap": 2.7744266354166256,
                "allocationBreakdown": [
                    {
                        "unlockDate": "2024-09-16T13:00:00Z",
                        "allocationName": "Investors",
                        "standardAllocationName": "Private Investors",
                        "cliffAmount": 36520833.29999995,
                        "cliffValue": 19682209.211202275,
                        "referencePrice": 0.538931,
                        "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                        "unlockPrecision": "month"
                    },
                    {
                        "unlockDate": "2024-09-16T13:00:00Z",
                        "allocationName": "Team, Future Team + Advisors",
                        "standardAllocationName": "Founder / Team",
                        "cliffAmount": 56125000,
                        "cliffValue": 30247502.375000004,
                        "referencePrice": 0.538931,
                        "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
                        "unlockPrecision": "month"
                    }
                ]
            },
            "latestUpdateDate": "2024-06-11T08:49:27Z"
        },
        ...
    ]
}
```

The response includes time series data with the date (in UTC timezone), with granularity at the level of day.

**Return Fields Explanation**

| Fields           | Data Type    | Description                        |
| ---------------- | ------------ | ---------------------------------- |
| unlockDate       | timestamp    | Date of the Unlock Event           |
| tokenName        | string       | Token Name                         |
| tokenSymbol      | string       | Token Symbol                       |
| listedMethod     | string       | Human/AI                           |
| dataSource       | string       | Data Source of the Token           |
| cliffUnlocks     | object array | Cliff Unlocks in this unlock event |
| latestUpdateDate | timestamp    | Unlocks Data Latest Update time    |

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Cliff Unlocks**</mark>

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>cliffAmount</td><td>number</td><td>Total Unlock Amount Denominated in token</td></tr><tr><td>cliffValue</td><td>number</td><td>Total Unlock Value Denominated in USD</td></tr><tr><td>valueToMarketCap</td><td>number</td><td>Value / M.Cap in Percentage</td></tr><tr><td>allocationBreakdown</td><td>object array</td><td>Allocation Breakdown</td></tr></tbody></table>

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Cliff Allocation Breakdown**</mark>

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>unlockDate</td><td>timestamp</td><td>Cliff unlock date</td></tr><tr><td>allocationName</td><td>string</td><td>Allocation Name</td></tr><tr><td>standardAllocationName</td><td>string</td><td>Standard allocation of this allocation</td></tr><tr><td>cliffAmount</td><td>number</td><td>Unlock Amount Denominated in Token</td></tr><tr><td>cliffValue</td><td>number</td><td>Unlock Value Denominated in USD</td></tr><tr><td>referencePrice</td><td>number</td><td>Reference Price used in total unlocks value calculation</td></tr><tr><td>referencePriceUpdatedTime</td><td>timestamp</td><td>Reference Price Last Updated Time</td></tr><tr><td>unlockPrecision</td><td>string</td><td>Precision of Unlock. Example: second, hour, day, week, unknown(for AI listed token only), etc</td></tr></tbody></table>


# Upcoming Unlock Events API

**Overview**

This endpoint is the timestamp information of the upcoming unlock events. This dataset is the same scheme to [Unlock Events API](/api-documents/api-endpoints/unlock-events-api) but sort by upcoming time, similar [Homepage](https://tokenomist.ai/?preset=default-all_unlocks)

There are 4 versions of Unlock Events API

* <mark style="background-color:yellow;">**Upcoming Unlock Events API v1; Reflect to frontend**</mark> [<mark style="background-color:yellow;">**Upcoming Unlocks**</mark>](https://tokenomist.ai/?preset=default-all_unlocks)<mark style="background-color:yellow;">**(default filter)**</mark>

{% content-ref url="/pages/rFdpYaMWCU0IiRbUU7x0" %}
[Unlock Events API v4](/api-documents/api-endpoints/unlock-events-api/unlock-events-api-v4)
{% endcontent-ref %}


# Upcoming Unlock Events API v1

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v1/unlock/events/upcoming
HEADER: x-api-key: <YOUR_API_KEY>
```

**Parameters**

* minMarketCap (optional): Filter out tokens below a certain market cap
* minReleasedPercentage (optional): Filter out tokens below a certain percentage of released supply from 0-100
* minUnlockDate (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults is the earliest available date.
* maxUnlockDate (optional): The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.
* minTotalUnlockAmount (optional): Filter out unlocks below a certain amount
* minValueToMarketCap (optional): Filter out unlocks below a certain value market cap from 0-100
* standardAllocation (optional): Filter the receiver's allocation. Choose from these enums, can be multi-select: community, founderTeam, privateInvestors, publicInvestors, reserve, others

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/unlock/events/upcoming
  -H 'x-api-key: $YOUR_API_KEY'
```

<figure><img src="/files/xLn7bTCvWo3Tia8rSDhW" alt=""><figcaption></figcaption></figure>

**Response**

<pre class="language-json"><code class="lang-json">{
    "metadata": {
        "queryDate": "2025-11-20T07:22:41Z"
    },
    "status": true,
    "data": [
        {
            "tokenId": "layerzero",
            "tokenName": "LayerZero",
            "tokenSymbol": "ZRO",
            "marketCap": 278811255,
            "releasedPercentage": 35.2833333550565,
            "listedMethod": "INTERNAL",
            "dataSource": "Whitepaper",
            "upcomingEvent": {
                "unlockDate": "2025-11-20T11:00:00Z",
                "referencePrice": 1.4,
                "referencePriceUpdatedTime": "2025-11-20T00:00:00Z",
                "cliffUnlocks": {
                    "totalCliffAmount": 25708332.666,
                    "totalCliffValue": 35991665.7324,
                    "valueToMarketCap": 12.908971602455575,
                    "allocationBreakdown": [
                        {
<strong>                            "allocationName": "Tokens Repurchased",
</strong>                            "standardAllocationName": "Community",
                            "cliffAmount": 1666666.666,
                            "cliffValue": 2333333.3323999997,
                            "unlockPrecision": "month"
                        },
                        {
                            "allocationName": "Core Contributors",
                            "standardAllocationName": "Founder / Team",
                            "cliffAmount": 10625000,
                            "cliffValue": 14874999.999999998,
                            "unlockPrecision": "month"
                        },
                        {
                            "allocationName": "Strategic Partners",
                            "standardAllocationName": "Private Investors",
                            "cliffAmount": 13416666,
                            "cliffValue": 18783332.4,
                            "unlockPrecision": "month"
                        }
                    ]
                },
                "latestUpdateDate": "2025-06-13T07:30:52Z"
            }
        },
        {
            "tokenId": "kaito",
            "tokenName": "KAITO",
            "tokenSymbol": "KAITO",
            "marketCap": 190707682,
            "releasedPercentage": 28.14428570833332,
            "listedMethod": "INTERNAL",
            "dataSource": "Whitepaper",
            "upcomingEvent": {
                "unlockDate": "2025-11-20T12:00:00Z",
                "referencePrice": 0.778154,
                "referencePriceUpdatedTime": "2025-11-20T00:00:00Z",
                "cliffUnlocks": {
                    "totalCliffAmount": 8347618.191,
                    "totalCliffValue": 6495732.485799414,
                    "valueToMarketCap": 3.4061199935298956,
                    "allocationBreakdown": [
                        {
                            "allocationName": "Ecosystem &#x26; Network Growth",
                            "standardAllocationName": "Community",
                            "cliffAmount": 7157142,
                            "cliffValue": 5569358.675868,
                            "unlockPrecision": "month"
                        },
                        {
                            "allocationName": "Foundation",
                            "standardAllocationName": "Reserve",
                            "cliffAmount": 1190476.191,
                            "cliffValue": 926373.8099314141,
                            "unlockPrecision": "month"
                        }
                    ]
                },
                "latestUpdateDate": "2025-02-20T12:00:23Z"
            }
        },
        ...
    ]
}
</code></pre>

The response includes time series data with the date (in UTC timezone), with granularity at the level of day.

**Return Fields Explanation**

| Fields             | Data Type    | Description                                                                           |
| ------------------ | ------------ | ------------------------------------------------------------------------------------- |
| tokenId            | string       | Token ID                                                                              |
| tokenName          | string       | Token Name                                                                            |
| tokenSymbol        | string       | Token Symbol                                                                          |
| marketCap          | number       | Market cap of the token provided by external source (Will be null if no data present) |
| releasedPercentage | number       | Progress of token total released percentage                                           |
| listedMethod       | string       | Human/AI                                                                              |
| dataSource         | string       | Data Source of the Token                                                              |
| upcomingEvent      | object array |                                                                                       |
| latestUpdateDate   | timestamp    | Unlocks Data Latest Update time                                                       |

**Return Fields Explanation: Upcoming event**

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>unlockDate</td><td>timestamp</td><td>Cliff Unlock Date</td></tr><tr><td>referencePrice</td><td>number</td><td>Total Unlock Amount Denominated in token</td></tr><tr><td>referencePriceUpdatedTime</td><td>number</td><td>Total Unlock Value Denominated in USD</td></tr><tr><td>cliffUnlocks</td><td>object array</td><td></td></tr></tbody></table>

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Cliff Unlocks**</mark>

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>cliffAmount</td><td>number</td><td>Total Unlock Amount Denominated in token</td></tr><tr><td>cliffValue</td><td>number</td><td>Total Unlock Value Denominated in USD</td></tr><tr><td>valueToMarketCap</td><td>number</td><td>Value / M.Cap in Percentage</td></tr><tr><td>allocationBreakdown</td><td>object array</td><td></td></tr></tbody></table>

**Return Fields Explanation:&#x20;**<mark style="background-color:red;">**Cliff Allocation Breakdown**</mark>

<table><thead><tr><th width="249">Fields</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>allocationName</td><td>string</td><td>Allocation Name</td></tr><tr><td>standardAllocationName</td><td>string</td><td>Standard allocation of this allocation</td></tr><tr><td>cliffAmount</td><td>number</td><td>Unlock Amount Denominated in Token</td></tr><tr><td>cliffValue</td><td>number</td><td>Unlock Value Denominated in USD</td></tr><tr><td>unlockPrecision</td><td>string</td><td>Precision of Unlock. Example: second, hour, day, week, unknown(for AI listed token only), etc</td></tr></tbody></table>


# Token Fundraising API

**Overview**

This endpoint is fundraising data per token. Including funding date, round, amount raised, valuation and price per token&#x20;

There is only 1 version of Token Fundraising API

* Token Fundraising API v1&#x20;

{% content-ref url="/pages/x6xQD6lFDbg8xee4K7vs" %}
[Token Fundraising API v1](/api-documents/api-endpoints/token-fundraising-api/token-fundraising-api-v1)
{% endcontent-ref %}


# Token Fundraising API v1

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

<pre><code><strong>GET https://api.unlocks.app/v1/fundraising/token/{tokenId}
</strong>HEADER: x-api-key: &#x3C;YOUR_API_KEY>
</code></pre>

**Parameters**

Note: `tokenId` needs to be specified.

* investorId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* fundingDateMin (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* fundingDateMax (optional): The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.
* raisedAmountMin (optional): The minimum amount raised for filtering&#x20;
* raisedAmountMax (optional): The maximum amount raised for filtering&#x20;

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/fundraising/token/uniswap' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2026-01-08T10:22:54Z"
    },
    "status": true,
    "data": {
        "tokenId": "uniswap",
        "tokenName": "Uniswap",
        "tokenSymbol": "UNI",
        "listedMethod": "INTERNAL",
        "totalAmountRaised": 181000000,
        "unlockedInvestor": null,
        "investorReleasedPercentage": null,
        "fundingRounds": [
            {
                "fundingRound": "Series B",
                "fundingDate": "2022-10-13T00:00:00Z",
                "raiseType": null,
                "amountRaised": 165000000,
                "valuation": 1660000000,
                "pricePerToken": null,
                "sourceURLList": [
                    "https://blog.uniswap.org/bringing-web3-to-everyone",
                    "https://www.coindesk.com/business/2022/10/13/crypto-exchange-uniswap-labs-raises-165m-in-polychain-capital-led-round"
                ],
                "investors": [
                    {
                        "investorId": "polychain-capital",
                        "investorName": "Polychain Capital",
                        "isLeadInvestor": true
                    },
                    {
                        "investorId": "andreessen-horowitz",
                        "investorName": "Andreessen Horowitz (a16z)",
                        "isLeadInvestor": false
                    },
                    ...
                ],
                "numberOfInvestors": 5
            },
            {
                "fundingRound": "Series A",
                "fundingDate": "2020-08-06T00:00:00Z",
                "raiseType": null,
                "amountRaised": 11000000,
                "valuation": null,
                "pricePerToken": null,
                "sourceURLList": [
                    "https://blog.uniswap.org/uniswap-raise"
                ],
                "investors": [
                    {
                        "investorId": "andreessen-horowitz",
                        "investorName": "Andreessen Horowitz (a16z)",
                        "isLeadInvestor": true
                    },
                    {
                        "investorId": "a-capital",
                        "investorName": "A Capital Ventures",
                        "isLeadInvestor": false
                    },
                    {
                        "investorId": "paradigm",
                        "investorName": "Paradigm",
                        "isLeadInvestor": false
                    },
                    ...
                ],
                "numberOfInvestors": 8
            },
            {
                "fundingRound": "Seed Round",
                "fundingDate": "2019-04-24T00:00:00Z",
                "raiseType": null,
                "amountRaised": 5000000,
                "valuation": null,
                "pricePerToken": null,
                "sourceURLList": [
                    "https://finance.yahoo.com/news/paradigm-backs-decentralized-exchange-protocol-184824051.html"
                ],
                "investors": [
                    {
                        "investorId": "paradigm",
                        "investorName": "Paradigm",
                        "isLeadInvestor": true
                    }
                ],
                "numberOfInvestors": 1
            }
        ]
    }
}
```

The response includes time series data with the date (in UTC timezone).

**Return Fields Explanation**

| Fields                     | Data Type | Description                                    |
| -------------------------- | --------- | ---------------------------------------------- |
| tokenId                    | string    | Identifier to call for a Dataset               |
| tokenName                  | string    | Token Name                                     |
| tokenSymbol                | string    | Token Symbol                                   |
| listedMethod               | string    | Method of listing(INTERNAL, AI, EXTERNAL)      |
| totalAmountRaised          | number    | Total Amount Raised                            |
| unlockedInvestor           | number    | Total Amount Unlocked from Investor Allocation |
| investorReleasedPercentage | number    | Progress of Investor Unlocked                  |

**Return Fields Explanation: Funding Rounds**

| Fields        | Data Type | Description                                   |
| ------------- | --------- | --------------------------------------------- |
| fundingRound  | string    | Funding Round                                 |
| fundingDate   | string    | Funding Date                                  |
| raiseType     | boolean   | Raise Type                                    |
| amountRaised  | number    | Raise Amount in that Round                    |
| valuation     | number    | Valuation                                     |
| pricePerToken | number    | Cost of Token for this Investor at that Round |
| sourceURLList | string    | URL to Sources of Data                        |

**Return Fields Explanation: Investors**

| Fields         | Data Type | Description                      |
| -------------- | --------- | -------------------------------- |
| investorId     | string    | Identifier to call for a Dataset |
| investorName   | string    | Investor Name                    |
| isLeadInvestor | boolean   | Identifier for Lead Investors    |


# Investor List API

**Overview**

Start here to get a list of all investorID to use for calling [Investors API](/api-documents/api-endpoints/investors-api).&#x20;

There is only 1 version of Investor List API

* Investor List API v1&#x20;

{% content-ref url="/pages/t9hC2e10qGO2cJdfdrLd" %}
[Investor List API v1](/api-documents/api-endpoints/investor-list-api/investor-list-api-v1)
{% endcontent-ref %}


# Investor List API v1

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

```
GET https://api.unlocks.app/v1/fundraising/investors/list
HEADER: x-api-key: <YOUR_API_KEY>
```

**Parameters**

No parameters required.

**Response**

```json
{
    "metadata": {
        "queryDate": "2026-01-08T10:23:54Z"
    },
    "status": true,
    "data": [
        {
            "investorId": "01-advisors",
            "investorName": "01 Advisors",
            "website": "https://01a.com/,https://www.linkedin.com/company/01a/,https://x.com/01Advisors",
            "latestFundingDate": "2021-11-04T00:00:00Z"
        },
        {
            "investorId": "01-capital",
            "investorName": "01 Capital",
            "website": "https://01capital.co.uk/,https://www.linkedin.com/company/01capital/",
            "latestFundingDate": "2021-05-24T00:00:00Z"
        },
        ...
    ]
}
            
```

The response includes time series data with the date (in UTC timezone),&#x20;

**Return Fields Explanation**

| Fields            | Data Type | Description                                  |
| ----------------- | --------- | -------------------------------------------- |
| investorId        | string    | Identifier to call for a Dataset             |
| investorName      | string    | Investor Name                                |
| website           | string    | Link to Investor Website                     |
| latestFundingDate | timestamp | Latest Investment Activity From The Investor |


# Investors API

**Overview**

This endpoint is fundraising data per investor. Including funding date, round, amount raised, valuation and price per token&#x20;

There is only 1 version of Investor API

* Investor API v1&#x20;

{% content-ref url="/pages/jqVRLgt3gAjjp0xS7BAh" %}
[Investors API v1](/api-documents/api-endpoints/investors-api/investors-api-v1)
{% endcontent-ref %}


# Investors API v1

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

<pre><code><strong>GET https://api.unlocks.app/v1/fundraising/investors/{investorId}
</strong>HEADER: x-api-key: &#x3C;YOUR_API_KEY>
</code></pre>

**Parameters**

Note: `investorId` needs to be specified.

* investorId (required): Get `investorId` from[ Investor List API](/api-documents/api-endpoints/investor-list-api)
* isLeadInvestor (optional): Show only rounds that are led by this investor
* fundingDateMin (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* fundingDateMax (optional): The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.
* raisedAmountMin (optional): The minimum amount raised for filtering&#x20;
* raisedAmountMax (optional): The maximum amount raised for filtering&#x20;

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/fundraising/investors/andreessen-horowitz' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2026-01-08T10:24:34Z"
    },
    "status": true,
    "data": {
        "investorId": "andreessen-horowitz",
        "investorName": "Andreessen Horowitz (a16z)",
        "website": "https://a16z.com/,https://twitter.com/a16zcrypto",
        "fundingRounds": [
            {
                "tokenId": "apecoin",
                "roundName": "Seed Round",
                "isLeadInvestor": true,
                "fundingDate": "2022-03-22T00:00:00Z",
                "totalAmountRaisedinThatRound": 450000000,
                "valuation": 4000000000,
                "pricePerToken": null
            },
            {
                "tokenId": "aptos",
                "roundName": "Series A",
                "isLeadInvestor": false,
                "fundingDate": "2022-07-25T00:00:00Z",
                "totalAmountRaisedinThatRound": 150000000,
                "valuation": 2000000000,
                "pricePerToken": null
            },
            {
                "tokenId": "aptos",
                "roundName": "Seed Round",
                "isLeadInvestor": true,
                "fundingDate": "2022-03-15T00:00:00Z",
                "totalAmountRaisedinThatRound": 200000000,
                "valuation": null,
                "pricePerToken": null
            },
            ...
        ]
}
```

The response includes time series data with the date (in UTC timezone).

**Return Fields Explanation**

| Fields            | Data Type | Description                                  |
| ----------------- | --------- | -------------------------------------------- |
| investorId        | string    | Identifier to call for a Dataset             |
| investorName      | string    | Investor Name                                |
| website           | string    | Link to Investor Website                     |
| latestFundingDate | timestamp | Latest Investment Activity From The Investor |

**Return Fields Explanation: Funding Rounds**

| Fields                       | Data Type | Description                                   |
| ---------------------------- | --------- | --------------------------------------------- |
| tokenId                      | string    | Token Id                                      |
| roundName                    | string    | Round Name                                    |
| isLeadInvestor               | boolean   | Identifier for Lead Investor                  |
| totalAmountRaisedinThatRound | number    | Total Amount Raised in That Round             |
| valuation                    | number    | Valuation for Funding Round                   |
| pricePerToken                | number    | Cost of Token for this Investor at that Round |


# Burn API

**Overview**

This endpoint is a time series data of burn events: when and how tokens permanently removed from circulation.

There is only 1 version of Burn API

* Burn API v1&#x20;

{% content-ref url="/pages/72t1n1MpFh1356Rz28gu" %}
[Burn API v1](/api-documents/api-endpoints/burn-api/burn-api-v1)
{% endcontent-ref %}


# Burn API v1

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

<pre><code><strong>GET https://api.unlocks.app/v1/burn/{tokenId}
</strong>HEADER: x-api-key: &#x3C;YOUR_API_KEY>
</code></pre>

**Parameters**

Note: `tokenId` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List API](/api-documents/api-endpoints/token-list-api)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* end (optional): The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/burn/aptos?start=2024-12-01&end=2024-12-02' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2025-11-05T09:38:54Z"
    },
    "status": true,
    "data": {
        "tokenId": "aptos",
        "tokenName": "Aptos",
        "tokenSymbol": "APT",
        "totalBurnAmount": 923.148539,
        "burns": [
            {
                "burnEventLabel": "Aptos Gas Fees",
                "burnType": "PROGRAMMATIC",
                "burnDate": "2024-12-02T00:00:00Z",
                "amount": 511.326899,
                "metadata": {
                    "burners": [
                        "PROJECT"
                    ],
                    "burnReasons": [
                        "GOVERNANCE"
                    ]
                }
            },
            {
                "burnEventLabel": "Aptos Gas Fees",
                "burnType": "PROGRAMMATIC",
                "burnDate": "2024-12-01T00:00:00Z",
                "amount": 411.82164,
                "metadata": {
                    "burners": [
                        "PROJECT"
                    ],
                    "burnReasons": [
                        "GOVERNANCE"
                    ]
                }
            }
        ]
    }
}
```

The response includes time series data with the unix timestamp.

**Return Fields Explanation**

| Fields          | Data Type | Description                                          |
| --------------- | --------- | ---------------------------------------------------- |
| tokenId         | string    | Identifier to call for a Dataset                     |
| tokenName       | string    | Token Name                                           |
| tokenSymbol     | string    | Token Symbol                                         |
| totalBurnAmount | timestamp | Total burned token amount up to latest tracked data. |

**Return Fields Explanation: burns**

| Fields         | Data Type | Description         |
| -------------- | --------- | ------------------- |
| burnEventLabel | string    | Label of burn event |
| burnType       | string    | Type of burn event  |
| burnDate       | string    | date of token burn  |
| amount         | number    | Burn amount         |

**Return Fields Explanation: metadata**

| Fields      | Data Type | Description                       |
| ----------- | --------- | --------------------------------- |
| burners     | string    | Type of burner                    |
| burnReasons | string    | Type of purpose of the burn event |


# Buyback API

**Overview**

This endpoint is a time series data of buyback events: When and how projects repurchase their own tokens from the market.

There is only 1 version of Buyback API

* Buyback API v1&#x20;

{% content-ref url="/pages/1Oevj3xoQdZAKKsbu8CH" %}
[Buyback API v1](/api-documents/api-endpoints/buyback-api/buyback-api-v1)
{% endcontent-ref %}


# Buyback API v1

## Getting Started

#### **Base URL** <a href="#base-url" id="base-url"></a>

```
https://api.unlocks.app
```

#### **Authentication** <a href="#authentication" id="authentication"></a>

Provide your api key in the `x-api-key` header.

<pre><code><strong>GET https://api.unlocks.app/v1/buyback/{tokenId}
</strong>HEADER: x-api-key: &#x3C;YOUR_API_KEY>
</code></pre>

**Parameters**

Note: `tokenId` needs to be specified.

* tokenId (required): Get `tokenId` from [Token List  API v4](/api-documents/api-endpoints/token-list-api/token-list-api-v4)
* start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
* end (optional): The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.

**Example:**

```
curl -X 'GET' \
  'https://api.unlocks.app/v1/buyback/hyperliquid?start=2024-10-01&end=2024-12-01' \
  -H 'x-api-key: $YOUR_API_KEY'
```

**Response**

```json
{
    "metadata": {
        "queryDate": "2025-11-05T10:08:39Z"
    },
    "status": true,
    "data": {
        "tokenId": "hyperliquid",
        "tokenName": "Hyperliquid",
        "tokenSymbol": "HYPE",
        "totalBuybackAmount": 318370.2349536178,
        "buybacks": [
            {
                "buybackEventLabel": "Missing HYPE Assistance Fund Buyback",
                "buybackType": "TREASURY_BUYBACK",
                "buybackDate": "2024-11-30T17:00:00Z",
                "tokenAmount": 159185.1174768089,
                "value": 1036295.1147740259,
                "spentAmount": null,
                "spentUnit": "",
                "targetAddress": "0xfefefefefefefefefefefefefefefefefefefefe",
                "buyerAddress": "0xfefefefefefefefefefefefefefefefefefefefe",
                "resolution": "period_net",
                "basis": "estimated"
            },
            {
                "buybackEventLabel": "Missing HYPE Assistance Fund Buyback",
                "buybackType": "TREASURY_BUYBACK",
                "buybackDate": "2024-11-29T17:00:00Z",
                "tokenAmount": 159185.1174768089,
                "value": 620821.9581595546,
                "spentAmount": null,
                "spentUnit": "",
                "targetAddress": "0xfefefefefefefefefefefefefefefefefefefefe",
                "buyerAddress": "0xfefefefefefefefefefefefefefefefefefefefe",
                "resolution": "period_net",
                "basis": "estimated"
            }
        ]
    }
}
```

The response includes time series data with the unix timestamp.

**Return Fields Explanation**

| Fields             | Data Type | Description                                          |
| ------------------ | --------- | ---------------------------------------------------- |
| tokenId            | string    | Identifier to call for a Dataset                     |
| tokenName          | string    | Token Name                                           |
| tokenSymbol        | string    | Token Symbol                                         |
| totalBuybackAmount | timestamp | Total buyback token amount up to latest tracked data |

**Return Fields Explanation: buybacks**

| Fields            | Data Type | Description                                                             |
| ----------------- | --------- | ----------------------------------------------------------------------- |
| buybackEventLabel | string    | Label of buyback event                                                  |
| buybackType       | string    | Type of buyback event                                                   |
| buybackDate       | string    | Date of buyback burn                                                    |
| tokenAmount       | number    | Buyback token amount                                                    |
| value             | number    | Historical USD value of token amount                                    |
| spentAmount       | number    | Amount actually spent by the project to buy back tokens                 |
| spentUnit         | string    | Unit of spent amount                                                    |
| targetAddress     | string    | Address of the buyback wallet or foundation                             |
| buyerAddress      | string    | Address doing the buyback purchases (usually target address if unknown) |
| resolution        | string    | Granularity of buyback event                                            |
| basis             | string    | Precision of the buyback reference                                      |


# CSV Export

A Guide to using Tokenomist's CSV

### Overview

This dataset provides chart data for the unlocked or available supply of a token, broken down by allocation in a pivot table format with weekly and monthly granularity. It represents the historical and future of token distribution across various allocations, allowing you to track how the token supply has been unlocked or available over time.

\*PlumAI listed tokens are currently unavailable, due to currently being in Beta.

### Column list & description

| **Column name**     | **Description**                                                                                                        |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Start Date          | Timestamp represents the beginning of the time range for which the supply data is reported. Using UTC +00:00 timezone. |
| End Date            | Timestamp represents the ending of the time range for which the supply data is reported. Using UTC +00:00 timezone.    |
| \[Allocation names] | A snapshot of supply on a specific period for each allocation, based on the selected parameters.                       |

### Parameters

You can export the release supply schedule for one token at a time. These following parameters are available for customization

<figure><img src="/files/P8SvnhgmAO0oI91zlLFu" alt=""><figcaption></figcaption></figure>

#### Date Range

The time period for exporting token release schedule data. The range depends on your API plan.

|                   | **Standard API**          | **Elite API**             |
| ----------------- | ------------------------- | ------------------------- |
| Historical Period | -1 year ago from today    | -2 years ahead from today |
| Future Period     | +2 years ahead from today | +3 years ahead from today |

#### Aggregated by

Summarizes supply data based on the selected granularity.

| **Parameter name** | **Description**                                                                                                                                            | **Calculating Method** |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| Weekly             | Starts with Sunday of the export week, then the date range extends backward and forward in 7 day increments until reaching the selected date range.        |                        |
| Monthly            | Starts with first date of the export month, then the date range extends backward and forward in 1 month increments until reaching the selected date range. |                        |

#### Allocation Type

| **Parameter name**  | **Description**                                                                                                                                                                             |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Raw Allocation      | The original allocation name that directly came from the project.                                                                                                                           |
| Standard Allocation | The standardized version of allocation which makes it possible to compare allocation among multiple tokens. More details in [Standard Allocation Page](/tokenomist-pro/standard-allocation) |

#### Supply Type

| **Parameter name** | **Description**                                                                                                                                                                        | **Calculating Method**                                |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Unlocked Supply    | The amount of tokens that are unlocked and can be moved into circulation anytime, even if they stay in the holder’s wallet.                                                            |                                                       |
| Available Supply   | The total number of tokens that are ready for trading in the market. It includes the unlocked supply plus any locked tokens that may become tradable once specific conditions are met. | `Available supply` = `Unlocked Supply` + `TBD Locked` |

Please visit our [methodology page](/miscellaneous/tokenomist-methodologies) for more details

#### Unit of Supply

We use the **percentage of available supply** instead of max supply, particularly for tokens with infinite supply. This approach allows for a consistent, apple-to-apple comparison across different tokens.

* **Why compare percentage of Available Supply (2030 and +5Y)?**: These metrics offer flexibility, letting you choose between available supply projections at the end of 2030 or over the next 5 years based on your preference.
* **Benefits**: Provides a standardized view for comparing token supplies, even when max supply of such token is unlimited.

| **Parameter name**                   | **Description**                                                    | **Calculating Method**                         |
| ------------------------------------ | ------------------------------------------------------------------ | ---------------------------------------------- |
| Raw Amount                           | The amount of tokens                                               |                                                |
| Percentage of Available Supply Y2030 | Percentage relative to available supply at 2030-12-31 23:59:59     | `Raw Amount` / `Available supply end of 2030`  |
| Percentage of Available Supply Y+5   | Percentage relative to available supply in next 5 years from today | `Raw Amount` / `Available supply next 5 years` |

#### Supply calculation method

| **Parameter name** | **Description**                                                                                   | **Calculating Method**                                  |
| ------------------ | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| Cumulative         | Total unlocked supply / available supply from token TGE till specified `End Date` for each column |                                                         |
| Non-Cumulative     | Total unlocked supply that occurs during `Start Date` and `End Date`                              | This calculation is available in `Unlocked Supply` only |


# Product Changelog

New updates and improvements at Tokenomist

## 🗓️ October 21, 2025

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FZcjMjcIg0D9kJiVWvkdy%2Fburn.mp4?alt=media&token=6d12eaad-5e10-4be5-9365-4a7dc0631570>" %}

#### **Buyback Dashboard and Burn Dashboard**

**Explore real demand through supply-side mechanics**

Analyze how buyback and burn activities reflect genuine market demand and impact token supply. This dashboard helps you identify projects with strong deflationary fundamentals.

**Features:**

**Token Page Integration** View buyback and burn metrics directly on individual token pages for any token with these mechanisms.

**Buyback Screener** Explore and compare tokens with active buyback programs. Key metrics include:

* % of Supply bought back
* Total Value bought back
* Last 30 Days Value
* Type of Buyback mechanism

**Buyback Compare** Side-by-side comparison of buyback metrics across selected tokens. Analyze relative values, and supply reduction impact.

**Burn Screener** Discover tokens with burn mechanisms. Key metrics include:

* % of Supply burned
* Total Value burned
* Last 30 Days Value
* Type of Burn mechanism

**Burn Compare** Compare burn activities across multiple tokens. Evaluate burn percentages, and cumulative values.

**Access through:**

* Individual token pages Ex. [Hyperliquid](https://tokenomist.ai/hyperliquid/buyback)
* [Buyback Screener](https://tokenomist.ai/buyback/screener)
* [Buyback Compare](https://tokenomist.ai/buyback/compare)
* [Burn Screener](https://tokenomist.ai/burn/screener)
* [Burn Compare](https://tokenomist.ai/burn/compare)

***

## 🗓️ October 15, 2025

#### Unlock Event 2.0

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FHYqjEHDe7Vg1PhUX2ugj%2Ffilter.mp4?alt=media&token=c10fc302-4d20-4ca5-a98d-042ab302dcec>" %}

**Enhanced visibility and context for token unlock analysis**

Unlock Event 2.0 introduces visual indicators and smart filtering to help you better understand the nature and timing of token unlocks.

**New Features:**

**Insider Allocation Icons** Unlock events now display visual icons indicating insider allocations, including private investor and team unlocks. Quickly identify which events involve stakeholder groups with potential selling pressure versus community or ecosystem releases.

**"Earlier Unlocks Filtered Out" Tags** When applying filters, unlock events that occurred after the latest upcoming unlock but still match your criteria will display an "earlier unlock filtered out" indicator. This ensures you're aware of relevant historical unlocks that fit your search parameters, even if they're not the immediate next event.

**Enhanced Filtering:**

* **Token-Based Filters:** Screen by market cap (released and fully diluted), rankings, categories, TGE dates, price movements, exchange listings, supply distribution, allocation dominance, and release progress
* **Event-Based Filters:** Identify unlocks within specific timeframes (7 days, 1 month, 6 months, 1 year), filter by allocation categories (founders, investors, community), and measure unlock impact by dollar value, percentage of released supply, or percentage of total supply

***

## 🗓️ October 9, 2025

#### Unlock Insights Integration

**Exclusive deep research now available for Pro and API customers**

[Unlock Insights](https://tokenomist.ai/insights), previously available only to dedicated Unlock Insights subscribers, is now integrated directly into Tokenomist Pro and API plans. Access in-depth research and analysis from the Tokenomist team covering token unlock events, market impact assessments, and supply dynamics.

Pro and API customers can now read exclusive research articles and unlock analysis that provide strategic insights into upcoming vesting schedules and their potential market effects.

***

## 🗓️ August 26, 2025

#### AI insights

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTev6OPpLmZYUw8pBWeeW%2Fuploads%2Fr4fTDDrE3F2hiHlrxuNX%2Fai_insight_demo_3.mp4?alt=media&token=3f9f062d-1021-4b77-818a-2b7f7b4c78c5>" %}

**Get smarter token unlock insights and supply analysis powered by AI**

Skip manual chart analysis and get instant AI-powered insights from your tokenomics data. Click the **AI Insights** button in the top-left corner of any supported page to receive intelligent analysis of unlock schedules, supply changes, market impact, and notable patterns.

**Available on:**

* [Token Unlocks Page](https://tokenomist.ai/)
  * Cliff and Linear Release Table
  * Crypto Market Emission dashboard
  * Token Unlocks Dashboard
* [Overview Page](https://tokenomist.ai/overview)

The AI analyzes your current view and provides contextual insights, helping you make faster, more informed decisions about token supply and unlock patterns.

{% hint style="warning" %}
AI insights are experimental and may contain inaccuracies. Always verify information independently. Not Financial Advice.
{% endhint %}

<details>

<summary>🚀 Improved</summary>

* Adjust [Crypto Market Emission](https://tokenomist.ai/emission/crypto-market) Others Percentage

</details>

<details>

<summary>🛠️ Fixed</summary>

* Update Request Demo in Builder Mode

</details>

***

## 🗓️ August 19, 2025

#### CSV Export

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTev6OPpLmZYUw8pBWeeW%2Fuploads%2FiKCq5lax76GccqXGJD7M%2FArea.mp4?alt=media&token=73c7bf3e-487c-461a-8713-f6ec388d0ea7>" %}

Access Tokenomist's core datasets in raw format for quantitative analysis. Download token supply schedules, allocation breakdowns, emission forecasts, and valuation metrics to integrate directly into Excel, Python scripts, or portfolio tools. This eliminates manual data entry and enables faster, more consistent analysis.

Explore more : [Documentation](https://docs.tokenomist.ai/tokenomist-pro/csv-export)

<details>

<summary>🚀 Improved</summary>

* Added timeframe +1 day, +7 days in [Emission Screener](https://tokenomist.ai/emission/screener)
* Added table details in [Crypto Market Emission](https://tokenomist.ai/emission/crypto-market)
* Added [Updates](https://tokenomist.ai/update) in token unlocks dashboard
* Explore to Emission page by clicking Header of the highlight section in token unlocks dashboard

</details>

<details>

<summary>🛠️ Fixed</summary>

* Change wording to "Linear Release"

</details>

***

## 🗓️ July 31, 2025

#### Builder Mode

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTev6OPpLmZYUw8pBWeeW%2Fuploads%2FJn5ziQEsQVJroSyJYRRZ%2Fbuilder_mode.mp4?alt=media&token=f36998ad-44fa-4ad2-ac92-a818537d08dc>" %}

**Design optimal token distribution strategies before TGE**

Build your vesting schedule and token allocation with confidence using data-backed insights from over 400 tokens across multiple categories. The Builder mode helps you create tokenomics structures that align with your project's goals and industry best practices.

**Comprehensive analysis sections:**

* **Tokenomics Design**: Token Allocation Distribution, Vesting Schedule Timelines, Emission Rate, and Unlock Milestones
* **TGE Performance**: Launch Strategy Distribution, FDV Distribution, Allocation Breakdown, and Price Pattern analysis
* **Exchange Listing Performance**: TGE vs All Listing Price Impact, Exchange Listing Timeline, and Price/Volume correlation data

**Advanced filtering and customization:**

* **Category filters** to focus on specific categories
* **Custom token selection** to compare against specific projects in your space
* **Interactive visualizations** with drill-down capabilities for deeper insights

Each section provides benchmarking data and proven patterns from successful token launches. Use the search bar to quickly navigate between analysis types, or filter by project category to see industry-specific trends and best practices.

Access the Builder from your main dashboard (<https://tokenomist.ai/builder/landing>) or click [**Request Demo**](https://docs.google.com/forms/d/e/1FAIpQLSdU7jIvx09nZYnbX2JOtpaS7w1ho4N5ArIfCZJ-MD4Byvnsvw/viewform) to see it in action.

<details>

<summary>🚀 Improved</summary>

* Add Dynamic Allocation
  * [Bitcoin](https://tokenomist.ai/bitcoin)
  * [Solana](https://tokenomist.ai/solana)
  * [Celestia](https://tokenomist.ai/celestia)
  * [Render](https://tokenomist.ai/render-token)
* Change unlock events include only cliff releases and exclude mining distribution methods.

</details>

<details>

<summary>🛠️ Fixed</summary>

* Extended Supply Y2030 to Y2035 for inifinte max supply

</details>


# Disclaimer

Before using this site, please make sure that you note the following important information.

At Tokenomist, we strive to provide the most accurate information possible by leveraging publicly available references for each token. We believe in empowering our users with knowledge while maintaining clear update policies with project teams to uphold our integrity and trust of our users.\
\
DAOSurv and its related products are not registered investment, legal, tax advisor, or broker/dealer companies. Any data we provide through any of our both official or unofficial, including [tokenomist.ai](/tokenomist/welcome-to-tokenomist), social media, Twitter, or telegram is from our internal research, contributed by the community, from the project team, and from various sources. All data is not intended as, and shall not be understood or construed as, financial advice.  **Nothing is Financial Advice**.  It is intended as educational material. Though we made our best efforts to deliver the information to be as accurate and up to date, occasionally unintended errors and misprints may occur due to the dynamic nature of crypto and the unstructured standard of its data. However, we are very happy to make any changes in reported and verifiable data. For data updates and changes please refer to our [**data update policy**](/miscellaneous/data-update-policy).

1. **Data Source**: All data provided on Tokenomist are sourced from available information on on-chain data, white paper, privately sourced information, and public docs.
2. **Unlocks Schedule Precision**: The countdown timer and all data on Tokenomist is an estimate based on Tokenomist’s best effort information only, and unlocks date may vary due to multiple reasons. Please refer to data precision section on site to get a more detailed explanation on each token’s unlock date.
3. **Data Reliability and Accountability**: While we strive for the utmost accuracy in the data provided on our platform, we are not accountable for discrepancies or inaccuracies within the data.&#x20;
4. **Data Discrepancies**: As Tokenomist obtain more references from project documentation or smart contracts, we will promptly update the data to reflect the most accurate and up-to-date information according to our [**data update policy**](/miscellaneous/data-update-policy).
5. **Project Team Requests for Data Updates**: Tokenomist may engage with project teams for data verifications and clarifications, or source private information that may not be available within the public docs. Data sourced from project teams will be updated according to our [**data update policy**](/miscellaneous/data-update-policy).
6. **Non-Financial Advice**: The data provided by Tokenomist is not financial advice and should be used for research and educational purposes only. Users should conduct their own research and consider multiple sources before making any financial decisions. Tokenomist does not hold any accountability for any losses of investment funds.

By adhering to these principles, Tokenomist aims to deliver reliable and transparent information to our users and ensure that our platform remains a trusted resource in the community.<br>

To understand more about Tokenomist data precision please visit [Precision & Assumption](/tokenomist/token-page/precision-and-assumption)page.

{% content-ref url="/pages/ieGkzBVW0SiZOODpx6iq" %}
[Precision & Assumption](/tokenomist/token-page/precision-and-assumption)
{% endcontent-ref %}


# Data Update Policy

Before using this site, please make sure that you note the following important information.

Tokenomist is dedicated to providing the most accurate token unlocks data. To maintain the integrity of our data, we adhere to the following policies for any inconsistencies that may occur:

1. **Project Team Notification**: Any “big unlocks”, defined as those involving over `$10 million` worth of tokens, our team will reach out to the project team `1 month` prior to the unlock date for verification.
2. **Advance Notice**: Project Teams are to provide any updated information or data source regarding token unlocks at least `14 days` prior to the scheduled unlock date displayed on Tokenomist. *This policy is in place to protect our users from last-minute data alterations that could lead to price or data manipulation.*

2.1    Note: Tokenomist will require approximately `2-3 business days` to verify and make the required changes.

3. **Private Source: Short Notice Updates:** Tokenomist will **not** make updates on short notice, specifically for any changes sourced `privately` by the project team within a specified `14 days` period prior to the token upcoming unlock date displayed on Tokenomist.

3.1    Note: Privately sourced short noticed update will be pushed to `7-14 days` post-unlock date to align with newly acquired data in order to avoid data manipulation during volatile period.

4. **New Public Source: Short Notice Updates:** In a case where newly available `public` information is published from project/ team Tokenomist will adjust the unlock date as soon as possible regardless of unlocks date. *Refer to point 2.1 for expected update time.*
5. **Existing Source Data Discrepancies:** In a case where data discrepancies are identified from Tokenomist data, Tokenomist will immediately update the data as soon as possible regardless of unlocks date given that the data does not fall under point 6 of ambiguous data. *Refer to point 2.1 for expected update time.*
6. **Ambiguous Data:** In a case where ambiguous data is identified, referring to ballpark dates, complex release schedule, or unclear unlock methodology, and is not clarified from the team before `14 days` prior to the Tokenomist scheduled unlock date window, Tokenomist will **not** make any changes until after specified unlock date. Refer to point 3.1 for post-unlocks update timeframe.

6.1 In the case where existing data provided is identified as ambiguous but **is** notified before the `14 days` window prior to Tokenomist scheduled unlock date, Tokenomist will require clarifications from the project team in order to make the changes ASAP.

6.2 Tokenomist may require project team to post a co-public post clarifying the changes to the community in certain cases where reason provided to community is initially unclear.

7. **Small Unlocks:** Small unlocks, referring to unlocks valued less than `$10 million` worth of tokens, Tokenomist will make updates as soon as the inaccuracy has been identified.
8. **Ultimate Decision**: Tokenomist holds the ultimate discretion in verifying and performing data modifications.

We urge all projects and teams to review and comply with these policies to facilitate smooth and accurate updates to token unlock data on our platform.


# FAQ

### What is Tokenomist?

Tokenomist is a Data Analytics dashboard platform for both on-chain and off-chain data, enabling users to monitor vested tokens and notify them of upcoming unlock events.

### Where does the token price come from?

We extract the price from Coingecko's API.&#x20;

### Why are the circulating supply and unlocked supply not equal?

The circulating supply is from Coingecko. It is based on the supply that is liquid. For the unlocked supply, it is the number of tokens that are unlocked - which are claimed or not claimed. For example, if 100 $XYZ are unlocked, and the owner has not claimed, it will not be added to the circulating supply.<br>

### Why the token unlocks occur and the price or the token is not move ?

When token unlocks happen, benefitciary can finally claim their tokens after a certain amount of time. But this doesn't always mean the token price will move. The price is influenced by things like how many people want to buy or sell the tokens, and how they feel about the market in general. So the price might stay the same even after token unlocks, but more tokens being claimed could eventually put pressure on the price.

### What is the difference between the yellow and green icons?

The yellow icon means that the token vesting data are based on the protocol's whitepaper. For the green icon, it means that the token vesting data are based on the on-chain investigation.&#x20;

### What is the difference between Cliff and Linear unlocks?

**Cliff Unlocks** - Tokens are held in a locked state until a specific event or date occurs, after which they will all be released at once \
\
**Linear Unlocks** - Tokens are released at a steady, fixed rate over a period of time. For example, if 30% of tokens are set to be unlocked within a month. Then roughly the token will be releasing 1% per day, or in some cases, it will be releasing every x% per transaction block if they are vested in a smart contract

### **What is DAOSURV?**

DAOSURV is a company that builds Token Unlocks.

### What timezone does Tokenomist use on the product?

Tokenomist displays the timezone based on the local timezone of the user's computer. This allows for maximum convenience and accuracy for users around the world.\ <br>


# Official Links

## Product 🌐

* Website: [tokenomist.ai ](https://tokemomist.ai)
* Newsletter: [insights.unlocks.app](https://insights.unlocks.app/)

## Follow us on Twitter:&#x20;

* <https://x.com/Tokenomist_ai>

## Telegram:

* Community: <https://t.me/daosurv>
* News & Announcement: <https://t.me/Tokenomist_Announce>


# Press/ Media Kit

If you are working on a story that uses our data, please don’t hesitate to get in touch: <support@tokenomist.ai> or dm us at [telegram](http://t.me/daosurv).

### Horizontal

<div><figure><img src="/files/SHP3O6mqVh3CZgijYFJg" alt=""><figcaption><p>Logo Wordmark Color</p></figcaption></figure> <figure><img src="/files/6TaYQI4W6dJTZhHnzRIh" alt=""><figcaption><p>Logo Wordmark Primary</p></figcaption></figure> <figure><img src="/files/qyWxoqjmn7fXgegfQqtw" alt=""><figcaption><p>Logo Wordmark Black</p></figcaption></figure> <figure><img src="/files/6e6Wz3cGwDZAc4TrDtTF" alt=""><figcaption><p>Logo Wordmark White</p></figcaption></figure></div>

### **LogoMark**

<div><figure><img src="/files/OauH22wR53frrbAfRYWY" alt=""><figcaption><p>LogoMark Black</p></figcaption></figure> <figure><img src="/files/BmpbNN5Ossy8GWCiJIYA" alt=""><figcaption><p>LogoMark Primary</p></figcaption></figure> <figure><img src="/files/U6VukH7MNCCMeWG7QXma" alt=""><figcaption><p>LogoMark White</p></figcaption></figure></div>

### **Download the full Media Kit here:**

👉 [Google Drive](https://drive.google.com/drive/folders/1QLSEd8_4TEIAl45psoQ6oPmhFGMpWFzH?usp=drive_link)

*By downloading The Tokenomist Media Kit you agree to not modified it in any way or form. This includes, but is not limited to:*

* *Altering colors, proportions, or design elements*
* *Adding effects (e.g. shadows, gradients)*
* *Changing orientation or aspect ratio*
* *Adding or removing text or images*

*Please use the logo as provided to ensure brand consistency.*


# Token Listing Criteria

**To request a token to be listed on our website, please fill out this form**&#x20;

<https://feedback.unlocks.app/b/token-requests/>

### Example of a token our team likely to list&#x20;

* Medium to High Market Cap (Coingecko's rank 300)
* Listed on below exchange
  * Binance
  * OKX
  * Bybit
  * Coinbase
  * HTX
* Listing priority is determined by internal priorities and at the discretion of internal employees only.

### Self Listing

Please visit this link to submit your tokenomics data: <https://listing.tokenomist.ai/>

* Self listing has different criteria to manual listing by team. It is open for every projects


# Tokenomist Methodologies

Explanation of Tokenomist methodologies and details

## Supply metrics

Tokenomist's goal is to resolve the issue of unstructured token supply data. To solve the problem, we have developed methodologies and defined metrics that are displayed on our token unlocks website. These methodologies are designed to establish standards for tokenomics data and ensure transparency in the industry, enabling everyone to understand and utilize these metrics to make informed decisions.

<table><thead><tr><th>Metrics</th><th width="356">Definition</th><th>Formula</th></tr></thead><tbody><tr><td><strong>Fully Diluted Value (FDV)</strong></td><td>This term refers to the total value of a cryptocurrency project, considering the total token supply in circulation. It provides an estimate of the project's potential for growth and future value.</td><td><code>FDV = Current Price * Total Supply</code></td></tr><tr><td><strong>Stakeholder Wallet</strong></td><td>This is a wallet that holds tokens with special conditions or benefits agreed upon by involved parties. These wallets are usually meant to hold tokens without plans to sell them in the public market. Stakeholder wallets can include investors, team members, treasury holdings, or wallets that are explicitly designated as non-circulating supply. Tokens in stakeholder wallets are classified as non-circulating supply.</td><td></td></tr><tr><td><strong>Circulating Supply</strong></td><td>This term refers to the number of tokens transferred to non-stakeholder wallets and available for open market trading. It excludes tokens that are locked or held by stakeholder addresses. This supply quantity represents the number of tokens that can be publicly traded and circulate in the market. Even if these tokens have not been traded in the secondary market yet, they are considered readily available for trading once transferred out from stakeholder wallets. We collect this supply data from multiple sources.</td><td></td></tr><tr><td><strong>Locked Supply</strong></td><td><p>This refers to the quantity of tokens that have been restricted to prevent trading in the public market and transfer to non-stakeholder wallets. The lock token process encourages long-term stakeholder participation in projects. The duration of the lock time and type of vesting (cliff or linear) are also specified.</p><p><br><em>This metric does not include the locked token in the re-lock mechanism.</em></p></td><td></td></tr><tr><td><strong>TBD Locked supply</strong></td><td>This refers to the amount of tokens that have not yet been assigned a release timing. These tokens are usually set aside for specific purposes and are released when certain conditions are met, such as DAO treasury, reserves and unallocated fund. Once the project provides data about the lock-up period and the unlocking mechanism (cliff or linear), the TBD locked supply will decrease and change to a locked supply with a known lock-up period.</td><td></td></tr><tr><td><strong>Unlocked Supply</strong></td><td>This refers to the amount of a token that is unlocked and readily claimable into circulation at any time. It is not necessary to transfer the token out to a non-stakeholder wallet. The token can be unlocked and still held by the stakeholder's wallet. <em>Therefore, the unlocked supply is not the same as the circulating supply.</em> It's used to gauge the actual amount of tradable tokens in the public market.</td><td></td></tr><tr><td><strong>Available Supply</strong></td><td>The total quantity of tokens that are immediately accessible and tradable on the public market. It consists of the 'Unlocked Supply,' which is freely tradable, and the 'TBD Locked Supply,' which becomes available as specific conditions are met, indicating the potential impact of additional tokens entering circulation.</td><td><code>Available supply = Unlocked Supply + TBD Locked</code> </td></tr><tr><td><strong>Untracked supply</strong></td><td>This refers to the amount of tokens that we have not assigned to a specific allocation due to data uncertainty.</td><td></td></tr><tr><td><strong>Supply Y2030</strong></td><td>Projected available token supply expected to be unlocked by end of 2030, including current unlocked, scheduled releases, and those with undetermined unlock dates (TBD supply).</td><td></td></tr><tr><td><strong>Max Supply</strong></td><td>This refers to the theoretical maximum number of tokens that could possibly exist in the future. This number is either reported by the project or set as a condition on the smart contract. In some cases, this number may be infinite, which indicates there is no limit to token issuance.</td><td></td></tr><tr><td><strong>Inflation</strong></td><td>An increase in unlock supply caused by unlocking or issuance mechanisms (like cliffs and linear releases).</td><td></td></tr><tr><td><strong>Deflation</strong></td><td>A decrease in unlocked supply due to burning mechanism.</td><td></td></tr><tr><td><strong>Emission</strong></td><td>Emission refers to the net change in the unlocked supply of a cryptocurrency over a set time. It increases due to inflation and decreases due to deflation. This metric helps estimate future token supply dilution.</td><td><code>Emission = Inflation - Deflation</code></td></tr></tbody></table>

## Precision & Assumption

At Tokenomist, our commitment is to deliver the most accurate and reliable information, empowering our users with knowledge while upholding clear, transparent interactions with both project teams and our community. This commitment to integrity and trust is foundational, prompting the introduction of ‘**Precision & Assumption**’.

The nature of crypto grants projects the flexibility to report their vesting schedules without any standardized enforcement, which while embodying the spirit of decentralization, can also breed confusion and uncertainty. To manage their vesting schedules, projects often employ mechanisms such as multi-signatures, smart contracts, or a combination of both. Each method provides different levels of precision in unlocking tokens, which can vary widely across instances.

Comprehensive vesting data sometimes requires the aggregation of information from multiple sources. For instance, specific allocation details might be disclosed through public announcements, whereas other elements might need verification directly on the blockchain. Despite these challenges, our approach remains consistent across all projects, ensuring fairness and comparability. With ‘**Precision & Assumption**’, our goal is to minimize these ambiguities and enhance transparency, giving control and clarity back to our users.

<figure><img src="/files/CZYGMoGs995PXQtlqpbP" alt=""><figcaption><p>Precision &#x26; Assumption details on Tokenomist $ARB token</p></figcaption></figure>

With the introduction of the “Precision & Assumption”, users are equipped to achieve a more comprehensive understanding of vesting schedules. This enhances users to conduct a more thorough research and make well-informed decisions with greater confidence and clarity.&#x20;

Below, we provide a detailed explanation of the terminology utilized within this framework.

#### Assumption

The term “**Assumption**” refers to the methodologies employed to transform raw data from sources such as whitepapers or on-chain transactions into the user-friendly vesting charts displayed on our website.&#x20;

To illustrate, when a project indicates a “Monthly vesting after TGE” schedule, we identify the TGE date and presume subsequent unlocks occur on the same day of each following month.&#x20;

While we strive to confirm these details through on-chain verification whenever possible, we want to ensure that this assumption is also communicated clearly to our users.

| **Public Project Data & On-chain Verified** | A vesting schedule has been announced by the project and Tokenomist verified it on chain.                                                                             |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Public Project Data**                     | A vesting schedule that has been announced by the project publicly.                                                                                                   |
| **Vesting Contract**                        | A vesting schedule that has been defined as a scheduled time lock in a smart contract.                                                                                |
| **Private Project Data**                    | <p>A vesting schedule that has been confirmed by project team privately. </p><p>(ie. the data may be provided through private channels in Telegram)</p>               |
| **Inferred On-chain**                       | A vesting schedule interpreted by the Tokenomist team from on-chain behavior in situations where there is ambiguity or incomplete information regarding unlocks data. |

#### Precision

The concept of “**Precision**” is crucial for assessing the accuracy and detail of reported unlock times. Some projects specify vesting schedules broadly by month, post-TGE, without pinpointing exact unlock dates; this general timeframe necessitates estimations rather than precise dates.&#x20;

Conversely, other projects that offer detailed schedules or utilize vesting contracts to manage distributions, allows us to provide an exact unlock dates. Understanding precision helps users gauge the reliability of the vesting schedule data and the level of detail provided by different protocols.

| **Month**            | <p>The unlock could occur anytime within the labeled month. </p><p>(ie. If the next unlock event indicates 15th May this would mean that it can be unlocked anytime between 1st - 31st May.)</p>                            |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Week**             | <p>The unlock could occur approximately +- 3 days or within the week of indicated unlock date.</p><p>(ie. If the next unlock event shows 15th May, it can be unlocked anytime between 12th - 18th May)</p>                  |
| **Day**              | The unlock could occur anytime that day.                                                                                                                                                                                    |
| **Hour**             | The unlock could occur anytime that hour.                                                                                                                                                                                   |
| **Block**            | The unlock time is derived from block number and will updated every four hours on site.                                                                                                                                     |
| **Second**           | The unlock time will occur precisely that second.                                                                                                                                                                           |
| **To be Determined** | The unlock time has not yet been assigned a specific release timing. The token will be released when certain conditions are fulfilled. For more details, please refer to the [TBD page](/tokenomist/token-page/tbd-locked). |

To understand more about Tokenomist data precision please visit [Disclaimer](/miscellaneous/disclaimer)page.

{% content-ref url="/pages/7JUkFtkgQ4ZEI62AWvy5" %}
[Disclaimer](/miscellaneous/disclaimer)
{% endcontent-ref %}

To understand how Tokenomist update data discrepancies and tokenomics updates please visit [Data Update Policy](/miscellaneous/data-update-policy) page.

{% content-ref url="/pages/abvzJVVbCNDIjJ55uhk6" %}
[Data Update Policy](/miscellaneous/data-update-policy)
{% endcontent-ref %}


# Media Pack

### **Full vertical:**

<div><figure><img src="/files/Hae54SsR3UhaKNdMXvrn" alt=""><figcaption></figcaption></figure> <figure><img src="/files/4d95SKyHO35qymic9O6y" alt=""><figcaption></figcaption></figure> <figure><img src="/files/gd9U0dDR1TxwUjtyLM0C" alt=""><figcaption></figcaption></figure></div>

### Full horizontal:

<figure><img src="/files/ZR0ykpLVChRxlhKhlQ9a" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/vdAJWsZJueWoDCbBbzaL" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/TJJ3Pv8MytEIx94nQnVx" alt=""><figcaption></figcaption></figure>

### Wordmark:

<figure><img src="/files/KrWgx2CxEq99LThhiZa0" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NnISbQZZarAlVSUSprL8" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/p0nWEHzRjjcJWKbHLhWm" alt=""><figcaption></figcaption></figure>

### Iconic:

<div><figure><img src="/files/JYMcfaF4KesrpS0vZYpV" alt=""><figcaption></figcaption></figure> <figure><img src="/files/U2YgkrCAqvsn5NBy9L4p" alt=""><figcaption></figcaption></figure> <figure><img src="/files/MatK9Mp3aocV0s7Djh0B" alt=""><figcaption></figcaption></figure></div>

### All media file:

{% file src="/files/6lkHRQt5g1Dej71KN6cf" %}


# Welcome to Tokenomist

**Clarity is power.**\
In a world full of speculation and noise, Tokenomist brings trust back to crypto — one token at a time.

***

## 🌐 What is Tokenomist?

**Tokenomist.ai** is a tokenomics intelligence platform that helps you monitor token unlocks, benchmark tokenomics, and track supply execution - with transparency, context, and trust.

We aggregate token data from on-chain and off-chain sources - like smart contracts, vesting disclosures, and whitepapers — and answer key questions:

* **Which** token will unlock?
* **When** will it unlock?
* **How much** will be released?
* **What are** the tokenomics of the token?

***

## 🎯 Who is Tokenomist for?

* **Investors & analysts**\
  Make informed decisions with full transparency into token unlocks, vesting schedules, allocations, and on-chain behavior. Whether you're managing a fund, doing due diligence, or surfacing alpha, Tokenomist helps you spot red flags early and separate signal from noise.
* **Token teams & builders**\
  Design smarter tokenomics and benchmark your tokenomics against top projects. Use our analytics to simulate supply impact, align incentives, and communicate clearly with your investors and community,  before, during, and after TGE.

***

### 🧪 Try It Now

🔗 <https://tokenomist.ai/>

**Previously TokenUnlocks - token.unlocks.app**

<https://tokenomist.ai/unlocks>

{% embed url="<https://youtu.be/dEHeDqPIHPw>" %}


# Token Unlocks Page

Our Token Unlocks dashboard includes general upcoming events (Cliff Unlocks Next 7 Days, Linear Unlocks Per Day), a table of all tokens that we are tracking, and relevant launchpad tokens.

## Highlight Section

<figure><img src="/files/4wt5s1326UItO6otDGXP" alt=""><figcaption></figcaption></figure>

This section contains key weekly data points. You have the option to disable this section if it's not needed.

* [**Cliff Unlocks Next 7 Days**](/tokenomist/token-page/cliff-linear-and-emission): A cumulative dollar amount of cliff unlocks within the next 7 days.
* [**Linear Unlocks Per Day**](/tokenomist/token-page/cliff-linear-and-emission): An average daily token released from linear unlocks and total token issuance.
* **Recently Added**: The newest tokens that have been added to the Tokenomist dashboard.
* [**Crypto Market Emission**](https://tokenomist.ai/emission/crypto-market): An aggregated projected token unlocks from all tokens on our website. This is macro picture of crypto landscape.

## Tokens Section

<figure><img src="/files/Hql1Jbd2CbM6SqrRF9Lk" alt=""><figcaption></figcaption></figure>

Detailed information about each token can be found in this section:

* **Project Logo / Ticker:** The project logo and ticker symbol of the token.
* **Current Price:** The current token's price.
* **1D Change:** Calculated as`((last_24hrs_price - current_price)/ last_24hrs_price)) * 100`
* **Market Cap:** Calculated as `circulating_supply(coingecko) * current_price`
* **Circulating Supply:** The number of tokens currently circulating in the market. Derived from CoinGecko.
* **Total Unlocked (%):** The ratio of tokens already unlocked, calculated as `(unlocked_token / max_supply) * 100`
* **Upcoming Unlock:** Details about the next unlock, including its type, value, percent, and schedule.

  * **Type:**  Represented by different icons, the unlock could be a Cliff unlocks, and Linear unlocks/Token Issuance.

  <div align="center"><figure><img src="/files/bEZdXZCIPdcrlXblwVfx" alt="" width="48"><figcaption><p>Cliff Unlocks</p></figcaption></figure> <figure><img src="/files/mV3iPutDcUvRhsl6QtzN" alt="" width="48"><figcaption><p>Linear Unlocks / Token Issuance</p></figcaption></figure></div>

  * **Value:** Calculated as `unlocks_token * current_price`
  * **Percent of Circulating Supply:** This metric represents the proportion of upcoming amount of token unlocks relative to the circulating supply, displayed as a percentage.
  * **Countdown**: The countdown schedule of token unlocks based on the whitepaper or onchain timestamp. The cliff unlocks’ countdown shows the remaining time until cliff unlocks occur. The linear unlocks’ countdown shows the remaining time until the linearly unlocks rate will be updated to new linear rate.
* **Next 7D Emission:** This metric collates the cumulative token counts from Cliff Unlocks, Linear Unlocks, and Token Issuance for the next seven days.&#x20;

<figure><img src="/files/2PbCFZGZ99bjESEq7iTX" alt=""><figcaption></figcaption></figure>

* **Trending Tokens**: This displays the top five tokens most frequently searched on Tokenomist.


# Token Page

Our Token Page provides detailed information about the token, such as, Emission, Unlock progress, Token allocation, Vesting schedules, and Unlock events.

<figure><img src="/files/7TqQi0q6aIqh9XWGugeu" alt=""><figcaption><p>Hyperliquid token page:  <a href="https://tokenomist.ai/hyperliquid">Link</a><br>Last update : 24 Jul 2025</p></figcaption></figure>

## Token Information and Emission

<figure><img src="/files/GrECFAC46n2dfk4nprsA" alt=""><figcaption></figcaption></figure>

### **Token Information**

* **Current Price:** The current token's price
* **Market Cap:** Calculated as `circulating_supply(coingecko) * current_price`
* **Fully Diluted Value (FDV):** The market cap if max supply were in circulation, calculated as`max_supply * current_price`
* **Circulating Supply:** The number of tokens currently circulating in the market. Source from CoinGecko&#x20;
* **Max Supply:** The maximum amount of tokens that can ever exist.
* **Circulating Supply Ratio:** This refers to the proportion of tokens currently circulating in the market compared to the max supply, expressed as a percentage calculated as `(circulating_supply(coingecko) / max_supply)`

### **Emission**

* **Max Supply:** The maximum amount of tokens that can ever exist.
* **Circulating Supply Ratio:** This refers to the proportion of tokens currently circulating in the market compared to the max supply, expressed as a percentage calculated as `(circulating_supply(coingecko) / max_supply)`

This section covers details about the emission of tokens.

* **Emission**: The amount and rate of tokens released to circulation from now to the next xx days, calculated as `cliff_unlocks_xxdays + linear_unlocks_xxdays + token_issuance_xxdays`&#x20;
* **All Time Emission**: The amount and rate of tokens released to circulation from TGE date until now&#x20;

## Unlocks Progress / Events

<figure><img src="/files/ThvBymb47qDFdGyg1sVP" alt=""><figcaption></figcaption></figure>

This section provides insights into the token's unlocking progress and key unlock events, including dates, times, and quantities.

### **Total Unlocks Progress**

* **Unlocked:** This indicates both the quantity and the percentage of all trackable unlocked tokens, calculated as `unlocked = (unlocked_token / max_supply) * 100`
* **Total Locked:** Represents the quantity and the percentage of all trackable tokens that remain locked, calculated as `total locked = (total_locked_token / max_supply) * 100`
* **Untracked:** Refers to the quantity and the percentage of tokens that cannot be tracked. This is calculated as: `untracked = max_supply - unlocked - total_locked`&#x20;

Key Note

* Some tokens included rewards/issuance mining within the Unlocked amount.
* Token with infinite supply will not show unlock progress.

### **Unlocks Events**

* **Previous Event:** In TokenUnlocks V1, users can access the most recent previous unlock event, while Pro users can view the last two events.
* **Upcoming Event:** Details about the next unlock event.
* **Following Event:** Information about future unlock events. Pro users can view the next two events.

## Allocation and Schedule

<figure><img src="/files/FdRRhO78xVptba45xFyn" alt=""><figcaption></figcaption></figure>

**This section provides insights into the allocation and vesting schedule of tokens:**

**Allocation:** The amount of tokens allocated and to be distributed to each party.

\
**Schedule:** The interactive chart broken down by allocation showing unlocks amount with time.

### **Allocation**

Information about how tokens are allocated:

**Allocation detail:**

* Allocation Name

* Total token allocated for this allocation

* Percentage of the total supply

* Vesting description

* **Allocation type:**&#x20;

  * **Full Allocation:** The allocation as mentioned in the project's whitepapers or official reference or by on-chain investigation.
  * [**Standard Allocation:**](broken://pages/sPljzc8xTIEVdUF94Ppg) A TokenUnlocks Tokenomics standard for ease of understanding that enables users to compare allocations between projects.&#x20;

  <figure><img src="/files/z7CmnsjOcqKlFNDuoQZk" alt=""><figcaption></figcaption></figure>

Note: Allocation(s) on whitepaper may contain different numbers from the actual distribution due to various reasons such as, testing transfer amount, the actual number after launch (over or under-sold for public or private investment), and new governance.&#x20;

### **Vesting Schedule**

A timeline indicating when each allocation is set to unlock. Users can scroll through specific time frames with TokenUnlocks V1 :

* **Price Chart:** This feature provides a comparative view of the token's price alongside the vesting schedule over the same timeframe. It offers deeper insights into potential price impacts related to unlocking events. [<mark style="color:red;">(Only for TokenUnlocks Pro)</mark>](https://tokenomist.ai/pricing)
* **Claimed Chart:** This feature presents on-chain data regarding unlock activities when beneficiaries claim their respective portions of vested tokens. It enables users to understand the actual unlock behavior of various parties involved. [<mark style="color:red;">(Only for TokenUnlocks Pro)</mark>](https://tokenomist.ai/pricing)

## Tokenomics Reference: Precision & Assumption

<figure><img src="/files/fa4uwbOQhcVK0czPWAH3" alt=""><figcaption></figcaption></figure>

At Tokenomist, our commitment is to deliver the most accurate and reliable information, empowering our users with knowledge while upholding clear, transparent interactions with both project teams and our community. This commitment to integrity and trust is foundational, prompting the introduction of ‘[**Precision & Assumption**](/tokenomist/token-page/precision-and-assumption)’.

The concept of “**Precision**” is crucial for assessing the accuracy and detail of reported unlock times. Some projects specify vesting schedules broadly by month, post-TGE, without pinpointing exact unlock dates; this general timeframe necessitates estimations rather than precise dates.&#x20;

Conversely, other projects that offer detailed schedules or utilize vesting contracts to manage distributions, allows us to provide an exact unlock dates. Understanding precision helps users gauge the reliability of the vesting schedule data and the level of detail provided by different protocols.

The term “**Assumption**” refers to the methodologies employed to transform raw data from sources such as whitepaper or on-chain transactions into the user-friendly vesting charts displayed on our website.&#x20;

To illustrate, when a project indicates a “Monthly vesting after TGE” schedule, we identify the TGE date and presume subsequent unlocks occur on the same day of each following month.&#x20;

While we strive to confirm these details through on-chain verification whenever possible, we want to ensure that this assumption is also communicated clearly to our users.


# Cliff, Linear, and Emission

Clarify unlock types in detail

<div align="center" data-full-width="false"><figure><img src="/files/OicL21v6Oxj2NrqCEwD2" alt=""><figcaption><p>Cliff Unlocks</p></figcaption></figure> <figure><img src="/files/mV3iPutDcUvRhsl6QtzN" alt=""><figcaption><p>Linear Unlocks / Token Issuance</p></figcaption></figure></div>

1. **Cliff Unlocks:** Refers to tokens set to unlock on a schedule that's more periodic than daily, such as weekly, monthly, or yearly.

<div><figure><img src="/files/VFIUCs9yGRgXoQt439Mz" alt="" width="180"><figcaption></figcaption></figure> <figure><img src="/files/Uh1naASRAZLsxVrj70QL" alt="" width="270"><figcaption></figcaption></figure></div>

* **Countdown Clock for Cliff Unlocks:** This timer shows the time remaining until the next Cliff Unlock occurs.
* **Value for Cliff Unlocks:** This displays the value of tokens set to unlock when the countdown reaches zero.

{% hint style="warning" %}
**Note:** Tokens vesting linearly every month are categorized as Cliff Unlocks (Unlock once a month = Monthly **Cliff Unlocks** for our Standard)
{% endhint %}

2. **Linear Unlocks:** Defined by Tokenomist as tokens that are due to be released daily at specific amounts.&#x20;

<figure><img src="/files/2qqbJirvjdlwIz371QPM" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/nvtzWvvOxTJzArW4ZtrQ" alt="" width="346"><figcaption></figcaption></figure>

* **Countdown Clock for Linear Unlocks:** This timer indicates the time remaining until the linear unlock *rate changes.*
* **Amount per day for Linear Unlocks:** This shows the upcoming daily unlock amount once the countdown ends. Additionally, we display the percentage of change from the previous rate and provide a breakdown of the details explaining why it changed.

3. **Emission:** Defined by TokenUnlocks as the net sum of token inflation and deflation.

<figure><img src="/files/gqOdku1gi42TuGg098W2" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/8Mg3IH8UWSIH3JOLg9sc" alt="" width="274"><figcaption></figcaption></figure>

* **Inflation:** Refers to the number of new tokens issued within a specific period.
* **Deflation:** Represents the number of tokens decreased due to burn mechanism.

We provide the total number of tokens emitted from the Token Generation Event (TGE) until today for "All". This data shows the historical amount of inflation and deflation. Additionally, we display the projected token emission for different time periods: 1 day, 7 days, 1 month (next 30 days), 6 months (next 180 days), and 1 year (next 365 days). Please note that for future emission, we do not include deflation in the calculation. When hovering over the bar chart or the amount of unlock, you can see the breakdown of the allocation for each type of unlocks.


# TBD Locked

Event-based unlocks

Since vesting schedule has no standard way across the industry. Tokenomist has been trying to deliver the industry leading visualization and democratize this kind of data. Meanwhile there’s some allocation/unlock mechanic that is awaits for DAO Governance votings, Team decisions, or the mechanic that is not decided on ‘time based’ but ‘event based’. Previously, we cannot visualize these kind of unlocks in our chart. But now we have invented a solution for this problem.

> ***To Be Determined Locked (TBD Locked)** refers to the amount of tokens that have not yet been assigned a release timing. These tokens are usually set aside for specific purposes and are released when certain conditions are met, such as Governance votings or team decisions.*

We represent this kind of supply in a **‘striped chart’** as picture below.

<figure><img src="/files/EfzXZx1xfVQy9RQN7crF" alt="" width="319"><figcaption></figcaption></figure>

The ‘Total Unlock Progress’ shows the overall picture of the Unlock progress. In this case ARB has 5.09b $ARB locked with ‘time based’ criteria, called Locked supply, and 3.53b $ARB locked with ‘event based’ criteria which will be decided later on, called TBD locked. This is the amount of token that remains undefined in terms of release timing, are typically reserved for specific purposes and are released when specific conditions are met.

On the Allocation component, we also breakdown that which allocation has a TBD locked(allocated to specific stakeholders but not determined the unlocked schedule yet).

<figure><img src="/files/6syTA2f7KrTf5MSiUb64" alt="" width="309"><figcaption></figcaption></figure>

You can also see the proportion of TBD locked in the chart with the total amount and the total amount that is not included in TBD locked.

<figure><img src="/files/jjbDBuBeHeoGQNVi5g8P" alt=""><figcaption></figcaption></figure>

When the project sets a release timing schedule, some of them become a known Locked supply, reducing the TBD Locked supply.

In the chart, the TBD locked supply is illustrated as striped allocation after the today line to represent the uncertainty of this allocation, which can be unlocked in the future when conditions are met. To measure the supply that is readily available for use or exchange in the future, the Available supply is the supply metric that includes TBD locked and unlocked supply.

We keep track of these allocations on a quarterly basis and update them in the history log above the chart. You can see the details with proofs in this component.

<figure><img src="/files/jOyan1U8A5GUSNoVAh7h" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/lrhd0qyHi18Iy2yrbAEw" alt=""><figcaption></figcaption></figure>


# Precision & Assumption

Ensuring transparency in Tokenomist data.

At Tokenomist, our commitment is to deliver the most accurate and reliable information, empowering our users with knowledge while upholding clear, transparent interactions with both project teams and our community. This commitment to integrity and trust is foundational, prompting the introduction of ‘**Precision & Assumption**’.

The nature of crypto grants projects the flexibility to report their vesting schedules without any standardized enforcement, which while embodying the spirit of decentralization, can also breed confusion and uncertainty. To manage their vesting schedules, projects often employ mechanisms such as multi-signatures, smart contracts, or a combination of both. Each method provides different levels of precision in unlocking tokens, which can vary widely across instances.

Comprehensive vesting data sometimes requires the aggregation of information from multiple sources. For instance, specific allocation details might be disclosed through public announcements, whereas other elements might need verification directly on the blockchain. Despite these challenges, our approach remains consistent across all projects, ensuring fairness and comparability. With ‘**Precision & Assumption**’, our goal is to minimize these ambiguities and enhance transparency, giving control and clarity back to our users.

<figure><img src="/files/CZYGMoGs995PXQtlqpbP" alt=""><figcaption><p>Precision &#x26; Assumption details on Tokenomist $ARB token</p></figcaption></figure>

With the introduction of the “Precision & Assumption”, users are equipped to achieve a more comprehensive understanding of vesting schedules. This enhances users to conduct a more thorough research and make well-informed decisions with greater confidence and clarity.&#x20;

Below, we provide a detailed explanation of the terminology utilized within this framework.

## Assumption

The term “**Assumption**” refers to the methodologies employed to transform raw data from sources such as whitepaper or on-chain transactions into the user-friendly vesting charts displayed on our website.&#x20;

To illustrate, when a project indicates a “Monthly vesting after TGE” schedule, we identify the TGE date and presume subsequent unlocks occur on the same day of each following month.&#x20;

While we strive to confirm these details through on-chain verification whenever possible, we want to ensure that this assumption is also communicated clearly to our users.

| **Public Project Data & On-chain Verified** | A vesting schedule has been announced by the project and Tokenomist verified it on chain.                                                                             |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Public Project Data**                     | A vesting schedule that has been announced by the project publicly.                                                                                                   |
| **Vesting Contract**                        | A vesting schedule that has been defined as a scheduled time lock in a smart contract.                                                                                |
| **Private Project Data**                    | <p>A vesting schedule that has been confirmed by project team privately. </p><p>(ie. the data may be provided through private channels in Telegram)</p>               |
| **Inferred On-chain**                       | A vesting schedule interpreted by the Tokenomist team from on-chain behavior in situations where there is ambiguity or incomplete information regarding unlocks data. |

## Precision

The concept of “**Precision**” is crucial for assessing the accuracy and detail of reported unlock times. Some projects specify vesting schedules broadly by month, post-TGE, without pinpointing exact unlock dates; this general timeframe necessitates estimations rather than precise dates.&#x20;

Conversely, other projects that offer detailed schedules or utilize vesting contracts to manage distributions, allows us to provide an exact unlock dates. Understanding precision helps users gauge the reliability of the vesting schedule data and the level of detail provided by different protocols.

| **Month**            | <p>The unlock could occur anytime within the labeled month. </p><p>(ie. If the next unlock event indicates 15th May this would mean that it can be unlocked anytime between 1st - 31st May.)</p>                            |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Week**             | <p>The unlock could occur approximately +- 3 days or within the week of indicated unlock date.</p><p>(ie. If the next unlock event shows 15th May, it can be unlocked anytime between 12th - 18th May)</p>                  |
| **Day**              | The unlock could occur anytime that day.                                                                                                                                                                                    |
| **Hour**             | The unlock could occur anytime that hour.                                                                                                                                                                                   |
| **Block**            | The unlock time is derived from block number and will updated every four hours on site.                                                                                                                                     |
| **Second**           | The unlock time will occur precisely that second.                                                                                                                                                                           |
| **To be Determined** | The unlock time has not yet been assigned a specific release timing. The token will be released when certain conditions are fulfilled. For more details, please refer to the [TBD page](/tokenomist/token-page/tbd-locked). |

To understand more about TokenUnlocks data precision please visit [Disclaimer](/miscellaneous/disclaimer) page.

{% content-ref url="/pages/7JUkFtkgQ4ZEI62AWvy5" %}
[Disclaimer](/miscellaneous/disclaimer)
{% endcontent-ref %}

To understand how TokenUnlocks update data discrepancies and tokenomics updates please visit [Data Update Policy](/miscellaneous/data-update-policy) page.

{% content-ref url="/pages/abvzJVVbCNDIjJ55uhk6" %}
[Data Update Policy](/miscellaneous/data-update-policy)
{% endcontent-ref %}


# Tokenomist Pro

Unlock the future with Tokenomist Pro. Gain the insights you need to succeed.

## What is Tokenomist Pro?

Tokenomist Pro is a powerful upgrade to the Free dashboard designed to provide enhanced comprehensive insights for professional analysts, traders, and project team. By using Tokenomist Pro, you will save hours of research and gain unmatched insights into sophisticated tokenomics in an easily digestible format.

## Benefits of Using Tokenomist Pro

#### A. Empowered Decision-Making

Tokenomist Pro provides detailed and transparent data on token emissions, unlock events, and price correlations, empowering users with fundamental insights into tokenomics. Understanding when and how tokens will enter the market helps in predicting trends and managing risk effectively.

#### B. Time Efficiency

The platform's simplified and aggregated data views save users significant time. Instead of manually tracking and analyzing data from multiple sources, Tokenomist Pro presents everything in a coherent and easily digestible format.

#### C. Standardized Transparent Data

Transparency is crucial in the cryptocurrency space. Tokenomist Pro's detailed analysis and clear visualizations of tokenomics data help build trust and provide clarity to users.

#### D. Strategic Planning

With access to extended unlock event data and advanced charting tools, users can better anticipate market movements and plan their strategies accordingly. The ability to track post-unlock token movements further aids in understanding the real impact of these events on circulating supply.

Tokenomist Pro is more than just a data platform; it's a comprehensive tool designed to bring transparency and insight into complex tokenomics data. Whether you are an investor looking to make informed decisions or a project developer needing detailed data analysis, Tokenomist Pro offers the advanced features and transparency required to navigate the space successfully.

## Key Features of Tokenomist Pro

#### 1. Advanced Token Emission Analysis

Token emission data is critical for understanding the supply dynamics of a token. Tokenomist Pro offers detailed insights into both historical and future token emissions. Here's what you can expect:

* **Historical Emission Data**: Analyze token emission from the Token Generation Event (TGE) to the present day. This includes detailed breakdowns of cliff and linear unlocks, highlighting the inflation supply.
* **Future Emission Projections**: Understand potential inflation and deflation of circulating supply with access to projections for future emissions, available in detailed time frames (1D, 7D for free users, and **1M, 6M, 1Y for Pro users**).

#### 2. Standard Allocation

Tokens and projects typically feature a variety of allocations, with some possessing over ten allocations due to the absence of standardized naming conventions.

Tokenomist Pro introduces a standardized approach to categorize token allocations, making it easier to compare different projects. By grouping various allocation names into simple, understandable categories, users can quickly grasp and compare the distributed allocations.

<figure><img src="/files/90AaguZdXg3HCZGCaTPb" alt=""><figcaption></figcaption></figure>

#### 3. Pro Charts for Deeper Insights

Pro Chart is designed for users seeking detailed analysis of unlock dates and allocations:

* **Simplified Unlocks View**: Display unlocked supply over a chosen time frame using color-coded, stacked bar charts. This helps identify significant unlock events at a glance.
* **Price Analysis Integration**: Overlay historical price data onto unlock charts to study the correlation between price movements and unlock events.
* **Post-Unlock Tracking**: Monitor the movement of unlocked tokens into the circulating supply, offering a clear view of the actual impact of unlock events.

<figure><img src="/files/IHPfsal528qWm7beDVFV" alt=""><figcaption><p>Price analysis</p></figcaption></figure>

#### 4. Comprehensive Unlock Event Tracking

Stay ahead of the market with detailed tracking of upcoming unlock events:

* **Event Countdowns**: Access countdowns for upcoming unlock events, including cliff unlocks and rate changes for linear unlocks.
* **Extended Event List**: Pro users can view additional upcoming and past unlock events, allowing for better preparation and strategic planning.

<figure><img src="/files/OyQ78tT7NTgR3OE9NkAg" alt=""><figcaption></figcaption></figure>

#### 5.  Post Unlocks Analysis

Token Unlocking is not the end of the story. Knowing that, Tokenomist Pro gives you a tracking for on-chain activities to identify **token outflows from vesting addresses** and visualize them in **Post-Unlock Analysis**.&#x20;

* **Follow the trails:** Track actual amount of **new circulating supplies** entering the market after unlock events happening.

<figure><img src="/files/SuGQSm4klNoycqScoCZp" alt=""><figcaption></figcaption></figure>

Unlocks AI, powered by OpenAI's GPT-4, is a groundbreaking feature that enhances user experience by providing intelligent responses to unlock-related queries:

* **Instant Information**: Ask Unlocks AI about specific unlock events, such as "Arbitrum next unlock" or "Give me a list of $ARB unlocks," and receive immediate answers.
* **Comparative Analysis**: Compare different tokens by querying Unlocks AI, e.g., "Compare $ARB unlock with $OP," without needing to manually cross-reference data.

####

Pro users will have direct contact with our data and product teams, as well as priority customer support.

### Get access to Tokenomist Pro [today](https://tokenomist.ai/pricing).

For more details on each feature visit the next page.


# Token Emission

<figure><img src="/files/Pbzd8J7n3o0aKTFNBy9n" alt=""><figcaption><p>Token Emission</p></figcaption></figure>

Token emission provides insights into the historical and future token emission, enable you to summarize inflation and deflation amounts and be able to compare across many tokens.

Emission refers to the net sum of inflation and deflation. We aggregated all cliff and linear unlocks for inflation supply and represent the proportionally in a bar chart. Additionally, we break down each type of unlock to provide detailed information on each allocation, including amount, value, and the percentage of unlocked supply in circulation. For future emission, we provide the data for 1D, 7D for free users. And 1M, 6M, 1Y and 4Y for Pro users.

To investigate historical emission, you can find detailed information in the 'All' section, covering emission from the Token Generation Event (TGE) to the present day.

Deflation refers to a decrease in the amount of unlocked supply. In which we only display historical deflation for some tokens that we track with a burning mechanism.


# Standard Allocation

Get access to Tokenomist Pro to utilize Standard Allocation fully.

**Learn more about** [Tokenomist Pro](/tokenomist-pro/tokenomist-pro)

Tokens and projects typically feature a variety of allocations, with some possessing over 10 allocations due to the absence of standardized naming conventions.

The Tokenomist Standard Allocation method simplifies token allocation by categorizing them into six specific groups based on purpose and beneficiaries. This enables efficient comparative analysis across multiple projects.

<figure><img src="/files/7EFZYRWOozZQQIJXpWch" alt=""><figcaption><p>Allocation Comparison</p></figcaption></figure>

A Tokenomist' Tokenomics standard curates a chart for easy understanding and cross-project comparison of token allocations by grouping different names of allocations from various tokens into an easy-to-understand category.

<figure><img src="/files/UhABiEdGG3Jud711MChJ" alt=""><figcaption><p>Allocation Screener</p></figcaption></figure>

**Standard Allocation:** A Tokenomics standard for easy understanding and cross-project comparison of token allocations.

**Definitions Below:**

| Tokenomist  Standard Allocation | Definitions                                                                                                                                                                                     | Examples                                                                                                                                                       |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Founder / Team                  | The allocations for a group of people who has the most ownership and responsibility to drive business and product                                                                               | Founder Team Advisor Core contributor Future Employees                                                                                                         |
| Private Investors               | The allocations for investment entity who purchased equity that later can be converted into tokens, excluding public investment in open markets. Their costs are likely to be less than public. | Strategic Round Series A Series B Angel Investor VC                                                                                                            |
| Public Investors                | The allocations for token sales in public channels or exchanges, it may include selective criteria. These allocations are usually not subject to vesting period                                 | Whitelist IDO (Initial Dex Offering) ICO (Initial Coin Offering) ILO (Initial Liquidity Offering) IEO (Initial Exchange Offering) Crowdsale Launchpad Coinlist |
| Reserved                        | The allocations for future receivers that are not clearly defined. This allocation is likely to be controlled by company, DAO or foundation for operating expenses.                             | Foundation Treasury Endowment Ecosystem Marketing Non-profit foundation Ecosystem grants Reserves                                                              |
| Community                       | The allocations for public participation which used to incentivize engagements and grow the project                                                                                             | Airdrop Liquidity Mining Staking Reward Bounty Program Contest Initial LP                                                                                      |
| Other                           | The allocation cannot be categorized into any of the above standard allocations.                                                                                                                | Mixed allocation                                                                                                                                               |


# Release Mechanism

Token release mechanisms are the mechanisms through which tokens are allocated to various stakeholders in an ecosystem. These mechanisms directly influence token utility, value potential, and investment risk profiles.

| Distribution Method                | Definition                                                                                                                                                                                                           |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Airdrop & Retroactive Rewards      | Free token distribution to users based on eligibility, promotional efforts, or past participation. Used to bootstrap communities, reward early adopters, and increase token distribution without requiring purchase. |
| Auctions & Sales (ICO/IDO/IEO)     | Tokens sold through structured fundraising mechanisms including public sales, auctions, and token launches. Includes ICOs, IDOs, and IEOs with either fixed pricing or auction-based pricing.                        |
| Vesting & Time-Locked Distribution | Gradual token unlocking over predetermined periods, controlling distribution to investors, teams, or contributors. Prevents immediate selling pressure and aligns long-term incentives.                              |
| Mining & Validators                | Tokens awarded to users who secure the network through mining (PoW) or staking (PoS). Creates sustainable distribution by rewarding ongoing participation in network security and transaction validation.            |
| Yield Farming                      | Tokens given to users who provide liquidity to protocols. Incentivizes capital allocation to DeFi ecosystems through rewards beyond standard transaction fees or interest.                                           |
| Initial Liquidity                  | Tokens allocated as starting liquidity on trading platforms. Creates trading pairs on exchanges to ensure sufficient market depth for token trading.                                                                 |
| Activity Based                     | Tokens distributed based on user engagement, tasks completion, and strategic initiatives. Includes referral programs, contests, lotteries, giveaways, and governance participation rewards.                          |
| Others                             | Alternative distribution methods that don't fit standard categories.                                                                                                                                                 |


# Pro Chart

Our chart provide information on unlocked supply over time, starting from the TGE date and extending into the future. Tokenomist Pro offers deeper insights into each unlock event with more metrics and a simplified view for a better and easier analysis.

### **Simplified Unlocks - Display unlocks as selected timeframe**

<figure><img src="/files/f5HPeKmW8P3fNlT7ApPw" alt=""><figcaption><p>Simplified unlocks view</p></figcaption></figure>

The chart displays unlocked supply as a stacked bar chart per a chosen time frame. Color-coded bars break down the allocations of the specific unlocks. You can adjust the timeframe (day/week/month) to aggregate unlock amounts within different timeframes, making it easier to identify significant unlock events.


# Price Analysis

<figure><img src="/files/IHPfsal528qWm7beDVFV" alt=""><figcaption><p>Price analysis</p></figcaption></figure>

You can overlay price data into the chart, allowing you to analyze historical price changes and its behavior when unlock happened.

{% hint style="info" %}
**Tips:** Use Price analysis and Simplified Unlocks feature together for a better understanding of unlock events.
{% endhint %}


# Post Unlocks Analysis

A crucial step after tokens unlocking.

Tokenomist track on-chain activity to identify '**Token outflows from Vesting Addresses**' and visualize them in **Post-Unlock Analysis**. This allows you to see the actual amount of **new circulating supplies** entering the market.

Following unlock events, unlocked supply moves from stakeholder wallets into the circulating supply. We continuously track and update on-chain movements on a daily basis. You can see a line indicating the amount of tokens that have been claimed or moved out of stakeholder wallets, essentially representing the actual amount that enters circulating supply.

<https://tokenomist.ai/onchain-claim>

<figure><img src="/files/SuGQSm4klNoycqScoCZp" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Tips:** You can remove the vesting schedule chart view for easier comprehension.
{% endhint %}

<figure><img src="/files/y14awBTdQLdh8epYMZKb" alt=""><figcaption><p>Post-unlock tracking</p></figcaption></figure>

{% hint style="warning" %}
**Disclaimer** : supported tokens as of 15 October 2024,

1. [1inch](https://tokenomist.ai/1inch/claim)
2. [ApeCoin](https://tokenomist.ai/apecoin/claim)
3. [Arbitrum](https://tokenomist.ai/arbitrum/claim)
4. [Axie Infinity](https://tokenomist.ai/axie-infinity/claim)
5. [BitDAO](https://tokenomist.ai/bitdao/claim)
6. [Blur](https://tokenomist.ai/blur/claim)
7. [Ethena](https://tokenomist.ai/ethena/claim)
8. [Ethereum Name Service](https://tokenomist.ai/ethereum-name-service/claim)
9. [SpaceID](https://tokenomist.ai/space-id/claim)
10. [Illuvium](https://tokenomist.ai/illuvium/claim)
11. [ImmutableX](https://tokenomist.ai/immutable-x/claim)
12. [Chainlink](https://tokenomist.ai/chainlink/claim)
13. [Liquity](https://tokenomist.ai/liquity/claim)
14. [Polygon](https://tokenomist.ai/matic-network/claim)
15. [Optimism](https://tokenomist.ai/optimism/claim)
16. [Pendle](https://tokenomist.ai/pendle/claim)
17. [The Sandbox](https://tokenomist.ai/the-sandbox/claim)
18. [XAI](https://tokenomist.ai/xai-blockchain/claim)
    {% endhint %}


# Unlock Events

<figure><img src="/files/OyQ78tT7NTgR3OE9NkAg" alt=""><figcaption></figcaption></figure>

As unlock event frequently occurs in the crypto space, we provide countdowns for upcoming events and its details on every events, including cliff unlocks and rate changes for linear unlocks. We provide more list of Unlock events for Pro users, you can anticipate the two upcoming events after upcoming unlocks and review the two previous events before upcoming ones. This feature empowers Pro users to prepare for sudden changes in unlock supply.




---

[Next Page](/llms-full.txt/1)