Market Statistics

GET

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

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

Show child attributes

List Reports About Metrics

⌘I

Introduction

Assets

Chart Data

Token Transparency

Market Stats

Metrics

Metrics: Chains

Metrics: Projects

Metrics: ETFs

Metrics: Treasuries

Overview

Example Request

Example Response

Supported Options

Response Fields

Use Cases

Authorizations

Query Parameters

Response

​Overview

​Example Request

​Example Response

​Supported Options

​Response Fields

​Use Cases

Authorizations

Query Parameters

Response

Overview

Example Request

Example Response

Supported Options

Response Fields

Use Cases