Skip to content
Web3 Marketing Blog

CoinGecko Supply Verification: Documents Token Teams Should Prepare

CoinGecko supply verification is easier to assess when the team can trace reported supply to on-chain data and explain every material allocation. Use this guide to assemble a clear, internally consistent evidence pack before contacting CoinGecko.

Key pointsCoinGecko supply verification is a review of the information a project provides to support its circulating supply data. Prepare the token contract and network details, wallet addresses, allocation records, vesting or lock evidence, and a reconciliation that connects those records to your reported figure. The team gets a review-ready evidence pack; timing and decisions are made by CoinGecko.
  • Discreet, NDA-first engagements
  • Regional launch within a day
  • Settle in USDT, USDC or project tokens

Updated:

What does CoinGecko supply verification assess?

CoinGecko supply verification assesses the evidence behind a token’s supply information, including how the project arrives at its circulating supply figure. Your task is to make the calculation understandable and to show how the underlying allocations and balances support it. A number without a traceable explanation is harder to assess than a number connected to wallets, records and clear definitions.

Start by writing down the exact figure and the point in time it represents. State the token contract, network and unit used, then describe how the project distinguishes circulating tokens from allocations it treats as restricted or not yet circulating. Relevant categories may include treasury, team, investor, ecosystem, liquidity and vesting allocations. Do not assume that a category name alone explains its treatment; show the wallet or agreement evidence behind it.

Before assembling files, compare your definitions with CoinGecko’s current guidance. Its methodology and review requirements are the reference for the submission, not an internal spreadsheet or a prior answer from another platform. The official CoinGecko support site is a sensible starting point for checking current instructions.

The practical test is simple: could a reviewer follow your explanation from the reported figure to the supporting records without having to guess which wallets or allocations you mean? If not, resolve the gaps before submitting.

Which CoinGecko circulating supply documents should you prepare?

Prepare documents that establish identity, show balances and explain how allocations are treated. The strongest pack uses a small number of well-labelled sources rather than a large folder of unconnected screenshots.

Use this checklist as a starting point, then confirm the exact submission requirements in CoinGecko’s current guidance:

  • Token identity: project name and ticker, network, contract address, and links to the relevant block explorer and project materials.
  • Supply source: a clear description of how total and circulating supply are obtained, including any contract functions or other on-chain records used in the calculation.
  • Wallet map: addresses controlled by the project or associated with a material allocation, with each address linked to a short explanation of its purpose.
  • Allocation evidence: token allocation schedules, signed or published tokenomics materials, and records that connect allocations to wallets where available.
  • Restriction evidence: vesting schedules, lock contracts, custody documentation or other records that support a claim that tokens are restricted.
  • Reconciliation: a dated table connecting the reported figure to included and excluded balances, with sources for each line.

For records that are not public on-chain, provide an appropriate supporting document and explain what it establishes. Redact sensitive information only where doing so does not remove the facts needed to assess the claim. Keep an unredacted source available to the team in case CoinGecko asks for clarification.

Get a price for your project

Send a link to your project and a contact. We reply with a plan, timing and price.

How should teams reconcile wallet balances with circulating supply?

A reconciliation should let another person reproduce the logic behind your reported supply figure. It should identify the source balance for each relevant wallet, explain whether that balance is included, and connect exclusions to evidence rather than assumptions.

Build the table with fields such as wallet address, allocation category, balance source, balance date, treatment in the calculation and supporting document. Use token units consistently and record the date or block reference for every balance snapshot. If the project uses a different method for a particular allocation, state the reason in a note and cite the evidence that supports it.

Check the arithmetic independently. Confirm that wallet balances are not counted twice under different labels, that the sum of the line items matches the figure being submitted, and that the same token decimals and units appear in the spreadsheet and written explanation. Where tokens move between wallets, make clear whether the records describe the same allocation at different points or separate holdings.

