Global Stats
Cryptocurrency market overview data including global metrics, sentiment analysis, the Fear & Greed index, top movers, and DeFi analytics.
Global market metrics (total market cap, 24h volume, BTC/ETH dominance) are sourced from CoinGecko. The Fear & Greed index is provided by Alternative.me. Movers, sentiment breakdowns, and DeFi analytics are calculated by Bitcompare using this upstream data combined with our own rate data.
Market summary
Get a combined market summary including global metrics, sentiment, Fear & Greed index, and top movers in a single request. This is a BFF (Backend-for-Frontend) endpoint that consolidates multiple data sources.
The response includes a _meta field with data freshness information. If any data source is critically stale (>2 hours old), a warning is logged server-side.
Request
curl https://api.bitcompare.net/api/v1/global-stats/summary
Response
{
"data": {
"metrics": {
"totalMarketCap": 1800000000000,
"totalVolume24h": 80000000000,
"btcDominance": 52.3,
"ethDominance": 16.8
},
"movers": {
"data": [...],
"segments": 3
},
"sentiment": {
"data": [...],
"segments": 3
},
"fearGreed": {
"value": 45,
"classification": "Fear",
"timestamp": 1730212800,
"timeUntilUpdate": 3600
},
"timestamp": 1730212800,
"_meta": {
"dataAge": "5 minutes",
"isStale": false,
"isCritical": false,
"lastUpdate": "2025-10-29T14:00:00Z"
}
}
}
Market metrics
Get current global market metrics — total market cap, 24h volume, BTC dominance, and ETH dominance.
Request
curl https://api.bitcompare.net/api/v1/global-stats/metrics
Historical metrics
Get historical data for a specific metric type.
Path parameters
- Name
metricType- Type
- string
- Description
Metric type:
total_market_cap,total_volume_24h,btc_dominance, oreth_dominance.
Optional attributes
- Name
period- Type
- string
- Description
Time period:
24h,7d, or30d. Defaults to24h.
Request
curl -G https://api.bitcompare.net/api/v1/global-stats/metrics/history/total_market_cap \
-d period=7d
Response
{
"data": {
"metricType": "total_market_cap",
"period": "7d",
"history": [
{
"timestamp": 1730212800,
"value": 1800000000000
}
]
}
}
Metrics OHLC
Get OHLC (Open-High-Low-Close) data for a specific market metric. Useful for charting.
Path parameters
- Name
metricType- Type
- string
- Description
Metric type:
total_market_cap,total_volume_24h,btc_dominance, oreth_dominance.
Optional attributes
- Name
period- Type
- string
- Description
Time period:
24h(hourly),7d(hourly), or30d(daily). Defaults to24h.
Request
curl -G https://api.bitcompare.net/api/v1/global-stats/metrics/ohlc/total_market_cap \
-d period=7d
Response
{
"data": {
"metricType": "total_market_cap",
"period": "7d",
"granularity": "hourly",
"ohlc": [
{
"timestamp": 1730212800,
"open": 1750000000000,
"close": 1800000000000,
"high": 1820000000000,
"low": 1730000000000,
"avg": 1775000000000
}
]
}
}
Fear & Greed index
Get the current Fear & Greed Index value. Returns a value from 0 (Extreme Fear) to 100 (Extreme Greed).
Request
curl https://api.bitcompare.net/api/v1/global-stats/fear-greed
Response
{
"data": {
"value": 45,
"classification": "Fear",
"timestamp": 1730212800,
"timeUntilUpdate": 3600
}
}
Market sentiment
Get market sentiment analysis based on price movements across different market cap ranges.
Request
curl https://api.bitcompare.net/api/v1/global-stats/sentiment
Response
{
"data": {
"sentiment": [
{
"rankRange": "1-50",
"positive": 30,
"negative": 20,
"sentimentRatio": 1.5,
"classification": "bullish"
}
],
"segments": 3
}
}
Sentiment by rank range
Get sentiment for a specific market cap rank range.
Path parameters
- Name
rankRange- Type
- string
- Description
Market cap rank range:
1-50,51-100,101-250, orall.
Request
curl https://api.bitcompare.net/api/v1/global-stats/sentiment/1-50
Top movers
Get the top gaining and losing cryptocurrencies over the last 24 hours, segmented by market cap range.
Request
curl https://api.bitcompare.net/api/v1/global-stats/movers
Response
{
"data": {
"movers": [
{
"rankRange": "1-50",
"gainers": [
{
"rankInSegment": 1,
"slug": "bitcoin",
"symbol": "BTC",
"logo": "https://...",
"price": 45000,
"priceChange24h": 5.5,
"marketCap": 900000000000,
"marketCapRank": 1
}
],
"losers": [...]
}
],
"segments": 3
}
}
Movers by rank range
Get top movers for a specific market cap rank range.
Path parameters
- Name
rankRange- Type
- string
- Description
Market cap rank range:
1-50,51-100,101-250,1-250, orall.
The 1-250 range returns a flat array of all movers (both gainers and losers) with an isGainer boolean field, rather than the segmented gainers/losers structure.
Request
curl https://api.bitcompare.net/api/v1/global-stats/movers/1-50
DeFi overview
Get DeFi protocol metrics including TVL (Total Value Locked), yields, and protocol analytics. Includes metadata about data freshness.
Returns 503 Service Degraded if data is critically stale (more than 2 hours old).
Request
curl https://api.bitcompare.net/api/v1/global-stats/defi
Response
{
"data": {
"totalTvl": 100000000000,
"lendingTvl": 50000000000,
"stakingTvl": 30000000000,
"borrowingTvl": 20000000000,
"defiMarketDominance": 5.5,
"defiToCefiRatio": 0.8
},
"meta": {
"dataAge": "5 minutes",
"isStale": false,
"isCritical": false,
"lastUpdate": "2025-10-29T14:00:00Z"
}
}
DeFi lending
Get the latest DeFi lending metrics including top protocols, TVL, and average APYs.
Request
curl https://api.bitcompare.net/api/v1/global-stats/defi/lending
DeFi staking
Get the latest DeFi staking metrics including liquid staking dominance and staking by chain.
Request
curl https://api.bitcompare.net/api/v1/global-stats/defi/staking
DeFi borrowing
Get the latest DeFi borrowing metrics including total debt outstanding and collateralization ratios.
Request
curl https://api.bitcompare.net/api/v1/global-stats/defi/borrowing
DeFi history
Get historical data for a specific DeFi metric.
Path parameters
- Name
metricType- Type
- string
- Description
Metric type:
defi_tvl,lending_tvl,staking_tvl,borrowing_tvl,lending_apy,staking_apy, orborrow_apy.
Optional attributes
- Name
period- Type
- string
- Description
Time period:
24h,7d, or30d. Defaults to24h.
Request
curl -G https://api.bitcompare.net/api/v1/global-stats/defi/history/defi_tvl \
-d period=30d
Response
{
"data": {
"metricType": "defi_tvl",
"period": "30d",
"history": [
{
"timestamp": 1730212800,
"value": 100000000000
}
]
}
}
DeFi OHLC
Get OHLC data for DeFi metrics. Useful for charting.
Path parameters
- Name
metricType- Type
- string
- Description
Metric type:
defi_tvl,lending_tvl,staking_tvl,borrowing_tvl,lending_apy,staking_apy, orborrow_apy.
Optional attributes
- Name
period- Type
- string
- Description
Time period:
24h(hourly),7d(hourly), or30d(daily). Defaults to24h.
Request
curl -G https://api.bitcompare.net/api/v1/global-stats/defi/ohlc/defi_tvl \
-d period=7d
Response
{
"data": {
"metricType": "defi_tvl",
"period": "7d",
"granularity": "hourly",
"ohlc": [
{
"timestamp": 1730212800,
"open": 95000000000,
"close": 100000000000,
"high": 102000000000,
"low": 93000000000,
"avg": 97500000000
}
]
}
}