Skip to main content

​
Overview

The ?expand= parameter allows you to include additional related data in your asset responses, primarily used to reduce API calls. To include more than one option, use a comma-separated list, such as ?expand=price,market_cap.
This behavior applies to both the /v1/assets (Get Multiple Assets) and /v1/assets/{idOrSlug} (Get Single Asset) endpoints.
When fetching a single asset, the price and market_cap data are included by default.

​
Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.blockworks.com/v1/assets/ethereum?expand=markets"

​
Example Response

{
  "id": 2,
  "code": "ETH",
  "title": "Ethereum",
  "slug": "ethereum",
  "tag_line": "A decentralized computing platform",
  ... // other asset data
  "markets": {
    "volume_24h": 41300200000,
    "ath": 4946.05,
    "ath_change_percentage": -21.4616,
    "ath_date": 1756063263,
    "total_open_interest": 1707980000,
    "total_liquidations": 0,
    "updated_at": 1760631722
  }
}

​
Available Options

You can expand the following fields:
  • price - Current price data (USD, BTC, ETH)
  • market_cap - Market capitalization and percentage changes
  • markets - Trading volume and all-time high data
  • ohlcv - Open, High, Low, Close, Volume for last 24 hours
  • supply - Circulating and total supply information

​
See Also

⌘I