Skip to main content
GET
/
v1
/
assets
/
{idOrSlug}
/
supply
Get Asset Supply
curl --request GET \
  --url https://api.blockworks.com/v1/assets/{idOrSlug}/supply \
  --header 'x-api-key: <api-key>'
{
  "circulating": 120702472.20949,
  "liquid": 0,
  "total": 120702572.39159,
  "asset_code": "ETH",
  "asset_slug": "ethereum"
}

​
Overview

Get the supply information for a specific asset. This endpoint returns just the supply 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/supply"

​
Example Response

{
  "circulating": 120702472.20949,
  "liquid": 0,
  "total": 120702572.39159,
  "asset_code": "ETH",
  "asset_slug": "ethereum"
}

​
Response Fields

FieldTypeDescription
circulatingnumberNumber of tokens currently in circulation
liquidnumberLiquid supply amount
totalnumberTotal token supply including locked tokens
asset_codestringAsset code (e.g., “ETH”)
asset_slugstringAsset slug (e.g., “ethereum”)

​
Notes

  • This endpoint is equivalent to using ?expand=supply on the /v1/assets/{idOrSlug} endpoint, but returns only the supply 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

Supply data for the specified asset

​
circulating
number<double> | null
required
​
liquid
number<double> | null
required
​
total
number<double> | null
required
​
asset_code
string
required
Maximum string length: 20
​
asset_slug
string
required
Maximum string length: 100