Skip to main content
GET
/
openapi
/
v1
/
crypto
/
dominance
Crypto market dominance
curl --request GET \
  --url https://api.hayinsights.com/openapi/v1/crypto/dominance \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "statusCode": 200,
  "data": {
    "totalMarketCap": 2156391783530.09,
    "coins": [
      {
        "symbol": "BTC",
        "name": "Bitcoin",
        "dominancePercentage": 58.18,
        "marketCap": 1254560380643.96
      },
      {
        "symbol": "ETH",
        "name": "Ethereum",
        "dominancePercentage": 9.47,
        "marketCap": 204246767811.64
      },
      {
        "symbol": "USDT",
        "name": "Tether USDt",
        "dominancePercentage": 8.64,
        "marketCap": 186279683262.83
      }
    ],
    "asOf": {
      "globalMetrics": "2026-06-19T08:45:00.000Z",
      "assets": "2026-06-19T08:45:00.040Z",
      "skewSeconds": 0,
      "isStale": false
    }
  },
  "meta": {
    "timestamp": "2026-06-19T08:50:01.048Z"
  }
}

Authorizations

X-API-Key
string
header
required

Your HayInsights API key (prefixed apk_). Create and manage keys in the HayInsights dashboard (Account → API keys).

Send it in the X-API-Key header on every request to /openapi/v1/*. Which data domains you may access and your request quota are both governed by the subscription plan attached to the key — see the Plans & features and Rate limits guides.

Response

Market-cap dominance breakdown.

Standard success envelope shared by every endpoint. Each operation's response wrapper extends this (via allOf) and adds a typed data property.

success
boolean
required

Always true for a successful response.

Example:

true

statusCode
integer
required

Mirrors the HTTP status code.

Example:

200

data
object
required

Market-cap dominance breakdown — total market cap and each major coin's share, with the freshness of the underlying source data.

meta
object

Response metadata. Always present; timestamp is the server time the response was generated.