# CSV Export
### 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](/tokenomist-pro/standard-allocation.md) |
#### 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.md) 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 |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.unlocks.app/api-documents/csv-export.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.