Supply Per Blockchain

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

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