# Token market cap vs BTC

- Method: `GET`
- Path: `/token/{id}/btc-dominance`
- Tier: Pro
- HTML docs: https://docs.hiddensystems.ai/nebula/reference/get-token-id-btc-dominance/
- Interactive docs: https://docs.hiddensystems.ai/nebula/#endpoint=get-token-id-btc-dominance

## Description

Token market cap as a percentage of Bitcoin market cap over time.

## cURL Example

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

## Path Parameters

- `id` (string, required): Token identifier. Accepts internal token_id (integer) or coingecko_id (string, e.g. bitcoin).

## Query Parameters

- `hours` (integer, optional): Lookback window in hours.
- `granularity` (string, optional): Optional bucket size override. If provided, response is aggregated at this interval regardless of lookback window.

## Response

OK

- `change` (object): Current period-over-period change metrics.
- `change.pct` (number (double)): No description provided.
- `current` (object): Latest token market cap vs Bitcoin market cap snapshot.
- `current.btc_market_cap` (number (double)): Bitcoin market capitalization in USD for this bucket.
- `current.market_cap_vs_btc_pct` (number (double)): Token market cap as a percentage of Bitcoin market cap.
- `current.token_market_cap` (number (double)): Token market capitalization in USD for this bucket.
- `data` (array<object>): Token market cap vs Bitcoin market cap time series.
- `data[].btc_market_cap` (number (double)): Bitcoin market capitalization in USD for this bucket.
- `data[].market_cap_vs_btc_pct` (number (double)): Token market cap as a percentage of Bitcoin market cap.
- `data[].time` (string (date-time)): UTC timestamp for the data point.
- `data[].token_market_cap` (number (double)): Token market capitalization in USD for this bucket.

Media type: `application/json`

## JSON Response

```json
{
  "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
    }
  ]
}
```