Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token BTC dominance

GET /token/{id}/btc-dominance
GetTokenIdBtcDominance

Market cap vs BTC dominance time-series for the token.

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

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 BTC dominance snapshot for the token.
current.btc_dominance_pct
number (double) optional

BTC share of combined BTC + token market cap (percentage).

current.btc_market_cap
number (double) optional

Bitcoin market capitalization in USD for this bucket.

current.token_market_cap
number (double) optional

Token market capitalization in USD for this bucket.

data
array<object> optional

Token market cap and BTC dominance time series.
data[].btc_dominance_pct
number (double) optional

BTC share of combined BTC + token market cap (percentage).

data[].btc_market_cap
number (double) optional

Bitcoin market capitalization in USD for this bucket.

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.