Get Single
Get Single Asset Supply
Retrieve supply data for a specific asset
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>'import requests
url = "https://api.blockworks.com/v1/assets/{idOrSlug}/supply"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.blockworks.com/v1/assets/{idOrSlug}/supply', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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 withasset_code and asset_slug included.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.blockworks.com/v1/assets/ethereum/supply"
const res = await fetch(
'https://api.blockworks.com/v1/assets/ethereum/supply',
{ headers: { 'x-api-key': 'YOUR_API_KEY' } }
)
const data = await res.json()
import requests
r = requests.get(
'https://api.blockworks.com/v1/assets/ethereum/supply',
headers={'x-api-key': 'YOUR_API_KEY'}
)
data = r.json()
Example Response
{
"circulating": 120702472.20949,
"liquid": 0,
"total": 120702572.39159,
"asset_code": "ETH",
"asset_slug": "ethereum"
}
Response Fields
| Field | Type | Description |
|---|---|---|
circulating | number | Number of tokens currently in circulation |
liquid | number | Liquid supply amount |
total | number | Total token supply including locked tokens |
asset_code | string | Asset code (e.g., “ETH”) |
asset_slug | string | Asset slug (e.g., “ethereum”) |
Notes
- This endpoint is equivalent to using
?expand=supplyon the/v1/assets/{idOrSlug}endpoint, but returns only the supply data. - The response includes
asset_codeandasset_slugfor easy identification.