> ## 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.

# Get Single Asset Market Cap

> Retrieve market cap data for a specific asset

## Overview

Get the current market cap information for a specific asset. This endpoint returns just the market cap data block with `asset_code` and `asset_slug` included.

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.blockworks.com/v1/assets/ethereum/market-cap"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    'https://api.blockworks.com/v1/assets/ethereum/market-cap',
    { 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/assets/ethereum/market-cap',
    headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = r.json()
  ```
</CodeGroup>

## Example Response

```json theme={null}
{
  "rank": 2,
  "usd": 4456.91,
  "dominance": 11.9754,
  "percent_change_btc_1h": -0.134556,
  "percent_change_btc_24h": -1.56252,
  "percent_change_usd_1h": 0.0999065,
  "percent_change_usd_24h": -0.63777,
  "percent_change_usd_7d": 2.94011,
  "percent_change_usd_30d": 2.0461,
  "percent_change_eth_1h": 0,
  "percent_change_eth_24h": 0,
  "updated_at": 1759940402,
  "asset_code": "ETH",
  "asset_slug": "ethereum"
}
```

### Response Fields

| Field                    | Type   | Description                                      |
| ------------------------ | ------ | ------------------------------------------------ |
| `rank`                   | number | Rank of the asset by market cap                  |
| `usd`                    | number | Market cap in USD                                |
| `dominance`              | number | Market dominance percentage                      |
| `percent_change_btc_1h`  | number | Percentage change from BTC in the last 1 hour    |
| `percent_change_btc_24h` | number | Percentage change from BTC in the last 24 hours  |
| `percent_change_usd_1h`  | number | Percentage change from USD in the last 1 hour    |
| `percent_change_usd_24h` | number | Percentage change from USD in the last 24 hours  |
| `percent_change_usd_7d`  | number | Percentage change from USD in the last 7 days    |
| `percent_change_usd_30d` | number | Percentage change from USD in the last 30 days   |
| `percent_change_eth_1h`  | number | Percentage change from ETH in the last 1 hour    |
| `percent_change_eth_24h` | number | Percentage change from ETH in the last 24 hours  |
| `updated_at`             | number | Unix timestamp when market data was last updated |
| `asset_code`             | string | Asset code (e.g., "ETH")                         |
| `asset_slug`             | string | Asset slug (e.g., "ethereum")                    |

## Notes

* This endpoint is equivalent to using `?expand=market_cap` on the `/v1/assets/{idOrSlug}` endpoint, but returns only the market cap data.
* The response includes `asset_code` and `asset_slug` for easy identification.

## See also

* [Get Single Asset](/api-reference/assets/get-single)
* [Market Cap (Expand Parameter)](/api-reference/assets/expand/market_cap)
* [All Assets](/api-reference/assets/list)


## OpenAPI

````yaml GET /v1/assets/{idOrSlug}/market-cap
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/assets/{idOrSlug}/market-cap:
    get:
      tags:
        - assets
      summary: Get Asset Market Cap
      description: >-
        Get market cap data for a single asset. Returns only the market cap data
        with asset identifiers.
      operationId: AssetController_getMarketCapHyphen_v1
      parameters:
        - name: idOrSlug
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: Market cap data for the specified asset
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetMarketCapWithIdentifiers'
              example:
                rank: 2
                usd: 4456.91
                dominance: 11.9754
                percent_change_btc_1h: -0.134556
                percent_change_btc_24h: -1.56252
                percent_change_usd_1h: 0.0999065
                percent_change_usd_24h: -0.63777
                percent_change_usd_7d: 2.94011
                percent_change_usd_30d: 2.0461
                percent_change_eth_1h: 0
                percent_change_eth_24h: 0
                updated_at: 1759940402
                asset_code: ETH
                asset_slug: ethereum
        '400':
          description: Bad Request
        '404':
          description: Not Found
components:
  schemas:
    AssetMarketCapWithIdentifiers:
      type: object
      properties:
        rank:
          type: integer
          nullable: true
        usd:
          type: number
          nullable: true
          format: double
        dominance:
          type: number
          nullable: true
          format: float
        percent_change_btc_1h:
          type: number
          nullable: true
          format: float
        percent_change_btc_24h:
          type: number
          nullable: true
          format: float
        percent_change_usd_1h:
          type: number
          nullable: true
          format: float
        percent_change_usd_24h:
          type: number
          nullable: true
          format: float
        percent_change_usd_7d:
          type: number
          nullable: true
          format: float
        percent_change_usd_30d:
          type: number
          nullable: true
          format: float
        percent_change_eth_1h:
          type: number
          nullable: true
          format: float
        percent_change_eth_24h:
          type: number
          nullable: true
          format: float
        updated_at:
          type: number
          nullable: true
          description: Unix timestamp
        asset_code:
          type: string
          maxLength: 20
        asset_slug:
          type: string
          maxLength: 100
      required:
        - rank
        - usd
        - dominance
        - percent_change_btc_1h
        - percent_change_btc_24h
        - percent_change_usd_1h
        - percent_change_usd_24h
        - percent_change_eth_1h
        - percent_change_eth_24h
        - updated_at
        - asset_code
        - asset_slug
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````