Skip to main content
GET
/
v1
/
assets
/
{idOrSlug}
/
markets
Get Asset Markets
curl --request GET \
  --url https://api.blockworks.com/v1/assets/{idOrSlug}/markets \
  --header 'x-api-key: <api-key>'
{
  "volume_24h": 44573500000,
  "ath": 4946.05,
  "ath_change_percentage": -21.2222,
  "ath_date": 1756063263,
  "total_open_interest": 1707980000,
  "total_liquidations": 0,
  "updated_at": 1760639807,
  "asset_code": "ETH",
  "asset_slug": "ethereum"
}

​
Overview

Get the current markets information for a specific asset. This endpoint returns just the markets data block with asset_code and asset_slug included.

​
Example Request

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

​
Example Response

{
  "volume_24h": 44573500000,
  "ath": 4946.05,
  "ath_change_percentage": -21.2222,
  "ath_date": 1756063263,
  "total_open_interest": 1707980000,
  "total_liquidations": 0,
  "updated_at": 1760639807,
  "asset_code": "ETH",
  "asset_slug": "ethereum"
}

​
Response Fields

FieldTypeDescription
idnumberUnique market identifier
volume_24hnumberTrading volume in the last 24 hours
athnumberAll-time high price
ath_change_percentagenumberPercentage change from all-time high
ath_datenumberUnix timestamp when all-time high was reached
total_open_interestnumber | nullTotal open interest
total_liquidationsnumber | nullTotal liquidations
updated_atnumberUnix timestamp when market data was last updated
asset_codestringAsset code (e.g., “ETH”)
asset_slugstringAsset slug (e.g., “ethereum”)

​
Notes

  • This endpoint is equivalent to using ?expand=markets on the /v1/assets/{idOrSlug} endpoint, but returns only the markets data.
  • The response includes asset_code and asset_slug for easy identification.

​
See also

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
idOrSlug
string
required

Response

Markets data for the specified asset

​
id
integer
required
​
volume_24h
number | null
required
​
ath
number | null
required
​
ath_change_percentage
number | null
required
​
ath_date
number | null
required

Unix timestamp

​
updated_at
number | null
required

Unix timestamp

​
asset_code
string
required
Maximum length: 20
​
asset_slug
string
required
Maximum length: 100
​
total_open_interest
number | null
​
total_liquidations
number | null
⌘I