A useful review is to ask someone outside the person who prepared the file to follow the calculation using only the pack. If they cannot reproduce the total or understand why an allocation is excluded, improve the explanation before submission. This same source discipline is useful when preparing circulating supply verification support or reviewing the supply verification process for CoinMarketCap; each platform’s instructions still need to be checked separately.

How can you make the evidence easy to review?

Organize the evidence so each supply claim points directly to a source. A short index and consistent file naming help a reviewer move from your summary to the record that supports it, without hunting through unrelated project materials.

A practical folder structure is:

  • 01 Overview: a concise explanation of the reported supply figure, its date and calculation method.
  • 02 Token and network: contract details and links to on-chain records.
  • 03 Wallets and allocations: the wallet map and allocation table.
  • 04 Restrictions: vesting, lock or custody evidence for balances treated as unavailable for circulation.
  • 05 Reconciliation: the calculation and source references for each line.

Name files by subject and date, and use one spelling for the project, token, ticker and wallet labels throughout. In the overview, include a source reference beside each important statement; for example, point to the specific table row or document that supports a lock or allocation claim. Where a record is available publicly, link to the primary source rather than relying only on a copied image.

Before sharing, check that links open, files are readable and the pack does not contain contradictory versions of the supply figure. Keep a copy of the exact submission and the evidence sent with it. This creates a reliable basis for responding if the reviewer asks what a particular address represents or how an adjustment was calculated.

What should you do before and after submitting the information?

Submit only after the token details, reconciliation and supporting records tell one consistent story. A final review should catch avoidable mismatches before they become follow-up questions.

Before sending information, check that:

  • the network and contract address match the project’s public materials;
  • the reported figure is tied to a clearly stated date or on-chain reference;
  • every material wallet has a label and an explained treatment;
  • excluded balances have supporting evidence and a stated rationale;
  • the calculation uses consistent units and can be reproduced from the attached sources;
  • public-facing token information does not conflict with the figures in the evidence pack.

Use the submission route and format stated in CoinGecko’s current instructions. Keep the submission confirmation, a copy of every file and a record of who on the team can answer technical or allocation questions. If CoinGecko requests clarification, respond to the specific point, update the relevant calculation or document, and identify what changed. Avoid sending a replacement figure without explaining how it differs from the previous one.

The review timeline is controlled by the platform and can be affected by its queue and any requests for additional information. Your team can control the completeness and clarity of its response, but should not announce a decision or timing until CoinGecko has confirmed it.

Frequently asked questions

What documents do we need to verify token supply on CoinGecko?

Prepare token and network details, contract and wallet addresses, an allocation map, records supporting any vesting or lock claims, and a reconciliation showing how the reported figure was calculated. Include clear source references and check CoinGecko’s current instructions before submitting, since its requested information can change.

Does CoinGecko require a particular circulating supply spreadsheet?

Use a format that makes the calculation easy to follow: list each relevant wallet or allocation, its balance source and date, whether it is included, and the reason for its treatment. Check CoinGecko’s current submission guidance for any required format. The important preparation step is making the total reproducible from the records you provide.

How long does CoinGecko supply verification take?

There is no project-controlled review deadline. CoinGecko sets its review queue and may ask for further evidence, so the time to a decision can vary. Your team can reduce avoidable back-and-forth by sending a complete reconciliation, checking links and keeping a knowledgeable contact available to answer questions.

Can anyone guarantee that CoinGecko will accept our circulating supply figure?

No. CoinGecko controls its methodology, assessment of the submitted records, classification and update timing. An adviser can help make the wallet map and calculation clearer, but cannot promise acceptance or a display change. Submit a figure your team can substantiate, and treat any platform request for clarification as part of its review.

Share your project with our regional team

Four short questions and a regional lead replies within the hour with a channel plan, timing and a budget range. Discretion guaranteed.

Loading the form…

Get a quote

Leave a contact and we will send a plan and the price.