Get bitcoin dominance history

professional This endpoint requires the professional plan or higher

Get a list of bitcoin dominance history along with the bitcoin market capitalization data.

On Coinranking, we use this endpoint on our bitcoin dominance chart.

https://api.coinranking.com/v2/stats/bitcoin-dominance-history

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

UUID of coin (either fiat or crypto), in which all the market caps are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint

Default value: yhjMzLPhuIDl

Example:
...stats/bitcoin-dominance-history?referenceCurrencyUuid=5k-_VTxqtCEI
timePeriod (optional) String

Timeperiod where the percentage and marketCap are based on

Default value: 24h
Allowed values:
1h 3h 12h 24h 7d 30d 3m 1y 3y 5y

Example:
...stats/bitcoin-dominance-history?timePeriod=1y

Code examples

Response

json
HTTP/1.1 200 OK { "status": "success", "data": [ { "timestamp": 1742814600, "percentage": 58.91, "marketCap": 1740828021051 }, { "timestamp": 1742814900, "percentage": 58.9, "marketCap": 1740456972714 }, { "timestamp": 1742815200, "percentage": 58.89, "marketCap": 1739283421198 } ] }

Response fields

Property Description
status String

Status of the request

Allowed values:
success
data Object
data.timestamp Number

An Epoch timestamp in seconds

data.percentage Number/null

Percentage of bitcoin dominance by market cap

data.marketCap Number/null

Bitcoin market cap, calculated in the reference currency

Error response

json
HTTP/1.1 422 Unprocessable Entity { "status": "fail", "type": "REFERENCE_UNAVAILABLE", "message": "Reference currency not available" }

Error responses