Skip to main content
GET
/
insights
/
btc-dominance
Get Bitcoin market dominance data showing BTC's percentage share of the total cryptocurrency market capitalization over a specified time period
curl --request GET \
  --url https://openapiv1.coinstats.app/insights/btc-dominance \
  --header 'X-API-KEY: <api-key>'
{
  "data": [
    [
      1746441300,
      61.59
    ],
    [
      1746441400,
      62.1
    ],
    [
      1746441500,
      61.85
    ]
  ]
}
10 credits per request
  • Supports multiple time frames: 24 hours, 1 week, 1 month, 3 months, 6 months, 1 year, or all available data.
  • Data is returned as pairs of [timestamp, percentage] values.
  • Useful for analyzing market trends and Bitcoin’s relative strength in the overall crypto ecosystem.
  • type: Time range. One of 24h, 1w, 1m, 3m, 6m, 1y, all.

Authorizations

​
X-API-KEY
string
header
required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

Query Parameters

​
type
enum<string>
required

Time period for the data

Available options:
24h,
1w,
1m,
3m,
6m,
1y,
all

Response

​
data
number[][]
required

Array of timestamp and BTC dominance percentage pairs Pair structure: [timestamp, BTC dominance percentage]

Example:
[
  [1746441300, 61.59],
  [1746441400, 62.1],
  [1746441500, 61.85]
]