Supply

What is this endpoint for?

This endpoint receives information on the supply of each asset, including circulating supply and market capitalization.

Supply data is provided as:

• An aggregated supply value derived from all blockchains on which the asset is deployed.
• A blockchain-specific supply value for each chain

Data is provided at 5-minute intervals.

Read our supply and market cap methodology here.

Endpoint

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

Parameters

Parameter	Required	Description	Example
asset	Yes	The desired asset code. See Asset codes	agix
start_time	Yes	Starting time in ISO 8601 (inclusive).	2023-01-25T00:00:00.000Z
end_time	Yes	Ending time in ISO 8601 (exclusive).	2023-01-26T00:00:00.000Z
sources	No	boolean. If true, returns the breakdown by blockchain of the supply. Default: false	true
page_size	No	See Pagination Minimum: 1 Maximum: 100 Default: 10	100

Fields

Field	Description	Example
timestamp	Timestamp at which the interval begins	2023-01-25T00:00:00.000Z
asset	Asset	btc
circulating_supply	Total circulating supply	1.99478e+07
market_cap	Market capitalisation	2.09489e+12
sources	The per-blockchain breakdown of the supply
chain	The blockchain name	Bitcoin
circulating_supply	Circulating supply	19947806.25
excluded_supply	Exlcluded supply for the specific chain	0
total_supply	The total supply for the specific chain	19947806.25

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/assets/btc?start_time=2025-11-12T14:00:00.000Z&page_size=100&sources=true&sort=desc'

Python

Response example

{
    "query":
    {
        "start_time": "2025-11-12T14:00:00.000Z",
        "end_time": "2025-11-12T14:00:48.317Z",
        "page_size": 100,
        "asset": "btc",
        "sort": "desc",
        "request_time": "2025-11-12T14:00:48.317Z",
        "start_timestamp": 1735689600000,
        "end_timestamp": 1762956048317
    },
    "time": "2025-11-12T14:00:48.326Z",
    "timestamp": 1762956048326,
    "data":
    [
        {
            "timestamp": 1762956005,
            "asset": "btc",
            "circulating_supply": 19947809.375,
            "market_cap": 2093053874177.4607,
            "sources":
            [
                {
                    "chain": "Bitcoin",
                    "circulating_supply": "19947809.375",
                    "excluded_supply": "0",
                    "total_supply": "19947809.375"
                }
            ]
        }
        /** Results **/
    ],
    "result": "success",
    "continuation_token": "xxx",
    "next_url": "https://us.market-api.kaiko.io/v2/data/supply.v2/assets/btc?continuation_token=xxx",
    "access":
    {
        "access_range":
        {
            "start_timestamp": 1073001600000,
            "end_timestamp": "None"
        },
        "data_range":
        {
            "start_timestamp": "None",
            "end_timestamp": "None"
        }
    }
}