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
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: yhjMzLPhuIDlExample:
...stats/bitcoin-dominance-history?referenceCurrencyUuid=5k-_VTxqtCEI
|
timePeriod (optional) String |
Timeperiod where the percentage and marketCap are based on Default value: 24hAllowed values: 1h 3h 12h 24h 7d 30d 3m 1y 3y 5y Example:
...stats/bitcoin-dominance-history?timePeriod=1y
|
jsonHTTP/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
}
]
}
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 |
jsonHTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}