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
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 |
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. |
|
Please visit our methodology page 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 |
|
Percentage of Available Supply Y+5 | Percentage relative to available supply in next 5 years from today |
|
Supply calculation method
Parameter name | Description | Calculating Method |
Cumulative | Total unlocked supply / available supply from token TGE till specified | |
Non-Cumulative | Total unlocked supply that occurs during | This calculation is available in |
Last updated
