How Expand Works

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"

const res = await fetch(
  'https://api.blockworks.com/v1/assets/ethereum?expand=markets',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
)
const data = await res.json()

import requests

r = requests.get(
  'https://api.blockworks.com/v1/assets/ethereum',
  headers={'x-api-key': 'YOUR_API_KEY'},
  params={'expand': 'markets'}
)
data = r.json()

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

Introduction

Assets

Chart Data

Token Transparency

Market Stats

Metrics

Metrics: Chains

Metrics: Projects

Metrics: ETFs

Metrics: Treasuries

Overview

Example Request

Example Response

Available Options

See Also

​Overview

​Example Request

​Example Response

​Available Options

​See Also

Overview

Example Request

Example Response

Available Options

See Also