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

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