Skip to main content
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>",
  "sector": "<string>",
  "category": "<string>",
  "updated_at": 123,
  "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 (2), code (eth), or slug (ethereum). 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/ethereum"

​
Example Response

{
  "id": 2,
  "code": "ETH",
  "title": "Ethereum",
  "slug": "ethereum",
  "tag_line": "A decentralized computing platform",
  "description": "Ethereum is a distributed blockchain computing platform for smart contracts and decentralized applications. Its native token is ether (ETH), which primarily serves as a means of payment for transaction fees and as collateral for borrowing specific ERC-20 tokens within the decentralized finance (DeFi) sector.",
  "image_url": "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628",
  "category": "Infrastructure",
  "updated_at": 1761159971,
  "type": "Infrastructure",
  "sector": "L1",
  "market_cap": {
    "rank": 2,
    "usd": 459025701727,
    "dominance": 11.741,
    "percent_change_btc_1h": -0.399197,
    "percent_change_btc_24h": -1.63031,
    "percent_change_usd_1h": -0.216457,
    "percent_change_usd_24h": -5.08756,
    "percent_change_usd_7d": -4.58515,
    "percent_change_usd_30d": -8.57149,
    "percent_change_eth_1h": 0,
    "percent_change_eth_24h": 0,
    "updated_at": 1761159971
  },
  "price": {
    "usd": 3814.21,
    "btc": 0.035259267482631,
    "eth": 1,
    "updated_at": 1761159971
  }
}

​
Supported Options

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

​
Response Fields

FieldTypeDescription
idnumberUnique asset identifier
categorystringAsset category (e.g., Infrastructure, DeFi)
codestringAsset ticker symbol (e.g., BTC, ETH)
descriptionstringDetailed asset description
image_urlstringURL to asset logo/image
market_capobjectMarket capitalization data (expanded by default)
priceobjectPrice data (expanded by default)
sectorstringSector of the asset
slugstringURL-friendly identifier
tag_linestringShort description or tagline
titlestringFull asset name
typestringAsset type classification
updated_atnumberUnix timestamp of last update

​
See also

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
idOrSlug
string
required

Query Parameters

​
expand
enum<string>[]
Available options:
addresses,
chains,
addresses.chain,
markets,
market_cap,
ohlcv_last_24_h,
price,
reference,
sector,
supply

Response

​
id
integer
required
Required range: 0 <= x <= 4294967295
​
code
string | null
required
Maximum string length: 20
​
title
string | null
required
Maximum string length: 100
​
slug
string | null
required
Maximum string length: 100
​
tag_line
string | null
required
Maximum string length: 255
​
description
string | null
required
Maximum string length: 65535
​
image_url
string | null
required
Maximum string length: 255
​
sector
string | null
required
Maximum string length: 50
​
category
string | null
required
Maximum string length: 25
​
updated_at
number | null
required

Unix timestamp

​
type
enum<string> | null
required
Available options:
Infrastructure,
Application
​
market_cap
object

Expandable relationship

​
price
object

Expandable relationship