Skip to main content
Type: TOKEN_SUPPLY_AGG | Weight: 1x | Max points: 100,000 | Advanced/Enterprise only Bitcoin dominance comes from the market-independent token supply dataset. Query it with coin and tokenName, not exchange and rawSymbol. The same response also includes token supply, market cap, and other asset-level fields. Altcoin dominance is derived client-side from the Bitcoin response.

​
Parameters

ParameterTypeRequiredDescription
coinstringYesAsset ticker, for example BTC.
tokenNamestringRecommendedToken name, for example Bitcoin. Use it together with coin to target a single asset cleanly.
tokenName usually matches the coinName returned by GET /v1/markets.

​
Response fields

FieldTypeDescription
marketcapdoubleCurrent market capitalization
firstMarketcapdoubleBaseline market cap used by the source dataset
marketcapDominancePercentdouble (optional)Share of total crypto market cap for the requested asset
circulatingSupplydouble (optional)Circulating token supply
totalSupplydouble (optional)Total token supply
maxSupplydouble (optional)Maximum token supply
totalValueLockeddouble (optional)Total value locked
fullyDilutedValuationdouble (optional)Fully diluted valuation
chainstringPrimary chain identifier
contractAddressstringContract address when applicable
cgMarketcapRankint64 (optional)Market cap rank
totalVolumedouble (optional)Trading volume from the source dataset
usdPricedouble (optional)Spot price in USD
timestampTimestampStart of the returned interval bucket
When querying coin=BTC&tokenName=Bitcoin, marketcapDominancePercent is Bitcoin dominance.

​
Capabilities

FeatureSupportedDetails
Market-independent seriesYesQuery by coin and tokenName
GapfillYesMissing buckets are forward-filled from the latest available token supply snapshot
Multi-exchange aggregationNoThis dataset is not keyed by exchange

​
Examples

​
Bitcoin dominance

Fetches 7 days of daily Bitcoin dominance and token supply data. 
curl "https://api.kiyotaka.ai/v1/points?type=TOKEN_SUPPLY_AGG&coin=BTC&tokenName=Bitcoin&interval=DAY&from=1775635290&period=604800" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"

​
Response

{
  "series": [
    {
      "id": {
        "type": "TOKEN_SUPPLY_AGG",
        "interval": "DAY",
        "coin": "BTC",
        "tokenName": "Bitcoin"
      },
      "points": [
        {
          "Point": {
            "timestamp": { "s": 1775692800 },
            "marketcap": 1436095444100,
            "firstMarketcap": 1415920373778,
            "marketcapDominancePercent": 57.1031,
            "cgMarketcapRank": 1
          }
        }
      ]
    }
  ]
}

​
Altcoin dominance

There is no separate type for altcoin dominance. Use the same Bitcoin dominance response and compute it client-side: 
altcoin_dominance = 100 - marketcapDominancePercent
With the sample response above: 
100 - 57.1031 = 42.8969