24h Volume—Open Interest—24h Liquidations$1.36B24h Long/Short—BTC Dominance—ETH Dominance—
App
Language ▾
$ USD ▾
/api/hl/tier/:slug
GETPartial

Hyperliquid tier detail

Hyperliquid tier detail (summary, coin positions, liquidation risk, recent opens)

GET/api/hl/tier/:slug
Partial coverage. `liqRisk` and `actions` can be empty arrays for tiers with very few wallets.

Request

Query parameters

NameTypeRequiredDefaultAllowed valuesDescription
slug pathstringRequired—stardust, meteor, asteroid, comet, planet, star, supernova, galaxyTier slug; 404 if unknown. Example: galaxy

Parameters marked “path” are part of the URL.

Example request

curl -s "https://www.coinboss.com/api/hl/tier/galaxy"

Response fields

The field table is generated from real responses, so it lists exactly what the endpoint returns. Paths use a[] for array items and {*} for objects keyed by a dynamic name such as a coin or an exchange.

FieldTypeUnitDescription
successboolean—true when the request succeeded. On failure the body is `{ success: false, code, error, request_id }`.
updatednumbermsWhen the data was last updated.
tierobject—Wallet size tier.
tier.bucketnumbermsStart of the time bucket.
tier.slugstring—Tier id.
tier.minnumber—Minimum.
tier.maxnull—Maximum.
networkobject—Profit / loss wallet counts of this tier over all addresses on Hyperliquid's leaderboard, per PnL window; null when no snapshot exists.
network.tsnumbermsTimestamp.
network.windowsobject—Per-window values. dynamic keys: allTime,day,month,week
network.windows.{*}object—Per-window values.
network.windows.{*}.walletsnumber—Number of wallets.
network.windows.{*}.profitnumber—Profit.
network.windows.{*}.lossnumber—Loss.
network.windows.{*}.flatnumber—Flat (unchanged) count or value.
network.windows.{*}.profitUsdnumberUSDSum of profits.
network.windows.{*}.lossUsdnumberUSDSum of losses.
poolobject—Figures limited to the tracked whale addresses whose account value falls in this tier, not the whole network.
pool.trackednumbercountTracked whale addresses whose account value falls in this tier.
pool.holdersnumbercountOf those, addresses with at least one open position.
pool.longUsdnumberUSDLong notional.
pool.shortUsdnumberUSDShort notional.
pool.upnlWinAddrsnumbercountAddresses with at least one position in unrealised profit; an address can also be counted in `upnlLoseAddrs`.
pool.upnlLoseAddrsnumbercountAddresses with at least one position in unrealised loss; an address can also be counted in `upnlWinAddrs`.
coinRankarray—Top 20 coins by total position value held by the tracked addresses of this tier.
coinRank[]object—One coin with its long, short and total position value in USD.
coinRank[].coinstring—Coin symbol, upper case (for example BTC).
coinRank[].longUsdnumberUSDLong notional.
coinRank[].shortUsdnumberUSDShort notional.
coinRank[].totalUsdnumberUSDTotal.
liqRiskarray—Up to 15 coins ranked by position value whose mark price is within 10 % of the liquidation price; empty when there are none. empty in the samples used to generate this table
actionsarray—Latest 40 position-opening fills (`open_long` / `open_short`) by tracked addresses of this tier, newest first. empty in the samples used to generate this table

Generated 2026-11-11 23:00 UTC from 1 real responses.

Example response

/api/hl/tier/galaxy · Real response captured 2026-11-13 03:58:38 UTC. Long arrays and maps are shortened for display: coinRank had 20 items; network.windows had 4 items.

  • {
    • "success": true,
    • "updated": 1794542318268,
    • "tier": {
      • "bucket": 7,
      • "slug": "galaxy",
      • "min": 100000000,
      • "max": null
      },
    • "network": {
      • "ts": 1794541537300,
      • "windows": { … 2 }
      },
    • "pool": {
      • "tracked": 1,
      • "holders": 1,
      • "longUsd": 844581.06,
      • "shortUsd": 273471757.4,
      • "upnlWinAddrs": 1,
      • "upnlLoseAddrs": 1
      },
    • "coinRank": [
      • { … 4 },
      • { … 4 }
      ],
    • "liqRisk": [],
    • "actions": []
    }

Details

Authentication
None. Public endpoint.
Rate limit
1200 requests per minute per IP
Server cache
60s
Edge micro-cache
10s
Update frequency
leaderboard buckets every 15 min; positions every 5 min; actions every 15 s; API cache 60 s
Window
latest snapshots; last 40 opening actions
Data sources
Profile of one account-size tier on Hyperliquid: wallet counts and PnL from the official leaderboard, plus holdings, liquidation-risk and recent opens of tracked whale addresses in that tier.
Exchange coverage
slug = stardust | meteor | asteroid | comet | planet | star | supernova | galaxy; network block = leaderboard wallets, pool blocks = tracked whale pool only
Pagination
none
Units
USD; counts
Method
liqRisk = notional of positions with |mark - liquidation price| / mark <= 10%
Timestamps
Unix epoch milliseconds (UTC) unless the field description says otherwise
Response format
json
Stability
Stable

Live status

PartialChecked 2026-11-13 03:58:38 UTCHTTP 200220 msSchema matchesNewest data point 0s old

`liqRisk` and `actions` can be empty arrays for tiers with very few wallets.

Availability, last 30 days

100% of 409 checks passed

Errors

Failed calls share one shape on every endpoint. The full list is on the errors page. Errors and rate limits →

CodeHTTPMeaningWhat to do
INVALID_PARAM400A required parameter is missing or a value is not accepted. `param` names the parameter when it is known.Do not retry unchanged; fix the request.
UNAUTHORIZED401The `CB-API-KEY` header was sent but the key is unknown or revoked. Public data needs no key — drop the header or use a valid key.Do not retry unchanged.
FORBIDDEN403The route is not part of the public API (internal or account-only).Do not retry.
NOT_FOUND404Unknown route, or the requested coin / exchange / fund does not exist.Do not retry; check the path and identifiers against the catalog.
RATE_LIMITED429More requests than the per-minute limit. `Retry-After` gives the seconds to wait.Wait for `Retry-After`, then retry with backoff.
INTERNAL500Unexpected server error. The message is generic by design; quote `request_id` when reporting it.Retry once after a few seconds; report it with the request id if it persists.
UPSTREAM_FAILED503The data source behind this endpoint did not answer in time. No stale or substitute numbers are returned in its place.Retry with backoff; check the status page.
UNAVAILABLE501 / 503The dataset is temporarily not ready (cache warming) or the endpoint has no lawful public source yet.Retry later; the catalog marks endpoints that are unavailable by design.
REQUEST_FAILED200Some older endpoints answer HTTP 200 with `success: false`. Always check `success`, not only the HTTP status.Depends on the message; treat as a failed request.

Try it

GET/api/hl/tier/:slugPartial
Parameters

string — Tier slug; 404 if unknown.

Request URLhttps://www.coinboss.com/api/hl/tier/galaxy
Choose an endpoint and press “Send request”. The response, headers and timing will appear here.