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 | null
required
liquid
number | null
required
total
number | null
required
asset_code
string
required
Maximum length: 20
asset_slug
string
required
Maximum length: 100
I