CSV Export
A Guide to using Tokenomist's CSV
Last updated
A Guide to using Tokenomist's CSV
Last updated
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 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.
You can export the release supply schedule for one token at a time. These following parameters are available for customization
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
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.
Parameter name
Description
Raw Allocation
The original allocation name that directly came from the project.
Standard Allocation
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 for more details
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
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
The standardized version of allocation which makes it possible to compare allocation among multiple tokens. More details in
