# Introduction

{% 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.


---

# 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/introduction.md?ask=<question>
```

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.
