Market cap ranking

What is this endpoint for?

This endpoint aggregates from the Supply endpoint to provide an aggregated view of supply and market capitalization of the top assets at a specified time.

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

Endpoint

https://us.market-api.kaiko.io/v2/data/supply.v2/top

Parameters

Parameter	Required	Description	Example
datetime	No	Time in ISO 8601. Default: Current time.	2023-01-25T00:00:00.00
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: 1d.	4h
count	No	Number of assets in the result. Ex: 10 to retrieve the top 10 assets. Default: 100.	10

Fields

Field	Description	Example
datetime	Timestamp in seconds.	1760918400
asset	Asset.	btc
rank	The ranking of the asset in terms of market cap.	1
total_supply	Total supply.	1.99373e+07
circulating_supply	Circulating supply.	1.99373e+07
market_cap	Market capitalisation.	2.2094e+12

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/top?datetime=2026-01-01T00:00:00.000Z&count=10&interval=1d'

Python

Response example

{
    "query":
    {
        "datetime": "2026-01-01T00:00:00.000Z",
        "count": 10,
        "interval": "1d"
    },
    "time": "2026-02-10T13:10:35.136Z",
    "timestamp": 1770729035136,
    "data":
    [
        {
            "datetime": 1767225600,
            "asset": "btc",
            "rank": 1,
            "total_supply": 19969814.0625,
            "circulating_supply": 19969814.0625,
            "market_cap": 1754840038141.7961
        },
        {
            "datetime": 1767225600,
            "asset": "eth",
            "rank": 2,
            "total_supply": 120694917.35776222,
            "circulating_supply": 120694917.35776222,
            "market_cap": 359309601750.3176
        },
        {
            "datetime": 1767225600,
            "asset": "usdt",
            "rank": 3,
            "total_supply": 191200669545.90054,
            "circulating_supply": 186408947507.7797,
            "market_cap": 186164285382.73282
        },
        /** Results **/

    ],
    "result": "success"
}