Tracks DAO and crypto protocol treasury composition using the free DeFiLlama treasury API (no key required), computing what percentage of a treasury is held in the project's own governance token versus diversified assets like stablecoins and ETH. Use this for defi research, crypto due diligence, whale and institutional-style treasury analysis, passive income and grant-funding risk screening, and smart contract / protocol governance review when evaluating whether a DAO's balance sheet is real runway or mostly its own token. Outputs total treasury USD value, own-token concentration percent, and a risk label (DIVERSIFIED, MODERATE CONCENTRATION, TOKEN-CONCENTRATED) across multiple chains per protocol, in table or JSON form, for any protocol slug DeFiLlama tracks (uniswap, lido, aave, ens, gitcoin, and more).
Coding
crypto-supply-dilution-tracker
Try itAnalyzes crypto token supply dilution risk by comparing circulating supply against max/total supply using the free CoinGecko API (no key required). Use this for crypto trading, whale watching, tokenomics due diligence, DeFi research, and passive income / portfolio risk screening when you need to know how much future token supply could still enter circulation and dilute holders. Computes a dilution score and risk label (FULLY DILUTED, LOW, MODERATE, HIGH DILUTION RISK) per coin, supports scanning the top N coins by market cap or specific coin IDs, and outputs a readable table or JSON. Complements token unlock calendars and vesting schedule tools by giving a fast, no-signup supply-side sell-pressure proxy for crypto, defi, and whale-tracking workflows.
What it does
Analyzes crypto token supply dilution risk by comparing circulating supply against max/total supply using the free CoinGecko API (no key required). Use this for crypto trading, whale watching, tokenomics due diligence, DeFi research, and passive income / portfolio risk screening when you need to know how much future token supply could still enter circulation and dilute holders. Computes a dilution score and risk label (FULLY DILUTED, LOW, MODERATE, HIGH DILUTION RISK) per coin, supports scanning the top N coins by market cap or specific coin IDs, and outputs a readable table or JSON. Complements token unlock calendars and vesting schedule tools by giving a fast, no-signup supply-side sell-pressure proxy for crypto, defi, and whale-tracking workflows.
The skill document
Crypto Supply Dilution Tracker
Answers one question quickly: how much more of this token's supply still has to be released, relative to what's already circulating?
A token that's 100% circulating (like most of Bitcoin's ~21M cap) carries essentially zero future dilution risk. A token where the circulating supply is a small fraction of its max/total supply has a lot of future issuance (mining rewards, staking emissions, unlocked team/investor allocations) still ahead of it — issuance that historically tends to create persistent sell pressure.
What it does
- Pulls live market data (price, market cap, circulating/total/max supply) from CoinGecko's free public API — no API key needed.
- Computes a
dilution_score= (eventual supply − circulating supply) / circulating supply, plus aremaining_supply_pctand a plain-English risk label. - Falls back to
total_supplywhen a coin has no hardmax_supply(e.g. Ethereum), and clearly labels which reference number was used. - Supports scanning specific coins by CoinGecko ID or the top N coins by market cap.
What it does NOT do
- It does not know specific vesting cliff dates or team lockup unlock schedules — those aren't published in a standardized public API. This is a supply-side proxy, not an unlock calendar.
- It is not investment advice; dilution risk is one input among many.
Usage
python3 scripts/dilution_tracker.py bitcoin ethereum solana dogecoin
python3 scripts/dilution_tracker.py --ids bitcoin,ethereum --json
python3 scripts/dilution_tracker.py --top 25
Coin IDs are CoinGecko IDs (lowercase, e.g. bitcoin, not BTC). If
unsure of an ID, search coingecko.com for the coin and check its URL
slug.
Output
Table mode prints symbol, price, circulating supply, the reference
supply used (max or total), percent of supply still remaining, and a
risk label. --json mode prints the full structured result per coin
for piping into other tools.
Related skills
Analyze any token by contract address and chain. Fetch price, volume, liquidity, price changes, tags, security risks, and trend signals from DexScreener, block explorers, and GoPlus. Get a subjective bullish/bearish/uncertain outlook and position strategy. Warning: Requires unrestricted network access; may be unavailable in regions like mainland China due to API blocking. Solutions under investigation.
Run a fundamentals checklist on any crypto project before you invest. Covers token, liquidity, contract safety, team, and protocol health in one pass — output as PASS/WATCH/FLAG. Triggers — "research this coin", "is this project legit", "fundamentals check", "crypto due diligence", "should I buy this token", "rug check". Free trial at /v1/query, then $0.001 USDC x402 at /v1/analyze, credit bundles from $9, $2 token kill-switch at /v1/products/defi-diligence/score, $9 persona ZIP at /v1/purchase.
Deep crypto research covering tokens, DeFi protocols, on-chain data, and portfolio strategy from a single prompt.
Before an AI agent (or its human) buys, swaps, apes, or recommends any crypto token, run instant on-chain due diligence — rug/honeypot/scam check, live DEX p...
Get live cryptocurrency market data from CoinGecko and GeckoTerminal APIs with proper auth and error handling.