What does circulating supply mean on CoinMarketCap?
Circulating supply is the amount a data provider treats as available to the public market. Your project’s job is to show how that figure was calculated and why each included or excluded balance belongs in its category.
| Figure | What to record |
|---|---|
| Total supply | Issued tokens, with burns and minting rules explained |
| Circulating supply | Tokens treated as publicly available, with calculation date |
| Excluded supply | Balances held or restricted, with wallet and reason |
Do not treat total supply, maximum supply, and circulating supply as interchangeable labels. A token can be issued but subject to a lock, vesting schedule, or other restriction. Conversely, a project-controlled wallet is not automatically excluded: document the balance and explain its status rather than relying on the wallet owner’s label.
Start with one agreed definition and apply it consistently across your tokenomics page, supply spreadsheet, and submission. If a reader cannot reproduce the result from those materials, the figure needs more work before it is sent. This distinction also matters when readers compare market capitalization, which uses price and circulating supply, with a valuation based on a larger supply figure.
How do you calculate a supportable circulating-supply figure?
Build the figure from token balances and documented exclusions. Keep the arithmetic visible so a reviewer can follow the path from chain data to the number you report.
- Identify the token contract, network, and relevant token standard.
- Establish the issued balance at a stated block or review date.
- List each balance proposed for exclusion, with its wallet and rationale.
- Subtract only the exclusions supported by records and your stated definition.
- Reconcile the result with the total-supply figure and explain any difference.
A useful working sheet has one row per wallet or contract. Include the address, balance source, category, whether the balance is locked or otherwise restricted, the relevant release condition, and a link or filename for evidence. Separate factual observations from project interpretation: the address balance is an observation; the claim that tokens are unavailable is a conclusion that needs supporting terms or controls.
Record the block or date used for each chain lookup. If supply changes through minting, burning, unlocks, or migration, note the event and update the calculation rather than silently replacing the prior figure. A reviewer should be able to recalculate the total without asking the team to explain spreadsheet formulas.
Which documents and wallet records should you prepare?
Prepare evidence that connects each supply category to a verifiable record. The aim is a compact dossier in which every exclusion has an address, a reason, and supporting documentation.
| Category | Useful supporting material |
|---|---|
| Vesting or lockups | Contract address, relevant terms, and release schedule |
| Team or investor allocations | Allocation schedule and vesting or restriction records |
| Treasury balances | Wallet list, stated purpose, and authority or governance record |
| Burns | Burn transaction and address or contract evidence |
| Token migration | Old and new contract addresses, conversion method, and reconciliation |
Use explorer records for on-chain balances and transactions. Add the governing documents that explain restrictions or allocation status; a spreadsheet alone does not establish that a balance is unavailable. For a multisignature or treasury wallet, identify its purpose and decision process in plain language. For a vesting contract, show the contract and the terms that determine when tokens can be released.
Create an evidence index that pairs each row in the calculation with a document or transaction reference. Remove unrelated personal data from files where possible, but preserve enough context to verify the claim. If a document is not public, label it clearly and confirm that the team is authorized to share it for review.
How should you prepare a CoinMarketCap supply update?
Submit one consistent explanation rather than a collection of disconnected files. The package should tell the reviewer what changed, how the number was derived, and where to verify the evidence.
Use this submission checklist:
- State the token name, symbol, network, and contract address.
- Give the proposed circulating and total supply figures, each with a reference date or block.
- Attach the calculation sheet and define each included or excluded category.
- Provide wallet addresses, relevant transaction or contract references, and supporting records.
- Explain material differences from previously published figures, if applicable.
- Check that the project website and token information use the same figures and terminology.
Keep the cover note short. Lead with the requested correction or update, then point to the relevant sheet rows and evidence filenames. Avoid claims such as “locked” without saying what enforces the restriction and when it can end. If the figure changes over time, describe the update trigger, such as an unlock or migration, and identify which records will need refreshing.
For the broader listing workflow, see how to get listed on CoinMarketCap. If the project needs a hands-on dossier review, AEOTech checks the calculation against the wallet schedule and flags unsupported exclusions before the materials are prepared for submission.
What should you check before sending the supply dossier?
Run a reconciliation review before submitting. The calculation, supporting records, and public-facing token information should describe the same supply picture.
| Review point | Pass condition |
|---|---|
| Arithmetic | The included and excluded balances reconcile to the stated figure |
| Wallet coverage | Every material exclusion has an address and category |
| Evidence | Each restriction or burn claim has a relevant record |
| Timing | Balances and calculations refer to a clearly stated date or block |
| Consistency | Website, tokenomics materials, and submission use matching definitions |
Check that addresses are copied correctly and belong to the stated network. Confirm that contract balances are not counted twice through both a wallet entry and an allocation summary. If a vesting schedule has elapsed in part, calculate the remaining restricted balance rather than treating the original allocation as wholly locked. For migrations, make clear whether holders can still access the old token and how the new supply is reconciled.
Ask a team member who did not build the spreadsheet to follow a sample row from balance evidence to the final total. If they need an oral explanation to understand why a balance is excluded, add that explanation and evidence to the dossier. For a separate profile or metadata correction, see CoinMarketCap profile remediation.
What can CoinMarketCap decide during supply review?
Your team controls the accuracy and clarity of its calculation; CoinMarketCap controls its review and the figures shown on its platform. Prepare evidence for the specific question at hand and treat the final displayed value as a platform decision.
CoinMarketCap may assess whether your definitions and records support the proposed figure, and the project cannot dictate the review outcome, the platform’s treatment of a wallet, or when an update appears. Do not describe a submission as verified until the platform’s public data reflects the change.
Make the work auditable regardless of the outcome. Save the submitted version, the evidence index, and any follow-up materials together. If the platform asks for clarification, answer the precise point raised and update the calculation only when the underlying evidence or definition warrants it. Avoid changing figures across project channels while a review is in progress unless you can explain the change and keep the records aligned.
For projects that need a structured check before submission, the circulating supply verification service focuses on the calculation, wallet classification, and evidence trail. The review is a preparation step; it does not replace the platform’s own assessment.
How do you keep circulating supply accurate after review?
Maintain a change log and revisit the calculation whenever an event changes token availability. A past submission is a snapshot, not a substitute for ongoing records.
Track the events that can affect your figure:
- Scheduled vesting releases or newly imposed restrictions.
- Treasury transfers that change the status or location of a balance.
- Token minting, burning, or contract migration.
- Governance decisions that change control over allocated tokens.
- Corrections to a prior wallet label, balance, or calculation method.
For each event, record the transaction or decision, its effective date, the affected addresses, and the resulting calculation change. Preserve the previous version so the team can explain why a figure changed. Assign one owner to maintain the wallet list and another reviewer to check the arithmetic before figures are reused in public materials.
If the project is also preparing an update for CoinGecko, keep a shared source dataset but prepare platform-specific explanations and submission materials. See how to get listed on CoinGecko for that separate process. Send AEOTech your token contract, current supply sheet, wallet categories, and available restriction records; we will begin with a named dossier review and return a list of calculation gaps and evidence to resolve.
Prices
| Service | Price | Quote |
|---|---|---|
| Supply Verification Guide | from $1,540 / project |
Starting prices in USD. Custom bundles and volume discounts on request. Payment in USDT, USDC, BTC, ETH, SOL, TON or your project token.
How it works
- Map the tokenConfirm the network, contract, supply definitions, and calculation date. Gather the current public token materials.
- Classify balancesBuild a wallet schedule and mark each balance as included or proposed for exclusion, with a reason.
- Attach evidencePair each material wallet classification with chain records, contract terms, governance records, or allocation documents.
- Reconcile the figuresCheck the arithmetic, dates, migration history, and consistency between the calculation and public materials.
- Prepare and track the updateSubmit a concise explanation with an indexed evidence package, then retain the version and respond to any clarification request.
Frequently asked questions
What is the difference between total supply and circulating supply on CoinMarketCap?
Total supply describes issued tokens under the project’s stated accounting, while circulating supply is the amount CoinMarketCap treats as available to the public market. The figures can differ when some issued tokens are subject to documented locks, vesting, or other restrictions. Define both terms and show how your calculation treats each category.
What proof should I provide for tokens that are locked?
Provide the wallet or contract address, its balance, and records that explain the restriction. Depending on the arrangement, that may include contract details, vesting terms, allocation schedules, or governance records. State the release conditions and the calculation date so a reviewer can understand what portion, if any, remains restricted.
Can tokens in a project treasury be excluded from circulating supply?
Do not exclude a treasury balance solely because the project calls it a treasury. Identify the address, purpose, control process, and any enforceable restrictions, then explain why the balance meets your stated definition of non-circulating. The calculation should distinguish a documented restriction from a project’s intention not to use the funds.
How often should we update the supply calculation?
Review it whenever an event changes the amount treated as available: for example, a vesting release, token migration, mint, burn, or change in wallet restrictions. Keep a dated version and a change log so the project can explain the difference between the figure in an earlier submission and the current calculation.
Does a complete dossier guarantee that CoinMarketCap will accept our figure?
No. A complete dossier makes your calculation and evidence easier to assess, but CoinMarketCap makes the review decision and controls the displayed data and update timing. Prepare to clarify a wallet classification or provide additional records, and avoid announcing a verified figure until the platform’s public data reflects the update.
What should we send for a supply-verification review, and what does it cost?
Send the token contract and network, the current supply calculation, wallet categories, and available vesting, treasury, burn, or migration records. AEOTech begins with a dossier review focused on reconciliation and evidence gaps. Support starts from $1,540 / project.
Tell us about your project
Answer four quick questions and a manager will send you a plan, timing and a price range within the hour. Everything stays confidential.
Loading the form…