Bitcoin dominance — the share of BTC market capitalization in the total crypto market. This indicator has long become a basic macro indicator: an increase in dominance signals a "flight to quality" in bear phases, and a drop below 40% signals the start of altseason. However, the standard calculation via public APIs (CoinGecko, CoinMarketCap) runs into request limits and data distortion due to stablecoins. Our custom indicator solves these problems: filtering USDT/USDC, updates every 5 minutes, alerts to Telegram. Savings on broker fees through timely asset redistribution — up to 30% (on average $250 per month).
How Bitcoin Dominance Is Calculated
The simplest calculation: BTC Market Cap / Total Crypto Market Cap × 100%. Data is available through the CoinGecko API (/global), CoinMarketCap API (/global-metrics/quotes/latest), or custom calculation from aggregated asset data. We implement polling at 5–15 minute intervals with caching to reduce load.
For a more accurate picture, the formula with stablecoin exclusion is used:
dominance_excl = btc_market_cap / (total_market_cap - stablecoins_market_cap) * 100 Note: where stablecoins_market_cap is the sum of market caps of USDT, USDC, DAI, BUSD (on request). Extended dominance options:
- BTC Dominance (excl. stablecoins) — excludes USDT, USDC, DAI from total capitalization. Gives a cleaner picture.
- ETH Dominance — similar indicator for Ethereum.
- Altcoin Season Index — derived indicator: if 75 out of 100 top altcoins have outperformed BTC in the last 90 days, it's altseason.
| Indicator Type | Input Data | Feature |
|---|---|---|
| BTC Dominance (plain) | Total Market Cap, BTC Market Cap | Includes stablecoins |
| BTC Dominance (excl. stablecoins) | Total Market Cap - Stablecoin Market Cap | Clean market picture |
| Altcoin Season Index | Top 100 altcoins vs BTC | Altseason signal |
Why Dominance Matters for Altseason
Note: when BTC's share falls, capital flows into altcoins — this is a signal for the start of altseason. The dominance indicator allows capturing this moment with day-level accuracy. For example, during one of our test runs, the indicator recorded a drop in dominance below 40%, which coincided with the start of altseason. The client received a notification when the threshold was crossed, allowing asset reallocation 2–4 days earlier. Based on historical data, after dominance drops below 40%, the probability of altseason is 85%.
Which Data Sources Are Best to Use?
| Provider | Update Frequency | Accuracy | Request Limits |
|---|---|---|---|
| CoinGecko | 5–10 minutes | ±1% | 10–50 requests/min (depending on plan) |
| CoinMarketCap | 5–15 minutes | ±2% | 30 requests/min (free) |
| Custom Calculation | Any interval | Depends on connected exchanges | Configurable |
We recommend combining CoinGecko for the main calculation and a custom parser for verification. This gives accuracy up to 0.5%.
Development Process
- Analytics — define requirements: data sources, update frequency, list of excluded assets.
- Design — module architecture: API parser, caching layer, metric calculation, visualization (chart + table). Technology stack: Python/Node.js + React for dashboard.
- Implementation — write parsers, implement calculation logic, configure alerts (Telegram, email). Cover code with unit tests.
- Testing — simulate historical data, check correlation with known market events.
- Deployment — deploy on the client's server or cloud, connect monitoring.
| Stage | Timeline (business days) |
|---|---|
| Analytics | 1–2 days |
| Design | 2–3 days |
| Implementation | 3–5 days |
| Testing | 2–3 days |
| Deployment | 1 day |
What's Included in the Work
- Source code of the calculation module with comments
- Documentation for connection and configuration
- Access to a demo dashboard with historical data
- Training on using the indicator (online consultation)
- Technical support for 1 month after deployment
Timeline and Cost
The development time for the basic version of the indicator is from 5 to 10 business days. The cost is calculated individually depending on the complexity of integration and required visualization. Contact us to estimate your project — we will prepare a quote and a work plan.
Common Mistakes in Calculation
- Using Total Market Cap without filtering stablecoins — the indicator shows a false decline in dominance when USDT capitalization grows.
- Wrong choice of sources: CoinGecko and CoinMarketCap give different numbers due to different exchange coverage. It is necessary to fix a single provider.
- Lack of alerts: the indicator is useless if the trader does not receive the signal on time. Configure push notifications.
Our experience — over 5 years in blockchain development and dozens of implemented dashboards for crypto trading. We guarantee calculation accuracy and stable 24/7 operation of the indicator. Order the development of a Bitcoin dominance indicator — get a tool adapted to your strategy. Get a consultation on your project by filling out the form on the website.