Token market cap vs BTC

Parameters

id string PATH required

Token identifier. Accepts internal token_id (integer) or coingecko_id (string, e.g. bitcoin).

Example:bitcoin

hours integer QUERY

Lookback window in hours.

Example:168

granularity string QUERY

Optional bucket size override. If provided, response is aggregated at this interval regardless of lookback window.

Allowed values

1h2h4h12h1d

Example:1h

cURL Example

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/token/bitcoin/btc-dominance' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK

400 Bad Request ErrorResponse

Media type application/json

change

object optional

Current period-over-period change metrics.

change.pct

number (double) optional

No description provided.

current

object optional

Latest token market cap vs Bitcoin market cap snapshot.

current.btc_market_cap

number (double) optional

Bitcoin market capitalization in USD for this bucket.

current.market_cap_vs_btc_pct

number (double) optional

Token market cap as a percentage of Bitcoin market cap.

current.token_market_cap

number (double) optional

Token market capitalization in USD for this bucket.

data

array<object> optional

Token market cap vs Bitcoin market cap time series.

data[].btc_market_cap

number (double) optional

Bitcoin market capitalization in USD for this bucket.

data[].market_cap_vs_btc_pct

number (double) optional

Token market cap as a percentage of Bitcoin market cap.

data[].time

string (date-time) optional

UTC timestamp for the data point.

data[].token_market_cap

number (double) optional

Token market capitalization in USD for this bucket.

{
  "change": {
    "pct": 0
  },
  "current": {
    "btc_market_cap": 0,
    "market_cap_vs_btc_pct": 0,
    "token_market_cap": 0
  },
  "data": [
    {
      "btc_market_cap": 0,
      "market_cap_vs_btc_pct": 0,
      "time": "2026-01-15T12:00:00Z",
      "token_market_cap": 0
    }
  ]
}