💲$HYPE Token Data

The HYPE Token Data endpoints provide access to information about token holders and ownership distribution for the HYPE ecosystem token. These endpoints can be used to query all known holders, as well as the specific wallets linked to the authenticated user.

Get All HYPE Token Holders

/api/external/hype/holders

Returns a complete list of all HYPE token holders. For each holder you can see their wallet address, whether they have claimed their tokens, how many tokens they own, and what percentage of the total supply that amount represents.

The endpoint can return up to 500 results per request. Lower limits usually result in faster response times.

Also found on the Leaderboards subpage here.

Query Parameters

Parameter	Type	Description
offset	number	Number of results to skip before starting the list.
limit	number	Maximum number of holder records to return.
order	string	Sort direction. Allowed values: asc, desc.
orderBy	string	Field to order by. Allowed values: balance, percentage, address, updatedAt.

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/hype/holders?limit=50&orderBy=balance&order=desc' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

JavaScript

Python

Response

200 Success: Returns all HYPE token holder data.

Response Example

{
  "totalCount": 1,
  "items": [
    {
      "spotAmount": 0,
      "spotAmountUsd": 0,
      "stakedAmount": 0,
      "stakedAmountUsd": 0,
      "totalAmount": 0,
      "totalAmountUsd": 0,
      "wallet": {
        "mid": 100,
        "cmmId": 100,
        "segments": [
          1,
          2,
          3
        ],
        "address": "0x123abc...",
        "totalEquity": 10000.5,
        "perpEquity": 8000.25,
        "perpBias": 0.6,
        "exposureRatio": 0.6,
        "openValue": 5000,
        "sumUpnl": 120.5,
        "perpPnl": 300.75,
        "earliestActivityAt": "2024-01-01T12:00:00Z",
        "closestLiq": {
          "coin": "BTC",
          "progress": 0.78
        },
        "emoji": "string",
        "displayName": "string",
        "verified": true,
        "xUser": {
          "xUserId": "1234567890",
          "screenName": "elonmusk",
          "name": "Elon Musk",
          "verified": true,
          "profileImageUrl": "https://pbs.twimg.com/profile_images/1234567890/abc_normal.jpg",
          "followersCount": 150000000,
          "followingCount": 100
        },
        "vault": {
          "leader": "0x1234567890abcdef1234567890abcdef12345678",
          "name": "My Awesome Vault",
          "description": "This vault is focused on long-term investments in crypto assets."
        },
        "favorite": {
          "favorite": false,
          "displayName": "Cobie",
          "emoji": "🎸",
          "featured": true
        }
      },
      "address": "string",
      "earliestActivityAt": "2019-08-24T14:15:22Z",
      "rank": 0,
      "accountValue": 0,
      "percentOfCirculatingSupply": 0,
      "history": {
        "24h": {
          "spotAmount": 0,
          "spotAmountUsd": 0,
          "stakedAmount": 0,
          "stakedAmountUsd": 0,
          "totalAmount": 0,
          "totalAmountUsd": 0,
          "address": "string",
          "createdAt": "2019-08-24T14:15:22Z"
        },
        "7d": {
          "spotAmount": 0,
          "spotAmountUsd": 0,
          "stakedAmount": 0,
          "stakedAmountUsd": 0,
          "totalAmount": 0,
          "totalAmountUsd": 0,
          "address": "string",
          "createdAt": "2019-08-24T14:15:22Z"
        }
      }
    }
  ]
}