| Number | Segment (Cohort) | Definition |
|---|---|---|
| 1 | π Fish | $250 - $10k Perp Equity |
| 2 | π¬ Dolphin | $10k - $50k Perp Equity |
| 3 | π¦ Apex Predator | $50k - $100k Perp Equity |
| 4 | π Small Whale | $100k - $500k Perp Equity |
| 5 | π³ Whale | $500k - $1m Perp Equity |
| 6 | π Tidal Whale | $1m - $5m Perp Equity |
| 7 | π Leviathan | $5m Perp Equity |
| 8 | π° Money Printer | $1m All-Time Perp PnL |
| 9 | π Smart Money | $100k to $1m All-Time Perp PnL |
| 10 | π Grinder | $10k to $100k All-Time Perp PnL |
| 11 | π Humble Earner | $0k to $10k All-Time Perp PnL |
| 12 | π€‘ Exit Liquidity | $0k to -$10k All-Time Perp PnL |
| 13 | π₯ Semi-Rekt | -$10k to -$100k All-Time Perp PnL |
| 14 | π¨ Full Rekt | -$100k to -$1m All-Time Perp PnL |
| 15 | π Giga Rekt | -$1m+ All-Time Perp PnL |
| 16 | π¦ Shrimp | $0 - $250 Perp Equity |
| Parameter | Type | Description |
|---|---|---|
segmentId | number | The cohort (segment) ID. Use the Get Cohort Definitions endpoint to retrieve available IDs. |
| Parameter | Type | Description |
|---|---|---|
positionAge | string | Filters the cohort to wallets that have opened at least one position within the selected timeframe. Default: allValues: all, 24h, 7d, 30d |
| Parameter | Type | Description |
|---|---|---|
coin | number | Coin ticker (for example BTC, ETH). |
segment | number | Segment (cohort) key (path). Allowed values: 1 through 16. See Legend. |
| Parameter | Type | Description |
|---|---|---|
start | string (ISO8601) | Start of the time window (applies to snapshot timestamps) |
end | string (ISO8601) | End of the time window (applies to snapshot timestamps) |
limit | number | Maximum number of snapshot rows to return |
nextCursor | string | Cursor for pagination. Pass the value from the previous response |
positionRecencyTimeframe | string | Rolling position window applied to each snapshot. Allowed values: all (default), 24h, 7d, 30d |
| File | Position window | Description |
|---|---|---|
segment-metrics | All positions | Bias trend snapshot using all open positions at each point in time. |
segment-metrics-24h | 24h | Bias trend snapshot using positions opened within the rolling 24h window at each timestamp. |
segment-metrics-7d | 7d | Bias trend snapshot using positions opened within the rolling 7d window at each timestamp. |
segment-metrics-30d | 30d | Bias trend snapshot using positions opened within the rolling 30d window at each timestamp. |
| Parameter | Type | Description |
|---|---|---|
coin | string | Coin symbol, case-insensitive. For example BTC, ETH. |
file | string | Export file to return. Supported values: segment-metrics, segment-metrics-24h, segment-metrics-7d, segment-metrics-30d. |
| Parameter | Type | Description |
|---|---|---|
segmentId | number | The cohort (segment) ID. Use the Get Cohort Definitions endpoint to retrieve available IDs. |
| Parameter | Type | Description |
|---|---|---|
limit | number | Maximum number of positions to return per request. |
nextCursor | string | Cursor for pagination. Use the nextCursor value from the previous response to fetch the next page. |
start | string | Start of the time window (ISO 8601, UTC). |
end | string | End of the time window (ISO 8601, UTC). If omitted, the API uses βnowβ. |
positionRecencyTimeframe | string | Filters qualifying wallets by position recency. Same logic as the Position Age Filter. Default: all. Available values: 24h, 7d, 30d, all. |
| Parameter | Type | Description |
|---|---|---|
limit | number | Maximum number of positions to return per request. |
coin | string | Coin symbol to filter by (for example ETH, BTC, LINEA). If omitted, positions for all coins are returned. |
nextCursor | string | Cursor for pagination. Use the nextCursor value from the previous response to fetch the next page. |
address | string | One or more wallet addresses to include. |
start | string | Start of the time window (ISO 8601, UTC). |
end | string | End of the time window (ISO 8601, UTC). If omitted, the API uses βnowβ. |
open | boolean | Filter by position status. true returns only open positions, false returns only closed positions. If omitted, both are returned. |
segmentId | number | The cohort (segment) ID. Use the Get Cohort Definitions endpoint to retrieve available IDs. |
This endpoint powers the HyperTracker homepage
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl -X GET \ 'https://ht-api.coinmarketman.com/api/external/state/summary' \ -H 'accept: application/json' \ -H 'Authorization: Bearer YOUR_API_KEY' ``` {% endtab %} {% tab title="Python" %} ``` import requests url = "https://ht-api.coinmarketman.com/api/external/state/summary" headers = { "accept": "application/json", "Authorization": "Bearer YOUR_API_KEY" } response = requests.get(url, headers=headers) response.raise_for_status() data = response.json() print(data) ``` {% endtab %} {% endtabs %} Response > **200 Success:** Returns a live homepage state object containing global wallet counts, active trader counts, cohort metrics, position-age filtered cohort snapshots, open interest, position counts, perp volume, and 24h comparison values.