Guide: CoinGecko Supply Update Form

Submission of Token supply information

Note: Please ensure you select the correct token, as selecting the wrong token will result in rejection. Fields marked with an asterisk (*) are mandatory. Missing information on locked wallets will result in rejection, except for project with fully circulated supply.

To get started with submitting Supply Information on CoinGecko, you may refer to the steps below:

1. Login to your CoinGecko account if you already have one. If not, please sign up for a CoinGecko account. You may refer to this article for more information.
2. Once logged in, navigate to the bottom of CoinGecko main site and click “Request Form”, select “Token Supply”. If you logged in after you clicked “Request Form”, you should be redirected to the form. If not, please click this link.
3. You will be directed to the token supply information form.
4. Please fill up all the required fields in the form. Ensure you select the correct coin, as selecting the wrong coin will result in rejection. Fields marked with an asterisk (*) are mandatory. Missing information on locked wallets will result in rejection, except for projects with fully circulated supply. We encourage you to provide as much information as possible.
5. Once all the information is filled up, click “Submit”. 
6. You should receive a submission confirmation email.

Fields to Note When Filling the Supply Information

Total Supply and Burned wallets

In the "Total Supply" section, you'll find an option to include the Burn Token Wallet contract address in the bottom right corner.

According to CoinGecko's methodology, the Total Supply is calculated as the Maximum Supply minus the total number of burned tokens. 

What is a burned wallet?

A burned wallet refers to wallets that hold tokens that have been permanently removed from circulation, typically through a deliberate act of burning. These tokens are no longer part of the circulating supply. An example of a burned wallet is 0x000000000000000000000000000000000000dEaD

Circulating Supply and Vested/Locked/Uncirculated wallets

In the “Circulating Supply” section, you’ll find an option to include the Vested/Locked/Uncirculated Wallet contract address in the bottom right corner.

According to CoinGecko’s methodology, the Circulating Supply is derived by subtracting the total number of tokens in uncirculated wallets and this includes locked or vested wallet as well as those held by foundation or treasury (i.e. tokens not available for public trading).

You may add more than one locked wallet by clicking the "+ Add Vested/ Locked Wallet" button on the below-Circulating Supply API field.

What are vested and locked wallets?

Vested wallets house tokens allocated under predetermined release schedules or conditions, commonly associated with team members, advisors, or investors. Conversely, locked wallets secure tokens inaccessible or restricted for a designated period, typically for security or governance purposes.

In essence, vested/locked wallets comprise tokens held within wallets subject to locking or vesting periods and should not be accounted for in the circulating supply. Examples include Development Funds, Foundation Funds, Team Vesting Funds, and Seed Investors Allocation.

Initial token allocation

Initial token allocation refers to the distribution of tokens among its stakeholders when a project is launched. The tokens are typically distributed across several categories, each serving specific purposes within the project:

1. Airdrops - Distribution of tokens to the general public to generate interest and engage potential users.
2. Public Sales - Tokens sold to the general public to raise capital and increase token circulation.
3. Presales - Early sales of tokens to strategic investors and early adopters.
4. Ecosystem - Tokens reserved for the development and incentivization of the project ecosystem.
5. Treasury/Reserve - Tokens set aside to fund future operational needs.
6. Community and Marketing - Tokens dedicated to building the community and marketing the project.
7. Partnership - Tokens allocated to current and future partners to facilitate collaboration and integration.
8. Founders and Team - Tokens allocated to the project’s founders and team members.
9. Advisors - Tokens given to advisors who contribute expertise to the project.

Initial token allocation is important to provide clarity on deriving Circulating Supply as it identifies the proportion of tokens that are immediately/not immediately tradable, and predict how much of the total supply is likely to be actively traded soon after the token launch. It also provides an estimation on the circulating supply value at any given moment based on vesting schedules and release mechanism outlined in initial token allocation. 

Tracking Token Supply Application Status

To check the status of your request:

1. Select the “View My Requests” button.

2. You will be able to view your token supply application status.

Token Supply Update Request Outcome

Approved: You will receive an email notification saying Token Supply Update Request has been updated on CoinGecko

Rejected: You will receive an email notification saying their Token Supply Update Request has been rejected.

For further information on why your request is rejected, please refer to this guide.

FAQs

For FAQs, please refer to this link.