Market Stats
Market Statistics
Aggregated market-level statistics including total market cap, volume, and dominance metrics.
GET
/
v1
/
market-stats
Get Market Stat
curl --request GET \
--url https://api.blockworks.com/v1/market-stats \
--header 'x-api-key: <api-key>'import requests
url = "https://api.blockworks.com/v1/market-stats"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.blockworks.com/v1/market-stats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"page": 1073741824,
"total": 50,
"data": [
{
"total_usd_market_cap": 0,
"total_usd_volume_24h": 0,
"altcoin_usd_market_cap": 0,
"altcoin_usd_volume_24h": 0,
"stablecoin_usd_volume_24h": 0,
"stablecoin_usd_change_24h": 0,
"defi_usd_volume_24h": 0,
"defi_usd_change_24h": 0,
"btc_dominance": 0,
"btc_dominance_change_24h": 0,
"eth_dominance": 0,
"eth_dominance_change_24h": 0,
"updated_at": 0,
"day": "<string>"
}
]
}Overview
Market statistics provide high-level aggregated metrics for the entire cryptocurrency market, including:- Total and altcoin market capitalization
- 24-hour trading volumes
- Bitcoin and stablecoin dominance percentages
- DeFi and L1/L2 metrics
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.blockworks.com/v1/market-stats?limit=10"
const res = await fetch(
'https://api.blockworks.com/v1/market-stats?limit=10',
{ headers: { 'x-api-key': 'YOUR_API_KEY' } }
)
const data = await res.json()
import requests
r = requests.get(
'https://api.blockworks.com/v1/market-stats',
headers={'x-api-key': 'YOUR_API_KEY'},
params={'limit': 10}
)
data = r.json()
Example Response
{
"data": [
{
"total_usd_market_cap": 4184815466964,
"total_usd_volume_24h": 209459192161.82,
"altcoin_usd_market_cap": 1741060179376.7,
"altcoin_usd_volume_24h": 137649310992.76,
"stablecoin_usd_volume_24h": 203568112110.9,
"stablecoin_usd_change_24h": -7.753662255777,
"defi_usd_volume_24h": 23131204056.565,
"defi_usd_change_24h": 0,
"btc_dominance": 58.395771734235,
"btc_dominance_change_24h": 0.196131264235,
"eth_dominance": 12.848271032567,
"eth_dominance_change_24h": -0.166719317433,
"updated_at": 1759940102,
"date": "2025-10-08T16:12:59.000Z"
}
],
"total": 251599,
"page": 1
}
Supported Options
| Name | Type | Description |
|---|---|---|
page | query | Page number for pagination (default: 1) |
limit | query | Number of results per page (max: 100, default: 100) |
group_by | query | Group results by time period (options: day) |
query | query | JSON filter query |
order_by | query | Field to order results by (default: id) |
order_dir | query | Order direction (asc or desc, default: asc) |
Response Fields
| Field | Type | Description |
|---|---|---|
total_usd_market_cap | number | Total cryptocurrency market capitalization in USD |
total_usd_volume_24h | number | Total 24-hour trading volume in USD |
altcoin_usd_market_cap | number | Market cap of all cryptocurrencies excluding Bitcoin |
altcoin_usd_volume_24h | number | 24-hour trading volume of altcoins in USD |
stablecoin_usd_volume_24h | number | 24-hour trading volume of stablecoins in USD |
stablecoin_usd_change_24h | number | 24-hour percentage change in stablecoin volume |
defi_usd_volume_24h | number | 24-hour trading volume of DeFi tokens in USD |
defi_usd_change_24h | number | 24-hour percentage change in DeFi volume |
btc_dominance | number | Bitcoin’s percentage of total market cap |
btc_dominance_change_24h | number | 24-hour change in Bitcoin dominance percentage |
eth_dominance | number | Ethereum’s percentage of total market cap |
eth_dominance_change_24h | number | 24-hour change in Ethereum dominance percentage |
updated_at | number | Unix timestamp of last update |
day | string | Date in YYYY-MM-DD format |
Use Cases
- Market Overview Dashboards: Display high-level market metrics
- Market Trend Analysis: Track market growth and sector dominance over time
- Portfolio Benchmarking: Compare portfolio performance against market averages
- Research Reports: Source authoritative market statistics for analysis
Authorizations
Query Parameters
Required range:
1 <= x <= 2147483647Required range:
1 <= x <= 100Available options:
day Maximum string length:
65535Available options:
id Available options:
asc, desc