Methodology
12D scoring methodology
How Crypto Clarity AI calculates your portfolio health score across 12 independent risk dimensions.
How the overall score works
The 12D portfolio health score is a single number from 0 to 100. It is calculated by independently scoring each of the 12 dimensions below, then combining them using a weighted average. Higher-impact dimensions like concentration risk, drawdown risk, and correlation carry more weight than informational dimensions like profitability position.
Each dimension is scored on its own 0-100 scale with color-coded ratings: green (strong), yellow (needs attention), and red (critical risk). The overall score gives you a fast read. The individual dimension scores tell you exactly where to focus.
Crypto Clarity AI is a focused portfolio diagnostic product built around clear risk analysis for individual crypto holders.
Holdings are entered manually. No wallet connection, no account requirement, and no portfolio upload.
Pre-purchase questions, access issues, and refund requests all go through support@cryptoclarityai.com.
Data sources and update frequency
All market data is sourced from CoinGecko, covering 200+ assets with full pricing, volume, and market cap data. Prices update every 5 minutes. Historical analysis uses 180 days of daily price data for volatility, drawdown, and correlation calculations.
Smaller or newer tokens with limited historical data are flagged with a "limited data" indicator so you know exactly where coverage is strong and where assumptions are being made.
Key statistical methods
Sharpe ratio
Measures risk-adjusted return by comparing excess return over the risk-free rate to the standard deviation of returns. Used to evaluate whether portfolio returns justify the volatility taken.
180-day annualized volatility
Standard deviation of daily returns over 180 days, annualized by multiplying by the square root of 365. This gives a consistent measure of price swing risk across all assets.
Maximum drawdown
The largest peak-to-trough decline in asset value over the analysis period. Shows the worst-case historical loss for each holding and the portfolio as a whole.
Pearson correlation coefficient
Measures the linear relationship between daily returns of any two assets, ranging from -1 (inverse) to +1 (perfect correlation). Used to detect hidden concentration risk when assets move in lockstep.
Herfindahl-Hirschman Index (HHI)
Sum of squared portfolio weights. Ranges from near 0 (highly diversified) to 1.0 (single asset). The same index used by regulators to measure market concentration, applied to your portfolio allocation.
The 12 dimensions, explained
Each dimension targets a specific category of portfolio risk. Together they cover structural, statistical, and strategic health.
1. Concentration risk
Metric: Herfindahl-Hirschman Index (HHI) · Weight: High
Measures how much of your portfolio is concentrated in a single asset. If one coin exceeds 50% of total value, this dimension flags it immediately. The score uses HHI, the same index regulators use to measure market concentration, applied to your portfolio weights.
Example
A portfolio with 70% BTC, 20% ETH, 10% SOL scores poorly here. A portfolio with five assets each at 15-25% scores well.
2. Diversification
Metric: Sector and use-case spread · Weight: High
Evaluates whether your holdings span enough sectors, use cases, and risk tiers. Holding five L1 tokens is not diversification if they all move together. This dimension checks for meaningful variety across DeFi, infrastructure, store-of-value, and other categories.
Example
BTC + ETH + SOL + AVAX + MATIC = low diversification (all L1s). BTC + ETH + LINK + AAVE + RNDR = higher diversification (different use cases).
3. Volatility exposure
Metric: 180-day annualized volatility · Weight: Medium
Scores the overall price swing risk of your portfolio using 180-day annualized volatility for each holding. Assets with consistently high volatility pull your score down. This metric uses standard deviation of daily returns, annualized over 180 days of historical price data.
Example
A portfolio heavy in meme coins with 150%+ annualized volatility scores poorly. A BTC-dominant portfolio with 45% volatility scores well.
4. Liquidity
Metric: 24h trading volume vs. position size · Weight: Medium
Checks whether you could exit each position within a reasonable timeframe without significant slippage. Positions where your holding exceeds a meaningful percentage of daily volume are flagged as liquidity risks.
Example
Holding $5,000 of a token with $50M daily volume = no issue. Holding $5,000 of a token with $100K daily volume = liquidity risk.
5. Drawdown risk
Metric: Historical maximum drawdown · Weight: High
Estimates how far your portfolio could fall in a severe market-wide downturn. Uses historical max drawdown data for each asset over the past 180 days. Portfolios heavily weighted toward assets with 80%+ historical drawdowns score poorly.
Example
If your largest holding dropped 85% peak-to-trough in the last cycle, this dimension quantifies what that would mean for your current portfolio value.
6. Profitability position
Metric: Unrealized P&L relative to entry · Weight: Low
Identifies which holdings are underwater and which carry unrealized gains. While past performance does not predict future results, holding multiple deeply negative positions often indicates poor timing or lack of rebalancing discipline.
Example
Three of five holdings down 60%+ from entry = weak profitability position. Most holdings near or above entry = stronger position.
7. Allocation balance
Metric: HHI concentration index · Weight: Medium
Evaluates whether capital is distributed intentionally or piled into a few bets. Uses the Herfindahl-Hirschman Index to measure how evenly capital is spread. Extreme imbalance (one asset at 90%) scores poorly regardless of which asset it is.
Example
Equal-weight five-asset portfolio: HHI = 0.20 (well balanced). Single-asset portfolio: HHI = 1.00 (maximum concentration).
8. Large-cap stability
Metric: Exposure to top-10 market cap assets · Weight: Medium
Checks your exposure to established anchor assets like BTC and ETH that reduce overall portfolio fragility. Portfolios with zero large-cap exposure are more vulnerable to market-wide sell-offs where smaller assets drop disproportionately.
Example
50% in BTC + ETH = strong stability anchor. 100% in sub-100 market cap tokens = no stability buffer.
9. Altcoin fragility
Metric: Market cap and volume thresholds · Weight: Medium
Flags small-cap and micro-cap positions that could collapse in a downturn. Assets below certain market cap and volume thresholds are scored as fragile. This is not a judgment on the project, just a reflection of statistical risk.
Example
A token with $19M market cap and $200K daily volume is statistically more likely to experience 80%+ drawdowns than a $50B asset.
10. Yield quality
Metric: APY sustainability analysis · Weight: Low
Assesses whether yield-bearing positions offer sustainable returns or introduce hidden risk through unsustainable APY. Extremely high yields often indicate dilutive tokenomics or protocol risk that is not reflected in price alone.
Example
5% APY from ETH staking = sustainable yield. 500% APY from an unknown farm = high yield quality risk.
11. Rebalance readiness
Metric: Portfolio drift from target allocation · Weight: Medium
Detects how far your current allocation has drifted from your chosen strategy target. Shows exact dollar amounts: sell $X of one asset, buy $X of another. Supports three strategy modes: BTC Core, Balanced 12D, and Aggressive Diversification.
Example
Target: 40% BTC. Current: 65% BTC. Rebalance suggestion: sell $3,200 of BTC, buy $1,800 ETH + $1,400 across other targets.
12. Conviction vs overexposure
Metric: Pearson correlation coefficient · Weight: High
Separates intentional high-conviction positions from dangerous overexposure. Uses Pearson correlation analysis across all holdings to detect when assets that seem different actually move in lockstep, creating hidden concentration risk.
Example
SOL and AVAX with 0.92 correlation = moving together. Holding both large does not reduce risk the way holding BTC + a DeFi token would.
Strategy modes
The rebalance readiness dimension adapts to your chosen strategy. Three modes are available:
BTC Core
Heavy BTC allocation (50-70%) with satellite positions in ETH and select alts. Prioritizes stability and store-of-value exposure.
Balanced 12D
Targets even distribution across risk tiers: large-cap anchors, mid-cap growth, and small selective positions. Optimizes for the highest overall 12D score.
Aggressive diversification
Maximizes sector and use-case spread with tighter concentration limits. Accepts higher volatility in exchange for broader coverage across the crypto ecosystem.
Privacy and data handling
Your portfolio data never leaves your browser. There is no account creation, no wallet connection, and no data upload. All calculations run client-side. Market data is fetched from CoinGecko's public API. Nothing about your holdings is stored, transmitted, or logged.
The product is web app first. After purchase, you receive an access code by email and use the browser-based app immediately. Any included spreadsheets are companion tools, not the main delivery format.
See your 12D score
Enter your holdings and get your full 12-dimension portfolio health analysis in under 60 seconds.
One-time $19. 7-day refund guarantee. Questions before buying? support@cryptoclarityai.com.