Skip to main content
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

{
  "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

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 string length: 65535
​
order_by
enum<string>
default:id
Available options:
id
​
order_dir
enum<string>
default:asc
Available options:
asc,
desc

Response

​
page
integer
required
Required range: 1 <= x <= 2147483647
​
total
integer
required
Required range: 1 <= x <= 100
​
data
object[]
required