Market capitalization and circulating supply (BETA)

What is this endpoint for?

This API provides circulating supply and market capitalization data for over 250 crypto assets. The data is an indicative value aggregated from multiple sources on a daily basis, starting from the asset’s deployment to the present day. Market capitalization is provided only when a reliable price for the day can be ensured.

Endpoint

https://eu.market-api.kaiko.io/v2/data/supply.v1/{ASSET}

Path parameters

Parameter	Required?	Description
asset		The asset you'd like information on.

Currently supported assets: 1inch, AAVE, ACH, ADA, AGIX, AGLD, ALGO, ALICE, AMP, ANKR, ANT, API3, APT, AR, ARB, ARPA, ATOM, AUDIO, AURA, AVAX, AXS, BAL, BAND, BAT, BCH, BETA, BICO, BIT, BLEO, BLUR, BNB, BNT, BOND, BORA, BSV, BTC, BTG, BTRFLY, BTSE, BTT, BUSD, BZZ, C98, CAKE, CDAI, CEL, CELO, CELR, CFX, CHSB, CHZ, CKB, COCOS, COMP, COTI, CQT, CRON, CRV, CSPR, CTSI, CUSDC, CVC, CVX, CVXCRV, DAI, DAO, DASH, DCR, DEXE, DFI, DGB, DOGE, DOT, DPX, DYDX, EFI, EGLD, ELON, ENJ, ENS, EOS, ETC, ETH, EURS, EVER, FET, FIL, FLOKI, FLOW, FLUX, FRAX, FRXETH, FTM, FXS, GAL, GALA, GFARM2, GLM, GLMR, GMX, GNO, GOG, GRT, GTC, GTX, GUSD, HBAR, HBTC, HFT, HIVE, HLM, HOT, HT, ICP, ID, ILV, IMX, INJ, INST, IOST, IOTA, IOTX, JASMY, JST, KAVA, KCS, KDA, KEEP, KLAY, KNC, KSM, LDO, LEVER, LINK, LOOKS, LPT, LQTY, LRC, LSK, LTC, LUNA, LYXE, MANA, MASK, MATIC, MBOX, MC, MEME, MIM, MINA, MIR, MKR, MLK, MULTI, NANO, NEAR, NEO, NEST, NEXO, NFT, NMR, NOIA, NU, NXRA, OCEAN, OGN, OHM, OKB, OKT, OMG, ONE, ONT, OP, OPUL, ORBS, OSMO, PAXG, PEOPLE, PHA, PLA, POLY, POND, PUNDIX, QNT, QTUM, RAD, RAIL, RBN, RDPX, REN, REQ, RIF, RLC, RLY, RNDR, RON, ROSE, RPETH, RPL, RSR, RUNE, RVN, SAITO, SAND, SC, SCRT, SETH, SFP, SFRXETH, SHIB, SKL, SNT, SNX, SOL, SPELL, SSV, STETH, STG, STORJ, STX, SURE, SUSD, SUSHI, SX, SXP, SYN, SYS, TEL, TFUEL, THETA, TRAC, TRIBE, TRX, TUSD, TWT, UMA, UNI, USDC, USDP, USDT, UST, VEN, VENUS, VGX, VTHO, WAVES, WAX, WBTC, WEMIX, WOO, XAUT, XCH, XDCE, XEC, XEM, XLM, XMR, XRD, XRP, XTZ, YFI, YFII, YGG, ZEC, ZEN, ZRX.

Query parameters

Parameter	Mandatory	Description	Example
start_time	Yes	Start time.	2020-01-01T00:00:00.000Z
end_time	No	End time.	2023-11-08T00:00:00.000Z
page_size	No	Response page size. Default: 10.	100
sort	No	Sort results in asc or desc order.	desc

Fields

Field	Description	Example
timestamp	Timestamp of the block.	1670976000
asset	Ticker of the asset.	btc
circulating_supply	Circulating supply of the asset.	19248126.084439
market_cap	Market cap = Circulating supply x USD price.	345082843135.89093

Request examples

cURL

curl --compressed -H 'Accept: application/json' -H 'X-Api-Key: <client-api-key>' \
'https://eu.market-api.kaiko.io/v2/data/supply.v1/btc?start_time=2010-01-01T00:00:00.000Z&page_size=100'

Python

import http.client
import json

# Enter your Kaiko API Key
api_key = "KAIKO_API_KEY"
api_host = "eu.market-api.kaiko.io"
api_base_endpoint = "/v2/data/supply.v1/{asset}"

# Mandatory parameter configuration
asset = "btc"

# Optional parameters
optional_params = {
    "start_time": "2010-01-01T00:00:00.000Z",
    "page_size": 100,
}

conn = http.client.HTTPSConnection(api_host)
headers = {
    "X-Api-Key": api_key,
    "Accept": "application/json"
}

# Construct the endpoint with query parameters
api_endpoint = api_base_endpoint.format(asset=asset)
url_params = "&".join([f"{param}={value}" for param, value in optional_params.items()])
endpoint_with_params = f"{api_endpoint}?{url_params}"

# Pagination handling
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)}")

    # Extract pagination token and update URL
    next_url = data.get("next_url", "").replace("https://eu.market-api.kaiko.io", "")
    if not next_url:
        break

conn.close()

# Output the fetched data
print(f"Total datapoints fetched: {len(all_data)}")
print(json.dumps(all_data, indent=2))

Response example

{
   "query": {
      "start_time": "2010-08-01T00:00:00.000Z",
      "end_time": "2024-03-28T10:22:32.118Z",
      "page_size": 100,
      "asset": "btc",
      "interval": "1d",
      "sort": "asc",
      "request_time": "2024-03-28T10:22:32.118Z",
      "start_timestamp": 1280620800000,
      "end_timestamp": 1711621352118
   },
   "time": "2024-03-28T10:22:32.133Z",
   "timestamp": 1711621352133,
   "data": [
      {
         "timestamp": 1280620800,
         "asset": "btc",
         "circulating_supply": 3585995.2815962303,
         "market_cap": 224238.7131408345
      },
      {
         "timestamp": 1280707200,
         "asset": "btc",
         "circulating_supply": 3599253.320858871,
         "market_cap": 221216.1495251203
      }
   ],
   "result": "success",
   "continuation_token": "***",
   "next_url": "https://eu.market-api.kaiko.io/v2/data/supply.v1/btc?continuation_token=***",
   "access": {
      "access_range": {
         "start_timestamp": 1073001600000,
         "end_timestamp": null
      },
      "data_range": {
         "start_timestamp": null,
         "end_timestamp": null
      }
   }
}