GET
/
v1
/
assets
/
{idOrSlug}
Get Asset
curl --request GET \
  --url https://api.blockworks.com/v1/assets/{idOrSlug} \
  --header 'x-api-key: <api-key>'
{
  "id": 2147483647,
  "code": "<string>",
  "title": "<string>",
  "slug": "<string>",
  "tag_line": "<string>",
  "description": "<string>",
  "image_url": "<string>",
  "legacy_sector": "<string>",
  "category": "<string>",
  "is_supported": true,
  "updated_at": 123,
  "sector_id": 2147483647,
  "type": "Infrastructure",
  "market_cap": {
    "asset_id": 2147483647,
    "rank": 2147483647,
    "usd": 8.988465674311579e+307,
    "dominance": 1.7014115e+38,
    "percent_change_btc_1_h": 1.7014115e+38,
    "percent_change_btc_24_h": 1.7014115e+38,
    "percent_change_usd_1_h": 1.7014115e+38,
    "percent_change_usd_24_h": 1.7014115e+38,
    "percent_change_eth_1_h": 1.7014115e+38,
    "percent_change_eth_24_h": 1.7014115e+38,
    "updated_at": 123
  },
  "price": {
    "asset_id": 2147483647,
    "usd": 8.988465674311579e+307,
    "btc": 8.988465674311579e+307,
    "eth": 8.988465674311579e+307,
    "sparkline_7d": "<string>",
    "updated_at": 123
  }
}

​
Overview

Fetch a single asset by ID or slug. You can optionally expand related objects (e.g. supply) to avoid making multiple requests. Single asset payloads include price and market_cap expansions by default, unless an explicit ?expand= flag is provided.

​
Example Request

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

​
Example Response

{
  "id": 2,
  "code": "ETH",
  "title": "Ethereum",
  "slug": "ethereum",
  "tag_line": "Programmable smart contract platform",
  "description": "Ethereum is a decentralized platform for smart contracts...",
  "image_url": "https://.../ethereum.png",
  "category": "Infrastructure",
  "type": "Infrastructure",
  "updated_at": 1723180800,
  "sector_id": 40,
  "market_cap": {
    "asset_id": 2,
    "rank": 2,
    "usd": 414000000000,
    "dominance": 0.18,
    "percent_change_btc_1_h": 1.0,
    "percent_change_btc_24_h": 2.1,
    "percent_change_usd_1_h": 1.0,
    "percent_change_usd_24_h": 2.1,
    "percent_change_eth_1_h": 1.0,
    "percent_change_eth_24_h": 2.1,
    "updated_at": 1723180800
  },
  "price": {
    "asset_id": 2,
    "usd": 3450.12,
    "btc": 0.051,
    "eth": 1,
    "sparkline_7d": [100, 101, 102, 103, 104, 105, 106],
    "updated_at": 1723180800
  },
}

​
Supported Options

NameTypeDetails
idOrSlugpathThe ID or slug of the asset to fetch
expandqueryThe fields to expand. See Expand Options for more details.

​
See also

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
idOrSlug
string
required

Query Parameters

​
expand
enum<string>[]

Response

200
application/json

The response is of type object.