Get Single Asset Supply

GET

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

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=supply on the /v1/assets/{idOrSlug} endpoint, but returns only the supply data.
The response includes asset_code and asset_slug for easy identification.

Introduction

Assets

Chart Data

Token Transparency

Market Stats

Metrics

Metrics: Chains

Metrics: Projects

Metrics: ETFs

Metrics: Treasuries

Overview

Example Request

Example Response

Response Fields

Notes

See also

Authorizations

Path Parameters

Response

​Overview

​Example Request

​Example Response

​Response Fields

​Notes

​See also

Authorizations

Path Parameters

Response

Overview

Example Request

Example Response

Response Fields

Notes

See also