Supply Per Blockchain

This data is included in the following Kaiko packages:

• Kaiko Market Explorer [Full Coverage]
• Kaiko Market Explorer [Supply and Market Cap]

What is this endpoint for?

This endpoint receives the supply of an asset on a single blockchain, including circulating supply and market capitalization where available.

To retrieve supply across all chains for an asset, use the Aggregated Supply endpoint with the blockchain query parameter, or call this endpoint once per chain.

Endpoint

https://us.market-api.kaiko.io/v2/data/supply.v2/blockchain-level/{blockchain}/{asset}

Parameters

Parameter	Required	Description	Example
blockchain	Yes	Normalized blockchain identifier. Common values: ethereum, solana, polygon, arbitrum, canton.	ethereum
asset	Yes	The desired asset code. See Asset codes.	usdc
start_time	No	Starting time in ISO 8601 (inclusive).	2026-04-14T00:00:00.000Z
end_time	No	Ending time in ISO 8601 (exclusive).	2026-04-16T00:00:00.000Z
sort	No	Sort direction by timestamp (asc / desc). Default: desc.	desc
page_size	No	See Pagination. Minimum: 1 Maximum: 1000 Default: 100.	100

Fields

Field	Description	Example
timestamp	Timestamp at which the interval begins	1744848000
asset	Asset	usdc
blockchain	Blockchain name	ethereum
total_supply	Total supply on this chain	28535000000.00
circulating_supply	Circulating supply on this chain. null for Canton instruments.	28535000000.00
market_cap	Market capitalization on this chain. null for Canton instruments.	28535000000.00

Request examples

cURL

curl --request GET \
  --url 'https://us.market-api.kaiko.io/v2/data/supply.v2/blockchain-level/canton/cbtc?start_time=2026-05-13T00:00:00Z&end_time=2026-05-13T23:59:59Z&page_size=10&sort=desc' \
  --header 'Accept: application/json' \
  --header 'X-Api-Key: KAIKO_API_KEY'

Python

import http.client
import json

# Enter your Kaiko API Key
api_key = "KAIKO_API_KEY"
api_host = "us.market-api.kaiko.io"
api_base_endpoint = "/v2/data/supply.v2/blockchain-level/canton/cbtc"
# Start of mandatory parameter configuration
mandatory_params = {

}
# End of mandatory parameter configuration
# Start of optional parameter configuration
optional_params = {
    'start_time':'2026-05-13T00:00:00Z',
    'end_time':'2026-05-13T23:59:59Z',
    'page_size':10,
    'sort':'desc'
}
# End of optional parameter configuration
conn = http.client.HTTPSConnection(api_host)
headers = {
    "X-Api-Key": api_key,
    "Accept": "application/json"
}

all_params = {**mandatory_params, **optional_params}

url_params = []
for param, value in all_params.items():
    url_params.append(f"{param}={value}")
url_params = '&'.join(url_params)

endpoint_with_params = f"{api_base_endpoint}?{url_params}"

# Pagination for next pages
all_data = []
next_url = endpoint_with_params
while next_url:
    conn.request("GET", next_url, headers=headers)
    response = conn.getresponse()
    data = json.loads(response.read().decode("utf-8"))
    all_data.extend(data.get("data", []))
    print(f"Fetched {len(data.get('data', []))} datapoints. Total: {len(all_data)}")
    next_url = data.get("next_url", "").replace("https://us.market-api.kaiko.io", "")
    if not next_url:
        break
conn.close()
print(f" datapoints fetched: {(all_data)}")

Response example

{
    "query": {
        "start_time": "2026-05-13T00:00:00.000Z",
        "end_time": "2026-05-13T23:59:59.000Z",
        "page_size": 10,
        "asset": "cbtc",
        "blockchain": "canton",
        "sort": "desc",
        "request_time": "2026-05-13T07:57:55.131Z",
        "start_timestamp": 1778630400000,
        "end_timestamp": 1778716799000
    },
    "time": "2026-05-13T07:57:55.136Z",
    "timestamp": 1778659075136,
    "data": [
        {
            "timestamp": 1778655600,
            "asset": "cbtc",
            "blockchain": "canton",
            "total_supply": 29.0089104357,
            "circulating_supply": null,
            "market_cap": null
        }
        /** Results **/
    ],
    "result": "success",
    "access": {
        "access_range": {
            "start_timestamp": 1578006000000,
            "end_timestamp": 1893625200000
        },
        "data_range": {
            "start_timestamp": 1578006000000,
            "end_timestamp": 1893625200000
        }
    }
}