> ## Documentation Index > Fetch the complete documentation index at: https://docs.blockworksresearch.com/llms.txt > Use this file to discover all available pages before exploring further. # Market Statistics > Aggregated market-level statistics including total market cap, volume, and dominance metrics. ## 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 ```bash cURL theme={null} curl -H "x-api-key: YOUR_API_KEY" \ "https://api.blockworks.com/v1/market-stats?limit=10" ``` ```typescript TypeScript theme={null} 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() ``` ```python Python theme={null} 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 ```json theme={null} { "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 ## OpenAPI ````yaml GET /v1/market-stats openapi: 3.0.0 info: title: Blockworks API description: '' version: 1.0.0 contact: {} servers: - url: https://api.blockworks.com security: - x-api-key: [] tags: [] paths: /v1/market-stats: get: tags: - market-stats summary: Get Market Stat description: >- Retrieves a single market-level statistic by ID, including its value, effective time window, and metadata. Use with the list endpoint for discovery or to fetch the latest value for a specific stat. operationId: MarketStatsController_list_v1 parameters: - name: page required: false in: query schema: minimum: 1 maximum: 2147483647 default: 1 type: integer - name: limit required: false in: query schema: minimum: 1 maximum: 100 default: 100 type: integer - name: group_by required: false in: query schema: enum: - day type: string - name: query required: false in: query schema: maxLength: 65535 format: json type: string - name: order_by required: false in: query schema: default: id enum: - id type: string - name: order_dir required: false in: query schema: default: asc enum: - asc - desc type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/MarketStatsPageResponse' '400': description: Bad Request components: schemas: MarketStatsPageResponse: type: object properties: page: type: integer minimum: 1 maximum: 2147483647 total: type: integer minimum: 1 maximum: 100 data: type: array items: $ref: '#/components/schemas/MarketStatsResponse' required: - page - total - data MarketStatsResponse: type: object properties: total_usd_market_cap: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 total_usd_volume_24h: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 altcoin_usd_market_cap: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 altcoin_usd_volume_24h: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 stablecoin_usd_volume_24h: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 stablecoin_usd_change_24h: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 defi_usd_volume_24h: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 defi_usd_change_24h: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 btc_dominance: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 btc_dominance_change_24h: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 eth_dominance: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 eth_dominance_change_24h: type: number default: 0 format: double minimum: 2.2250738585072014e-308 maximum: 1.7976931348623157e+308 updated_at: type: number default: 0 description: Unix timestamp day: type: string description: Date in YYYY-MM-DD format maxLength: 255 required: - total_usd_market_cap - total_usd_volume_24h - altcoin_usd_market_cap - altcoin_usd_volume_24h - stablecoin_usd_volume_24h - stablecoin_usd_change_24h - defi_usd_volume_24h - defi_usd_change_24h - btc_dominance - btc_dominance_change_24h - eth_dominance - eth_dominance_change_24h - updated_at - day securitySchemes: x-api-key: type: apiKey in: header name: x-api-key ````