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

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

Last updated

Was this helpful?