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

Add the ?expand=ohlcv_last_24h flag to your /assets or /assets/{idOrSlug} page to include ohlcv_last_24h data in the response.

​
Example Request

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

​
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": 1759454319,
  "type": "Infrastructure",
  "ohlcv_last_24h": {
    "assetId": 2,
    "open": 2991.0164373997,
    "high": 4514.81,
    "low": 4347.24,
    "close": 2972.9752699223,
    "volume": 14018548707.668,
    "updated_at": 1759454319
  }
}

​
Response Fields

FieldTypeDescription
assetIdnumberUnique identifier for the asset
opennumberPrice at the start of the trailing 24h window
highnumberHighest price during the trailing 24h window
lownumberLowest price during the trailing 24h window
closenumberPrice at the end of the trailing 24h window
volumenumberTotal traded volume over the trailing 24h window
updated_atnumberUnix timestamp when values were last refreshed

​
Notes

  • Can be used with other expansion options by joining with a comma (e.g. ?expand=markets,ohlcv_last_24h).
  • Can be used on /v1/assets/ or /v1/assets/{idOrSlug} endpoints.
  • price and market_cap are expanded by default in /assets/{idOrSlug} results unless an explicit ?expand= flag is provided.

​
See also

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
idOrSlug
string
required

Query Parameters

​
expand
enum<string>[]

Response

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

Unix timestamp

​
sector_id
integer | null
required
Required range: 0 <= x <= 4294967295
​
type
enum<string> | null
required
Available options:
Infrastructure,
Application
​
market_cap
object

Expandable relationship

​
price
object

Expandable relationship

⌘I