This app runs inside the BotSurf browser. Don't have it yet? Get the app or extension now!

Circulating Supply Accuracy Checker

Portfolio Insights · All
0 installs · Verified BotGentz app
Launch App
Opens in BotSurf — try it free, no account needed.
CategoryPortfolio Insights
PlatformAll
Pricing $4.99/mo
Installs0
Free 7-day trial, no card. Or hold 25,000 BOT instead.
Get BotSurf — free
The browser these apps run in. Free on every platform, no account needed to try an app.

About this app

WHAT IT DOES

Circulating Supply Accuracy Checker analyzes a token's circulating supply and checks whether the reported figures are accurate before you invest. The tool reads the token contract to fetch the total supply, then calculates the on-chain circulating supply by subtracting locked supply, burned supply, team/treasury allocations, staking contract balances, and liquidity pool balances. It then compares the calculated circulating supply against the reported circulating supply (often shown on CoinMarketCap, CoinGecko, or the project's website) and calculates an accuracy percentage and grade. The tool then uses AI to generate a plain-language explanation of the circulating supply accuracy: what the reported circulating supply is, what the on-chain calculated circulating supply is, the difference, what accounts for any discrepancies (locked tokens, burned tokens, team allocations, staking contracts, liquidity pools), and whether the reported figures appear accurate. Results include a risk level, accuracy grade (A-F), accuracy percentage, total supply, locked supply, burned supply, team allocation, staking supply, liquidity supply, calculated circulating supply, reported circulating supply, discrepancy amount, flags, and a comprehensive AI-generated explanation. The tool operates entirely read-only — no transactions are sent, no signatures are required. The AI assessment is designed to help you identify tokens with inflated or inaccurate circulating supply figures before you invest.

HOW TO USE

Connect your EVM wallet using the "Connect" button in the header. Select the network where the token is deployed from the dropdown menu. Enter the token contract address you wish to analyze. Optionally enter the token name if you know it. Click "Check circulating supply accuracy" to begin the analysis. The tool reads the contract to fetch total supply, estimates locked, burned, team, staking, and liquidity supplies from on-chain patterns, calculates the circulating supply, and sends the data to the AI for a plain-English supply accuracy explanation. Results appear within seconds, showing the token contract, chain, risk level, accuracy grade, accuracy percentage, total supply, locked supply, burned supply, team allocation, staking supply, liquidity supply, calculated circulating supply, reported circulating supply, discrepancy amount, flags, and a comprehensive AI-generated explanation written in clear, conversational language.

CIRCULATING SUPPLY CALCULATION AND ACCURACY SCORING

The tool uses a pattern-based approach to calculate circulating supply from on-chain data. It first reads the total supply from the contract. It then estimates locked supply (from vesting contracts or lock patterns, 10-40% of total), burned supply (from burn events or patterns, 2-10% of total), team/treasury allocation (from known patterns, 5-25% of total), staking contract balances (from staking patterns, 3-18% of total), and liquidity pool balances (from liquidity patterns, 2-12% of total). The circulating supply is calculated as total supply minus these subtractions. The accuracy percentage is calculated as (calculated circulating / reported circulating) × 100%. The accuracy grade is determined by the accuracy percentage: A (95%+), B (85-94%), C (70-84%), D (50-69%), F (below 50%). The risk score is calculated based on: accuracy below 70% (2 points), accuracy below 85% (1 point), team allocation over 20% (1 point), and locked supply over 30% (1 point). The AI receives all this data and is prompted to explain the circulating supply accuracy in plain language — stating the reported and calculated circulating supply, the difference, and what accounts for any discrepancies. The AI is also instructed to state plainly what it cannot verify — that it calculates circulating supply from on-chain balances and known patterns, not off-chain locked tokens, lost tokens, or tokens held in non-standard contracts.

WHAT IT CANNOT SEE

This tool cannot definitively verify off-chain locked supply or team allocations — only reads on-chain balances and contract logic. It cannot detect tokens locked in non-standard contracts or off-chain agreements — some tokens have lock arrangements that are not visible on-chain. The tool cannot account for tokens that are lost or inaccessible — lost tokens reduce actual circulating supply but may still be counted in total supply. The tool cannot predict future supply changes — token supply can change over time. Legitimate tokens may have complex supply mechanics that are difficult to parse — the tool may not detect all locked or non-circulating tokens. The tool cannot detect if the reported circulating supply is from a legitimate source. The tool cannot verify that the token is correctly categorized. The tool cannot detect if the token has been delisted or is under investigation. The tool cannot predict the token's future price or market performance.

PLEASE NOTE

Circulating Supply Accuracy Checker supports EVM-compatible chains only (Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche, and others). The tool is read-only and never requests wallet signatures or transaction approvals. Supply accuracy assessments are AI-generated from on-chain data and estimated metrics — always verify circulating supply through the token's official documentation, block explorers, and independent research before investing. The AI assessment is for informational purposes only and does not constitute financial or legal advice. An accurate circulating supply is one factor among many — always consider the full picture including team, technology, roadmap, and market conditions before investing.

Similar Apps

Log in to BotGentz

Suggest an App

Tell us what you'd find useful — if we build it, we'll email you the moment it's ready.