GET
/
v1
/
market-stats
Get Market Stat
curl --request GET \
  --url https://api.blockworks.com/v1/market-stats \
  --header 'x-api-key: <api-key>'
{
  "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"

​
Example Response

{
  "page": 1,
  "total": 242970,
  "data": [
    {
      "total_usd_market_cap": 3885733306672.3,
      "total_usd_volume_24h": 132577994963.33,
      "altcoin_usd_market_cap": 1648162645554.4,
      "altcoin_usd_volume_24h": 93657982569.934,
      "stablecoin_usd_volume_24h": 127507324712.87,
      "stablecoin_usd_change_24h": 64.320919538489,
      "defi_usd_volume_24h": 17015050379.507,
      "defi_usd_change_24h": 37.16927938064,
      "btc_dominance": 57.584257192218,
      "btc_dominance_change_24h": -0.239407097782,
      "eth_dominance": 13.465493159862,
      "eth_dominance_change_24h": -0.039550300138,
      "updated_at": 1757351101,
      "day": "2025-09-08"
    }
  ]
}

​
Supported Options

NameTypeDescription
pagequeryPage number for pagination (default: 1)
limitqueryNumber of results per page (max: 100, default: 100)
group_byqueryGroup results by time period (options: day)
queryqueryJSON filter query
order_byqueryField to order results by (default: id)
order_dirqueryOrder direction (asc or desc, default: asc)

​
Response Fields

FieldTypeDescription
total_usd_market_capnumberTotal cryptocurrency market capitalization in USD
total_usd_volume_24hnumberTotal 24-hour trading volume in USD
altcoin_usd_market_capnumberMarket cap of all cryptocurrencies excluding Bitcoin
altcoin_usd_volume_24hnumber24-hour trading volume of altcoins in USD
stablecoin_usd_volume_24hnumber24-hour trading volume of stablecoins in USD
stablecoin_usd_change_24hnumber24-hour percentage change in stablecoin volume
defi_usd_volume_24hnumber24-hour trading volume of DeFi tokens in USD
defi_usd_change_24hnumber24-hour percentage change in DeFi volume
btc_dominancenumberBitcoin’s percentage of total market cap
btc_dominance_change_24hnumber24-hour change in Bitcoin dominance percentage
eth_dominancenumberEthereum’s percentage of total market cap
eth_dominance_change_24hnumber24-hour change in Ethereum dominance percentage
updated_atnumberUnix timestamp of last update
daystringDate 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

​
x-api-key
string
header
required

Query Parameters

​
page
integer
default:1
Required range: 1 <= x <= 2147483647
​
limit
integer
default:100
Required range: 1 <= x <= 100
​
group_by
enum<string>
Available options:
day
​
query
string<json>
Maximum length: 65535
​
order_by
enum<string>
default:id
Available options:
id
​
order_dir
enum<string>
default:asc
Available options:
asc,
desc

Response

200
application/json

The response is of type object.