Aggregated Supply

What is this endpoint for?

This endpoint aggregates from the Supply endpoint to provide an aggregated view of supply and market capitalization.

Data can be aggregated between 5-minute and 30-day intervals; the aggregation considers each 5-minute interval from the raw supply data that falls between the start_time and end_time.configured.

Endpoint

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

Parameters

Parameter	Required	Description	Example
asset	Yes	The desired asset code See Asset codes	btc
start_time	No	Starting time in ISO 8601 (inclusive)	2023-01-25T00:00:00.00
end_time	No	Ending time in ISO 8601 (exclusive)	2023-01-26T00:00:00.000Z
interval	No	The interval parameter is suffixed with m, h or d to specify minutes, hours, or days, respectively Any arbitrary value between five minutes and 30 days can be used. Default: 1h.	4h
page_size	No	See Pagination Minimum: 1 Maximum: 100 Default: 100	100

Fields

Field	Description	Example
timestamp	Timestamp at which the interval begins	1760918400
asset	Asset	btc
circulating_supply	Circulating supply	1.99373e+07
market_cap	Market capitalisation	2.2094e+12
total_supply	Total supply	1.99373e+07

Request examples

cURL

curl --compressed -H 'Accept: application/json' -H 'X-Api-Key: <client-api-key>' \
'https://us.market-api.kaiko.io/v2/data/supply.v2/aggregated/btc?start_time=2025-10-20T00:00:00.000Z&end_time=2025-10-21T00:00:00.000Z&page_size=100&interval=1d'

Python

Response example

{
    "query":
    {
        "start_time": "2025-10-20T00:00:00.000Z",
        "end_time": "2025-10-21T00:00:00.000Z",
        "page_size": 100,
        "asset": "btc",
        "interval": "1d",
        "sort": "asc",
        "request_time": "2025-11-12T14:18:27.226Z",
        "start_timestamp": 1760918400000,
        "end_timestamp": 1761004800000
    },
    "time": "2025-11-12T14:18:27.253Z",
    "timestamp": 1762957107253,
    "data":
    [
        {
            "timestamp": 1760918400,
            "asset": "btc",
            "circulating_supply": 19937318.75,
            "market_cap": 2209402368348.39,
            "total_supply": 19937318.75
        }
        /** Results **/
    ],
    "result": "success",
    "continuation_token": "xxx",
    "next_url": "https://us.market-api.kaiko.io/v2/data/supply.v2/aggregated/btc?continuation_token=xxx",
    "access":
    {
        "access_range":
        {
            "start_timestamp": 1073001600000,
            "end_timestamp": "None"
        },
        "data_range":
        {
            "start_timestamp": "None",
            "end_timestamp": "None"
        }
    }
}