Skip to main content
GET
/
v1
/
assets
/
{idOrSlug}
/
market-cap
Get Asset Market Cap
curl --request GET \
  --url https://api.blockworks.com/v1/assets/{idOrSlug}/market-cap \
  --header 'x-api-key: <api-key>'
{
  "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"
}

​
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

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.blockworks.com/v1/assets/ethereum/market-cap"

​
Example Response

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

FieldTypeDescription
ranknumberRank of the asset by market cap
usdnumberMarket cap in USD
dominancenumberMarket dominance percentage
percent_change_btc_1hnumberPercentage change from BTC in the last 1 hour
percent_change_btc_24hnumberPercentage change from BTC in the last 24 hours
percent_change_usd_1hnumberPercentage change from USD in the last 1 hour
percent_change_usd_24hnumberPercentage change from USD in the last 24 hours
percent_change_usd_7dnumberPercentage change from USD in the last 7 days
percent_change_usd_30dnumberPercentage change from USD in the last 30 days
percent_change_eth_1hnumberPercentage change from ETH in the last 1 hour
percent_change_eth_24hnumberPercentage change from ETH in the last 24 hours
updated_atnumberUnix timestamp when market data was last updated
asset_codestringAsset code (e.g., “ETH”)
asset_slugstringAsset 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

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
idOrSlug
string
required

Response

Market cap data for the specified asset

​
rank
integer | null
required
​
usd
number | null
required
​
dominance
number | null
required
​
percent_change_btc_1h
number | null
required
​
percent_change_btc_24h
number | null
required
​
percent_change_usd_1h
number | null
required
​
percent_change_usd_24h
number | null
required
​
percent_change_eth_1h
number | null
required
​
percent_change_eth_24h
number | null
required
​
updated_at
number | null
required

Unix timestamp

​
asset_code
string
required
Maximum length: 20
​
asset_slug
string
required
Maximum length: 100
​
percent_change_usd_7d
number | null
​
percent_change_usd_30d
number | null
⌘I