d.pro HyperLiquid Endpoints
d.pro HyperLiquid analytics endpoints — spot/perp holders, mid prices, liquidation heatmap, trending, leaderboard, and HIP-3/HIP-4 smart traders.
All endpoints below are GET requests under https://api.d.pro/api/public/v1. Send your key in the x-api-key header on every call. For shared conventions (response envelope, pagination, cursor paging, timestamps, rate limits, credits, errors) see Conventions. For authentication and tiers see Authentication.
Spot holders
GET /hl/spot/holders — top holders of a spot token, ranked by USD value.
| Param | Required | Default | Notes |
|---|---|---|---|
coin | yes | — | Spot token symbol, e.g. PURR |
order | no | desc | desc or asc (by value) |
page | no | 1 | |
limit | no | 100 | |
address | no | — | Filter to a single wallet (42-char 0x…) |
cursor | no | — | Opaque deep-paging token; overrides page |
Credits: 1
Example response for GET /hl/spot/holders?coin=PURR&limit=2:
{
"code": "0",
"msg": "success",
"data": {
"market": "spot",
"coin": "PURR",
"items": [
{
"address": "0x7ea90af38397575a372e36bdc0f5970fb512fc7f",
"coin": "PURR",
"balance": "35000000.40483",
"value": "3174290.03671565",
"entryPrice": "0.12912926",
"entryNtl": "4519524.26827357",
"uPnl": "-1345234.23155792",
"roe": "-29.76495205",
"addressTags": ["Whale"],
"supplyPercentage": "6.88948274"
}
],
"page": 1,
"limit": 2,
"total": 17161,
"hasMore": true,
"nextCursor": "eyJjb2luIjoiUFVSUiIsInJhbmsiOjJ9",
"updatedAt": "2026-06-25T13:06:22.103Z"
}
}Perp holders
GET /hl/perp/holders — top holders of a perp, with position and liquidation detail.
| Param | Required | Default | Notes |
|---|---|---|---|
coin | yes | — | Perp symbol (BTC) or HIP-3 coin (xyz:TSLA) |
sortBy | no | value | value or pnl |
order | no | desc | desc or asc |
page | no | 1 | |
limit | no | 100 | |
address | no | — | Filter to a single wallet |
cursor | no | — | Opaque deep-paging token; overrides page |
Credits: 1
Example response for GET /hl/perp/holders?coin=BTC&sortBy=value&limit=1:
{
"code": "0",
"msg": "success",
"data": {
"market": "perp",
"coin": "BTC",
"items": [
{
"address": "0x92ea19eceb7a8de0f50978a1583a5d8b018050e9",
"side": "long",
"coin": "BTC",
"size": "1268.33487",
"value": "77727365.83821",
"entryPrice": "76117.35411243",
"leverage": "5",
"uPnl": "-18814928.59472",
"roe": "-1.21031559",
"marginUsed": "15545473.167642",
"liquidationPrice": "16962.7",
"markPrice": "61283",
"cumFunding": "449205.071402",
"addressTags": ["Whale"],
"supplyPercentage": "3.85791704"
}
],
"page": 1,
"limit": 1,
"total": 9420,
"hasMore": true,
"nextCursor": "eyJjb2luIjoiQlRDIiwicmFuayI6MX0",
"updatedAt": "2026-06-25T13:06:22.103Z"
}
}Mid prices
GET /hl/prices/mids — all current mid prices, as a coin → price map. No parameters.
Credits: 1
Example response for GET /hl/prices/mids:
{
"code": "0",
"msg": "success",
"data": {
"mids": {
"BTC": "61284.5",
"ETH": "2410.3",
"PURR": "0.090711",
"xyz:TSLA": "421.55"
}
}
}Perp liquidation heatmap
GET /hl/perp/liquidation-map — liquidation value bucketed by price level, for a perp.
| Param | Required | Default | Notes |
|---|---|---|---|
coin | yes | — | Perp symbol (BTC) or HIP-3 coin (xyz:TSLA) |
Credits: 2
Example response for GET /hl/perp/liquidation-map?coin=BTC:
{
"code": "0",
"msg": "success",
"data": {
"coin": "BTC",
"heatmap": [
{
"coin": "BTC",
"priceBinIndex": 0,
"priceBinStart": 6119.65,
"priceBinEnd": 7006.99925,
"liquidationValue": 9324888.98,
"positionsCount": 714,
"mostImpactedSegment": 1
}
]
}
}Trending
GET /hl/trending — trending assets by buy/sell activity over a period.
| Param | Required | Default | Notes |
|---|---|---|---|
period | no | 1h | 15m, 1h, 4h, 24h |
market | no | all | all, spot, perp |
page | no | 1 | applies to both spot and perp lists |
limit | no | 50 | max 200 |
Credits: 1
Example response for GET /hl/trending?period=1h&market=spot&limit=1:
{
"code": "0",
"msg": "success",
"data": {
"period": "1h",
"snapshot_height": 1048990000,
"snapshot_time": "2026-06-25T12:46:56.039Z",
"spot": {
"items": [
{
"coin": "XMR1",
"price": "0",
"priceChange": "+0.00%",
"buyAddresses": 106,
"sellAddresses": 5,
"smartBuy": 1,
"smartSell": 0,
"buyOrderAmountChange": "2407.6082277",
"sellOrderAmountChange": "208.90141099"
}
],
"pagination": { "page": 1, "limit": 1, "total": 633, "hasMore": true }
}
}
}With market=all, both spot and perp keys are present; with market=spot or market=perp, only that one.
Note: /hl/trending is the single composite exception — its response is not a flat items envelope.
Leaderboard
GET /hl/leaderboard — top traders with per-window performance (day / week / month / all-time).
| Param | Required | Default | Notes |
|---|---|---|---|
page | no | 1 | |
limit | no | 100 | max 500 |
sort | no | pnl_day | pnl_day · pnl_week · pnl_month · pnl_allTime · roi_day · roi_week · roi_month · roi_allTime · vlm_day · vlm_week · vlm_month · vlm_allTime · accountValue |
order | no | desc | desc or asc |
cursor | no | — | Opaque deep-paging token; overrides page |
Credits: 1
Example response for GET /hl/leaderboard?sort=pnl_day&limit=1:
{
"code": "0",
"msg": "success",
"data": {
"items": [
{
"ethAddress": "0xe6111266afdcdf0b1fe8505028cc1f7419d798a7",
"accountValue": "928407092.4829989672",
"windowPerformances": [
["day", { "pnl": "67755542.5655680001", "roi": "0.0786860822", "vlm": "0.0" }],
["week", { "pnl": "0.0", "roi": "0.0", "vlm": "0.0" }],
["month", { "pnl": "84436632.4648499936", "roi": "0.0998265723", "vlm": "0.0" }],
["allTime", { "pnl": "-500.0", "roi": "-0.05", "vlm": "0.0" }]
]
}
],
"page": 1,
"limit": 1,
"total": 500,
"hasMore": true,
"nextCursor": "eyJzb3J0IjoicG5sX2RheSIsInJhbmsiOjF9",
"updatedAt": "2026-06-25T12:53:20.000Z"
}
}HIP-3 smart traders
GET /hl/hip3/smart-trader — historical traders of a HIP-3 (stock perp) asset, ranked by PnL.
| Param | Required | Default | Notes |
|---|---|---|---|
coin | yes | — | HIP-3 coin, e.g. xyz:TSLA |
sort | no | pnlPct | sort field (e.g. pnl, pnlPct, tradeCount) |
order | no | desc | desc or asc |
page | no | 1 | |
limit | no | 50 | |
address | no | — | Filter to a single wallet (42-char 0x…) |
Credits: 2
Example response for GET /hl/hip3/smart-trader?coin=xyz:TSLA&limit=1:
{
"code": "0",
"msg": "success",
"data": {
"coin": "xyz:TSLA",
"markPx": "421.55",
"items": [
{
"userAddress": "0x3b1da043309de11c58dac634895f635d3cbdb239",
"totalBuyUsd": "2546.29066",
"totalSellUsd": "3509.6004",
"totalFeeUsd": "6.579111",
"realizedPnl": "963.303408",
"unrealizedPnl": "0.006332",
"pnl": "963.30974",
"pnlPct": "27.447846769107958843",
"netPositionSz": "0",
"currentPositionNotional": "0",
"tradeCount": 8,
"lastTradeAt": "2026-04-07T14:28:50.161Z"
}
],
"page": 1,
"limit": 1,
"total": 240,
"hasMore": true,
"updatedAt": "2026-06-25T12:53:20.000Z"
}
}HIP-4 smart traders
GET /hl/hip4/smart-trader — historical traders of a HIP-4 prediction outcome (YES/NO sides merged per trader), ranked by PnL.
| Param | Required | Default | Notes |
|---|---|---|---|
outcomeId | yes | — | Prediction outcome id, an integer string, e.g. 9 |
sort | no | pnlPct | sort field (e.g. pnl, pnlPct, tradeCount) |
order | no | desc | desc or asc |
page | no | 1 | |
limit | no | 50 | |
address | no | — | Filter to a single wallet (42-char 0x…) |
Credits: 2
Example response for GET /hl/hip4/smart-trader?outcomeId=9&limit=1:
{
"code": "0",
"msg": "success",
"data": {
"outcomeId": "9",
"outcomeName": "Will X happen?",
"markPx": "0.62",
"sides": ["YES", "NO"],
"items": [
{
"userAddress": "0x3b1da043309de11c58dac634895f635d3cbdb239",
"totalBuyUsd": "2546.29066",
"totalSellUsd": "3509.6004",
"realizedPnl": "963.303408",
"unrealizedPnl": "0.006332",
"pnl": "963.30974",
"pnlPct": "27.4478467691",
"tradeCount": 8,
"lastTradeAt": "2026-04-07T14:28:50.161Z"
}
],
"page": 1,
"limit": 1,
"total": 0,
"hasMore": false,
"updatedAt": "2026-06-25T12:53:20.000Z"
}
}Conventions
Shared conventions for all Public Data API endpoints — response envelope, symbol formats, pagination, timestamps, rate limits, credits, data freshness, recipes, and errors.
Markets
Cross-asset market data — assets, quotes, klines, and tickers across crypto, stocks, ETFs, forex, and commodities.